# SkyCoord¶

class astropy.coordinates.SkyCoord(*args, copy=True, **kwargs)[源代码]

```SkyCoord(COORD, [FRAME], keyword_args ...)
SkyCoord(LON, LAT, [FRAME], keyword_args ...)
SkyCoord(LON, LAT, [DISTANCE], frame=FRAME, unit=UNIT, keyword_args ...)
SkyCoord([FRAME], <lon_attr>=LON, <lat_attr>=LAT, keyword_args ...)
```

unit : `Unit`, string, or tuple of `Unit` 或str，可选Unit、string或Unit或str的元组，可选

obstime时间有限，可选

equinox时间有限，可选

representation_typestr或表示类

copy可选的布尔

**keyword_args

Ra，12月角度状，可选

pm_ra_cosdec, pm_dec数量 [“角速度”] ，可选

l，b角度状，可选

pm_l_cosb, pm_b数量 [“角速度”] ，可选

`Galactic` 帧，以角度/时间单位表示。

x, y, z浮动或

u, v, w浮动或

```>>> from astropy.coordinates import SkyCoord  # High-level coordinates
>>> from astropy.coordinates import ICRS, Galactic, FK4, FK5  # Low-level frames
>>> from astropy.coordinates import Angle, Latitude, Longitude  # Angles
>>> import astropy.units as u
```

```>>> c = SkyCoord(10, 20, unit="deg")  # defaults to ICRS frame
>>> c = SkyCoord([1, 2, 3], [-30, 45, 8], frame="icrs", unit="deg")  # 3 coords

>>> coords = ["1:12:43.2 +31:12:43", "1 12 43.2 +31 12 43"]
>>> c = SkyCoord(coords, frame=FK4, unit=(u.hourangle, u.deg), obstime="J1992.21")

>>> c = SkyCoord("1h12m43.2s +1d12m43s", frame=Galactic)  # Units from string
>>> c = SkyCoord(frame="galactic", l="1h12m43.2s", b="+1d12m43s")

>>> ra = Longitude([1, 2, 3], unit=u.deg)  # Could also use Angle
>>> dec = np.array([4.5, 5.2, 6.3]) * u.deg  # Astropy Quantity
>>> c = SkyCoord(ra, dec, frame='icrs')
>>> c = SkyCoord(frame=ICRS, ra=ra, dec=dec, obstime='2001-01-02T12:34:56')

>>> c = FK4(1 * u.deg, 2 * u.deg)  # Uses defaults for obstime, equinox
>>> c = SkyCoord(c, obstime='J2010.11', equinox='B1965')  # Override defaults

>>> c = SkyCoord(w=0, u=1, v=2, unit='kpc', frame='galactic',
...              representation_type='cartesian')

>>> c = SkyCoord([ICRS(ra=1*u.deg, dec=2*u.deg), ICRS(ra=3*u.deg, dec=4*u.deg)])
```

