SpectralCoord

class astropy.coordinates.SpectralCoord(value, unit=None, observer=None, target=None, radial_velocity=None, redshift=None, **kwargs)

基类：SpectralQuantity

与其对应单位的光谱坐标。

备注

这个 SpectralCoord 类是AstropyV4.1中的新类，现在应该被认为是实验性的。请注意，我们不完全支持观察者和目标相对运动的情况，因此在这些情况下应该小心。基于用户反馈，Astropy的未来版本可能会有API的变化。如果您对如何改进它有具体的想法，请在 `astropy-dev mailing list`_ 或者在http://feedback.astropy.org。

参数:

value : ndarray 或 Quantity 或 SpectralCoordNdarray或Quantity或SpectralCoord

光谱值，应该是波长、频率、能量、波数或速度值。

unit : astropy:unit-like占星体：单位状

给定光谱值的单位。

观察者 ： BaseCoordinateFrame 或 SkyCoord 可选BaseCoordinateFrame或SkyCoord，可选

观察者的坐标（位置和速度）。如果这个物体上没有速度，则假设观测者相对于帧原点是静止的。

目标 ： BaseCoordinateFrame 或 SkyCoord 可选BaseCoordinateFrame或SkyCoord，可选

目标的坐标（位置和速度）。如果此对象上没有速度，则假定目标相对于帧原点是静止的。

radial_velocity : Quantity [:ref: 'speed' ]，可选数量 [:ref: 'speed'] ，可选

目标相对于观察者的径向速度。只能在以下情况下指定 redshift 未指定。

redshift : float ，可选Python：Float，可选

目标相对于观察者的相对论红移。只能在以下情况下指定 radial_velocity 无法指定。

doppler_rest ： Quantity 可选数量，可选

将谱值表示为速度时要使用的静止值。

doppler_convention : str ，可选Python：字符串，可选

将频谱值表示为速度时使用的多普勒约定。

属性摘要

observer	观察者的坐标。
quantity	转换 SpectralCoord 到A Quantity .
radial_velocity	目标相对于观察者的径向速度。
redshift	目标相对于观察者的红移。
target	被观测目标的坐标。

方法总结

replicate([value, unit, observer, target, ...])	返回 SpectralCoord ，可以选择更改值或属性。
to_rest \()	将光谱轴变换到静止帧。
with_observer_stationary_relative_to \(框架)	一个新的 SpectralCoord 观察者的速度改变了，但位置没有改变。
with_radial_velocity_shift([target_shift, ...])	对光谱坐标应用速度偏移。

属性文档

observer

观察者的坐标。

如果已设置，并且目标也已设置，则这将覆盖传入的任何显式径向速度。

返回:

BaseCoordinateFrame

表示观测结果的天文坐标系。

quantity

转换 SpectralCoord 到A Quantity . 相当于 self.view(u.Quantity) .

返回:

Quantity

此对象被视为 Quantity .

radial_velocity

目标相对于观察者的径向速度。

返回:

Quantity [:ref: 'speed']

目标径向速度。

笔记

这和 .radial_velocity 坐标系的性质，它计算相对于 观察者 ，而不是帧的原点。

redshift

目标相对于观察者的红移。根据径向速度计算。

返回:

astropy.units.Quantity

目标红移。

target

被观测目标的坐标。

如果设置了，并且设置了观察者，这将覆盖传入的任何显式径向速度。

返回:

BaseCoordinateFrame

代表目标的天文坐标系。

方法文件

replicate(value=None, unit=None, observer=None, target=None, radial_velocity=None, redshift=None, doppler_convention=None, doppler_rest=None, copy=False)

返回 SpectralCoord ，可以选择更改值或属性。

请注意，此方法不执行任何转换-这将保持所有值和属性不变，但显式传递给此方法的值和属性会发生更改。

如果 copy 设置为 True 然后将生成内部阵列的完整副本。默认情况下，为了节省内存，复制副本将使用对原始阵列的引用。

参数:

value : ndarray 或 Quantity 或 SpectralCoord ，可选Ndarray或Quantity或SpectralCoord，可选

光谱值，应该是波长、频率、能量、波数或速度值。

unit : astropy:unit-like占星体：单位状

给定光谱值的单位。

观察者 ： BaseCoordinateFrame 或 SkyCoord 可选BaseCoordinateFrame或SkyCoord，可选

观察者的坐标（位置和速度）。

目标 ： BaseCoordinateFrame 或 SkyCoord 可选BaseCoordinateFrame或SkyCoord，可选

目标的坐标（位置和速度）。

radial_velocity : Quantity [:ref: 'speed' ]，可选数量 [:ref: 'speed'] ，可选

目标相对于观察者的径向速度。

redshift : float ，可选Python：Float，可选

目标相对于观察者的相对论红移。

doppler_rest ： Quantity 可选数量，可选

将谱值表示为速度时要使用的静止值。

doppler_convention : str ，可选Python：字符串，可选

将频谱值表示为速度时使用的多普勒约定。

copy : bool ，可选可选的布尔

如果 True 和 value 如果未指定，则将值复制到新的 SkyCoord -否则，将使用对相同值的引用。

返回:

sc : SpectralCoord objectSpectraColord对象

此对象的副本

to_rest()

将光谱轴变换到静止帧。

with_observer_stationary_relative_to(frame, velocity=None, preserve_observer_frame=False)

一个新的 SpectralCoord 观察者的速度改变了，但位置没有改变。

如果指定了一个坐标系，观测者的速度将被修改为在指定的坐标系中是静止的。如果指定了一个坐标实例，可以选择使用非零速度，则将更新观察者速度，以便观察者与指定坐标共同移动。

参数:

frame : str ， BaseCoordinateFrame 或 SkyCoordPYTHON：字符串、基本坐标框架或天空坐标

观察者静止的观察框架。它可以是帧的名称（例如“icrs”）、帧类、没有数据的帧实例或有数据的实例。这可以选择性地包括速度。

速度 ： Quantity 或 CartesianDifferential 可选数量或卡特尔无差别，可选

如果 frame 不包含速度，可以指定为3个元素 Quantity . 在未指定的情况下，速度默认为零。

preserve_observer_frame : bool布尔

如果 True ，最终的观测者帧类将与原始帧类相同，并且如果 False 它将是速度参考类的框架。

返回:

new_coord ： SpectralCoordSpectralCoord

新的坐标对象表示基于观测器新速度框架变换后的光谱数据。

with_radial_velocity_shift(target_shift=None, observer_shift=None)

对光谱坐标应用速度偏移。

偏移可以作为红移（浮点值）或径向速度提供 (Quantity 物理类型为“速度”）。

参数:

target_shiftPython：浮点或数量 [:ref: 'speed']

要应用于当前目标的移位值。

observer_shiftPython：浮点或数量 [:ref: 'speed']

要应用于当前观察者的偏移值。

返回:

SpectralCoord

新的光谱坐标随着目标/观察者速度的变化而改变，以加入位移。这总是一个新对象，即使 target_shift 和 observer_shift 都是 None .