```>>> c = SkyCoord(ra=1*u.deg, dec=2*u.deg, radial_velocity=10*u.km/u.s)

>>> c = SkyCoord(ra=1*u.deg, dec=2*u.deg, pm_ra_cosdec=2*u.mas/u.yr, pm_dec=1*u.mas/u.yr)
```

 用于存储诸如名称、描述、格式等元信息的容器。 基础数据的形状。

 `apply_space_motion` \ [new_obstime, dt] ） 利用储存在这个物体中的速度，并假设线性空间运动（包括相对论修正），计算这个坐标物体所代表的源到一个新时间的位置。 `contained_by` \（wcs[, image] ） 确定给定的wcs示意图中是否包含SkyCoord。 `directional_offset_by` \（位置角度，间隔） 计算与此坐标的给定偏移量处的坐标。 `from_name` （姓名） [, frame, parse, cache] ） 给定一个名称，查询CDS名称解析程序以尝试检索该对象的坐标信息。 `from_pixel` \（xp、yp、wcs[, origin, mode] ） 创建新的 `SkyCoord` 使用 `WCS` 对象。 `get_constellation` \ [short_name, ...] ） 确定此坐标的星座 `SkyCoord` 包含。 `guess_from_table` \（表， *  * 坐标（千瓦） 创建和返回新的 `SkyCoord` 从一个天文表中的数据。 `insert` \（目标，值[, axis] ） 在对象中的给定索引之前插入坐标值，并返回一个新的帧对象。 检查此对象的帧是否与 `other` 对象。 `is_transformable_to` \(新建_框架) 确定是否可以将此坐标系转换为另一个给定坐标系。 `match_to_catalog_3d` \（目录协调[, nthneighbor] ） 查找此坐标与一组目录坐标的最接近的三维匹配。 `match_to_catalog_sky` \（目录协调[, nthneighbor] ） 在一组目录坐标中查找此坐标最近的天空匹配项。 计算此之间的天空位置角度（北偏东） `SkyCoord` 还有一个。 `radial_velocity_correction` \ [kind, obstime, ...] ） 计算将地球表面给定时间和地点的径向速度转换为重心速度或日心速度所需的修正量。 `search_around_3d` \（searcharoundcoords，distlimit） 在给定的三维半径内，搜索此对象中给定点集周围的所有坐标。 `search_around_sky` \（searcharoundcoords，seplimit） 在给定的天际间隔内，搜索该对象中给定点集周围的所有坐标。 计算此坐标和另一个坐标之间的天空间隔。 这个坐标和另一个坐标之间的距离。 `skyoffset_frame` \ [rotation] ） 返回天空偏移帧 `SkyCoord` 原产地。 `spherical_offsets_by` \(d_lon，d_lat) 计算偏离此坐标的指定角度偏移对的坐标。 计算要执行的角度偏移 from 这个坐标 to 另一个。 `to_pixel` \（wcs[, origin, mode] ） 使用 `WCS` 对象。 `to_string` \ [style] ） 坐标的字符串表示。 `transform_to` \（框架[, merge_attributes] ） 将此坐标转换为新帧。

frame
info

representation
representation_type
shape

apply_space_motion(new_obstime=None, dt=None)[源代码]

new_obstime`Time` 可选时间，可选

dt`Quantity``TimeDelta` 可选数量，时间增量，可选

new_coord`SkyCoord``SkyCoord`

contained_by(wcs, image=None, **kwargs)[源代码]

wcs`WCS``WCS`

image数组

**kwargs :

response布尔

True表示WCS示意图包含坐标，False表示不包含坐标。

directional_offset_by(position_angle, separation)[源代码]

position_angle`Angle`角度

`position_angle`

`separation`

classmethod from_name(name, frame='icrs', parse=False, cache=True)[源代码]

nameSTR

cache可选的布尔

coordSkyCoord

SkyCoord类的实例。

classmethod from_pixel(xp, yp, wcs, origin=0, mode='all')[源代码]

XP、YP浮动还是日积月累

wcs`WCS``WCS`

origin利息

mode“全部”或“wcs”

get_constellation(short_name=False, constellation_list='iau')[源代码]

short_name布尔

constellation_listSTR

constellationstr或string数组

classmethod guess_from_table(table, **coord_kwargs)[源代码]

**coord_kwargs

ValueError

insert(obj, values, axis=0)[源代码]

API签名与 `np.insert` API，但更为有限。插入索引规范 `obj` 必须是单个整数，并且 `axis` 必须是 `0` 用于索引前的简单插入。

obj利息

values类似阵列的

axis可选的

out`SkyCoord` 实例SkyCoord实例

is_equivalent_frame(other)[源代码]

otherSkyCoord或BaseCoordinateFrame

isequiv布尔

TypeError

is_transformable_to(new_frame)[源代码]

new_frameFrame类、Frame对象或字符串

transformable布尔或STR

`True` 如果可以将其转换为 `new_frame``False` 如果不是，或者字符串'same'if `new_frame` 是与此对象相同的系统，但未定义转换。

```if coord.is_transformable_to(some_unknown_frame):
coord2 = coord.transform_to(some_unknown_frame)
```

match_to_catalog_3d(catalogcoord, nthneighbor=1)[源代码]

nthneighbor可选的

Which closest neighbor to search for. Typically `1` is desired here, as that is correct for matching one set of coordinates to another. The next likely use case is `2`, for matching a coordinate catalog against itself (`1` is inappropriate because each point will find itself as the closest match).

idx整型数组

sep2d公司`Angle`角度

dist3d数量 [‘长度’]

match_to_catalog_sky(catalogcoord, nthneighbor=1)[源代码]

nthneighbor可选的

Which closest neighbor to search for. Typically `1` is desired here, as that is correct for matching one set of coordinates to another. The next likely use case is `2`, for matching a coordinate catalog against itself (`1` is inappropriate because each point will find itself as the closest match).

idx整型数组

sep2d公司`Angle`角度

dist3d数量 [‘长度’]

position_angle(other)[源代码]

pa`Angle`角度

```>>> c1 = SkyCoord(0*u.deg, 0*u.deg)
>>> c2 = SkyCoord(1*u.deg, 0*u.deg)
>>> c1.position_angle(c2).degree
90.0
>>> c3 = SkyCoord(1*u.deg, 1*u.deg)
>>> c1.position_angle(c3).degree
44.995636455344844
```

kindSTR

vcorr数量 [“速度”]

ValueError

TypeError

```>>> from astropy.time import Time
>>> from astropy.coordinates import SkyCoord, EarthLocation
>>> from astropy.constants import c
>>> t = Time(56370.5, format='mjd', scale='utc')
>>> loc = EarthLocation('149d33m00.5s','-30d18m46.385s',236.87*u.m)
>>> sc = SkyCoord(1*u.deg, 2*u.deg)
>>> vcorr = sc.radial_velocity_correction(kind='barycentric', obstime=t, location=loc)
>>> rv = rv + vcorr + rv * vcorr / c
```

```>>> vcorr = zb * c
```

```>>> zb = vcorr / c
>>> zb_plus_one_squared = (zb + 1) ** 2
>>> vcorr_rel = c * (zb_plus_one_squared - 1) / (zb_plus_one_squared + 1)
```

```>>> vcorr_rel = vcorr.to(u.Hz, u.doppler_optical(1*u.Hz)).to(vcorr.unit, u.doppler_relativistic(1*u.Hz))
```

```>>> from astropy.coordinates import solar_system_ephemeris
>>> sc = SkyCoord(1*u.deg, 2*u.deg)
>>> with solar_system_ephemeris.set('jpl'):
```
search_around_3d(searcharoundcoords, distlimit)[源代码]

distlimit数量 [‘长度’]

idxsearcharound整型数组

idxself整型数组

sep2d公司`Angle`角度

dist3d数量 [‘长度’]

search_around_sky(searcharoundcoords, seplimit)[源代码]

searcharoundcoords类坐标

seplimit数量 [“天使”]

idxsearcharound整型数组

idxself整型数组

sep2d公司`Angle`角度

dist3d数量 [‘长度’]

separation(other)[源代码]

sep`Angle`角度

1

https://en.wikipedia.org/wiki/Great-circle_distance

separation_3d(other)[源代码]

sep`Distance`距离

ValueError

skyoffset_frame(rotation=None)[源代码]

rotation角度状

spherical_offsets_by(d_lon, d_lat)[源代码]

d_lon角度状

d_lat角度状

`spherical_offsets_to`

`directional_offset_by`

spherical_offsets_to(tocoord)[源代码]

lon_offset`Angle`角度

lat_offset`Angle`角度

ValueError

`separation`

`position_angle`

to_pixel(wcs, origin=0, mode='all')[源代码]

wcs`WCS``WCS`

origin利息

mode“全部”或“wcs”

to_string(style='decimal', **kwargs)[源代码]

```'decimal': 'lat': {'decimal': True, 'unit': "deg"}
'lon': {'decimal': True, 'unit': "deg"}
'dms': 'lat': {'unit': "deg"}
'lon': {'unit': "deg"}
'hmsdms': 'lat': {'alwayssign': True, 'pad': True, 'unit': "deg"}
```

`to_string()` 对于细节和关键字参数（形成坐标的两个角度都是 `Angle` 实例）。关键字参数优先于样式默认值，并传递给 `to_string()` .

style{'hmsdms'，'dms'，'decimal'}

kwargs

transform_to(frame, merge_attributes=True)[源代码]

merge_attributes可选的布尔

ValueError