SkyCoord¶

class astropy.coordinates.SkyCoord(*args, copy=True, **kwargs)[ソース]¶

ベースクラス: astropy.utils.shapes.ShapedLikeNDArray

システム間の天体座標表現，操作，変換に柔軟なインタフェースを提供する高度なオブジェクト.

♪the SkyCoord クラスは初期化のための様々な入力を受け付ける.これらの座標は、少なくとも1つまたは複数の明確な単位を有する天座標値を提供しなければならない。入力は、スカラまたはリスト/タプル/配列とすることができ、スカラまたは配列座標を生成することができる(通過することができる SkyCoord.isscalar )である。通常，これは必要ではないにもかかわらず，座標フレームを指定する必要がある.球形表現の一般的なパターンは，

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 ...)

It is also possible to input coordinate values in other representations such as cartesian or cylindrical. In this case one includes the keyword argument representation_type='cartesian' (for example) along with data in x, y, and z.

なお、https：//docs.astterpy.org/en/安定/座標/を参照してください。

パラメータ

フレームワーク. ： BaseCoordinateFrame クラスまたは文字列、オプションBaseConsulateFrameまたは文字列、オプション

この座標系のタイプは SkyCoord 代表すべきです。提供されていない場合、または提供されていない場合、デフォルトでICRSとみなされる。

unit : Unit, string, or tuple of Unit または文字列、オプション単位、文字列、または単位または文字列のタプル、オプション

与えられた座標値の単位.もし一つの単位だけが提供された場合、それはすべての値に適用される。なお、予測座標値が混合された物理的意味(例えば、角度および距離)を有する場合、1単位のみを伝達することは、単位変換誤りを招く可能性がある。

obstime時間が限られていますので、お選びいただけます

時間を観察する。

equinox時間が限られていますので、お選びいただけます

座標フレームは時間を春分する.

representation_type文字列または表示クラス

表現法、例えば“球形”、“デカルト”または“円柱”を指定する。これは，与えられた表現に対応しなければならない位置パラメータや他のキーワードパラメータに影響を与える.

copyブル値、オプション

もし True (デフォルト)、任意の座標データのコピーが作成されます。このパラメータはキーワードパラメータとしてしか入力できない.

**keyword_args

ユーザが定義した座標枠の他のキーワードパラメータに適用する.一般的なオプションは、以下の通りです。

Ra、12月角度状、オプション: RA and Dec for frames where ra and dec are keys in the frame's representation_component_names, including ICRS, FK5, FK4, and FK4NoETerms.
pm_ra_cosdec, pm_dec量 [“角速度”] オプションです。: 自己重みは，時間単位ごとの角度で表される.
L，b角度状、オプション: 銀河.銀河 l そして b フレームの場合、その中で l そして b フレームのポイントです representation_component_names 含まれています Galactic フレームワーク。
pm_l_cosb, pm_b量 [“角速度”] オプションです。: 中の自己コンポーネント Galactic フレームは，時間単位ごとの角度で表される.
x, y, z浮遊や: デカルト座標値
u, v, w浮遊や: 銀河系フレームのデカルト座標値。
radial_velocity量 [“スピード”] オプションです。: 視線(すなわち径方向)に沿った速度成分は，速度単位で表される.

実例.

以下の例は初期化を説明する. SkyCoord 相手。許可された文法の完全な記述については、完全な座標文書を参照してください。まずいくつかの輸入です

>>> 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)

As shown, the frame can be a BaseCoordinateFrame class or the corresponding string alias. The frame classes that are built in to astropy are ICRS, FK5, FK4, FK4NoETerms, and Galactic. The string aliases are simply lower-case versions of the class name, and allow for creating a SkyCoord object and transforming frames without explicitly importing the frame classes.

属性要約

`frame` \
`info` \	名前、記述、フォーマットなどのメタ情報のコンテナ。
`representation` \
`representation_type` \
`shape` \	基礎データの形状。

方法要約

`apply_space_motion` \([new_obstime, dt] )	このオブジェクトに格納されている速度を使用して、空間線形運動(相対論補正を含む)を仮定して、この座標オブジェクトによって表されるソースの位置から新しい時間までを計算する。
`contained_by` \(WCS[, image] )	SkyCoordが所与のWCS概略図に含まれているかどうかを判断する。
`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` \(表，** Coord_kwargs)	新しいものを作成して戻ります `SkyCoord` 占星表からのデータです
`insert` \(OBJ，値[, axis] )	オブジェクト中の所与のインデックスの前に座標値を挿入し，新たなFrameオブジェクトを返す.
`is_equivalent_frame` \(その他)	この対象の枠組みが `other` 物体です。
`is_transformable_to` \(新規_フレームワーク)	この座標フレームを別の所与のフレームに変換することができるか否かが判断される。
`match_to_catalog_3d` \(コードを編集する[, nthneighbor] )	この座標がディレクトリ座標のセットに最も近い3次元一致を探す。
`match_to_catalog_sky` \(コードを編集する[, nthneighbor] )	リスト座標のセットにおいて、この座標に最も近い空一致を探す。
`position_angle` \(その他)	このオブジェクト間の空中位置角度(北の東)を計算します `SkyCoord` もう一回やります。
`radial_velocity_correction` \([kind, obstime, ...] )	地球表面上の所与の時間と地点の径方向速度を重心速度または日心速度に変換するのに必要な補正値を計算した。
`search_around_3d` \(海文字座標，距離制限)	このオブジェクトでは、所与の3次元半径内に提供される点の周りのすべての座標のセットが検索される。
`search_around_sky` \(海洋文字座標、分離)	このオブジェクトでは、所与の空分離範囲内で提供される点のセットの周囲のすべての座標が検索される。
`separation` \(その他)	この座標と他方の座標との間の空間隔を計算する。
`separation_3d` \(その他)	この座標と他方の座標との3次元間隔を算出する。
`skyoffset_frame` \([rotation] )	このパラメータ付きスカイオフセット枠に戻ります `SkyCoord` 原点にあります。
`spherical_offsets_by` \(d_lon，d_lat)	この座標からずれた指定角度ずれ量対の座標を算出する。
`spherical_offsets_to` (tocoord)	行く角度ずれを計算する 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)[ソース]¶

このオブジェクトに格納されている速度を使用して、空間線形運動(相対論補正を含む)を仮定して、この座標オブジェクトによって表されるソースの位置から新しい時間までを計算する。これは“画期的な転換”と呼ばれることがある。

進化前の初期時間は obstime この座標の属性.この方法は現在進化座標をサポートしていません フレームワーク. Vbl.ある obstime フレーム属性は obstime 実際にフレームの属性としてではなく、前後の時間のみを格納するために使用される。あるいはもし dt 与えられたものは obstime 提供する必要はありません。

パラメータ

new_obstime ： Time オプションです。時間、オプション: 職を発展させる時間。要求する. obstime 属性はこのフレームワーク上に現れる.
dt数量、時間増、オプション: しばらくの間震源の位置を発展させる.できません。 new_obstime それがそうです。

返品

new_coord ： SkyCoordSkyCoord: この座標を新しい時間の変化位置に持つ新しい座標オブジェクト。 obstime このオブジェクトには、以下の場合にのみ新しい時間が設定されます self あります。 obstime それがそうです。

contained_by(wcs, image=None, **kwargs)[ソース]¶

SkyCoordが所与のWCS概略図に含まれているかどうかを判断する。

パラメータ

wcs ： WCSWCS: WCS座標内の座標にあるかどうかを調べる.
image配列.: オプションです。座標を検査しているWCSオブジェクトに関連する画像.与えられていない場合、NAXISキーワードは、座標がWCSフットプリント範囲内にあるかどうかを決定するために使用される。
**kwargs :: 伝達する他のパラメータは to_pixel

返品

responseブルル.: TrueはWCS模式図が座標を含み，Falseは座標を含まないことを表す.

directional_offset_by(position_angle, separation)[ソース]¶

この座標から所与のオフセットにおける座標を計算する。

パラメータ

position_angle ： Angle角を挟む.: ずれた位置角度
分離： Angle角を挟む.: 偏角分離

返品

ニュースの要点 ： SkyCoordSkyCoord: 与えられたオフセット量に対応する位置の座標 position_angle そして separation それがそうです。

参考

position_angle: メソッドの逆演算。 position_angle 成分.成分
separation: メソッドの逆演算。 separation 成分.成分

注意事項

返されたSkyCoordフレームは、結果フレームタイプのフレーム属性のみを保持する。(例えば、フレームが入力された場合 ICRS 1つは equinox 値は保存されますが obstime できません。)

より完全な変換オフセットのセットを得るためには、ご利用ください WCS それがそうです。 skyoffset_frame() より小さいオフセットについてXYデカルトシステムに近似するために、基準点に(経度=0、経度=0)を有する球形フレームを作成するために使用されてもよい。この方法の独特な点は球面上で正確だということだ。

classmethod from_name(name, frame='icrs', parse=False, cache=True)[ソース]¶

名前が与えられた場合、CDS名解析部に問い合わせて、オブジェクトの座標情報の検索を試みる。中の構成項目設定でデータベース、ゴマURL、クエリタイムアウトを検索することができます astropy.coordinates.name_resolve --参照されている文書文字列 get_icrs_coordinates より多くの情報を得ることができます

パラメータ

name応力.応力: 座標を取得するオブジェクトの名前、例えば 'M42' それがそうです。
フレームワーク. ：文字列または BaseCoordinateFrame クラスやインスタンス文字列や: オブジェクトを変換するフレーム。
解析：ブール値: 名前から座標を抽出することを正規表現解析により試みるかどうか.名前にJ座標が埋め込まれたオブジェクトディレクトリ名、例えば‘CRTS SS S 100805 J 194428−420209’については、同じオブジェクト名に対するSESAMEクエリよりもはるかに速い可能性がある。このようにして抽出された座標はデータベース座標と数分角秒異なる可能性があるため，次角秒精度の座標を必要としない場合にのみこのオプションを用いる.
cacheブル値、オプション: 結果をキャッシュするかどうかを決定する.既存の値を更新または上書きするには、転送してください cache='update' それがそうです。

返品

coordSkyCoord: SkyCoordクラスの例.

classmethod from_pixel(xp, yp, wcs, origin=0, mode='all')[ソース]¶

新しいものを作ります SkyCoord 画素座標から使用する WCS 物体です。

パラメータ

XP、YP浮動またはndarray: 変換する座標。
wcs ： WCSWCS: 変換に用いるWCS
origin集積する.: 0からの画素座標か1からの画素座標かを返す。
mode‘All’または‘WCS’: 歪みを含めた変換を行うかどうか ('all' )またはコアWCS変換のみを含む ('wcs' ）。

返品

同軸. ： SkyCoordSkyCoord: 入力に対応する空座標を持つ新しいオブジェクト xp そして yp それがそうです。

参考

to_pixel: 逆操作を実行するには、以下の操作を実行してください
astropy.wcs.utils.pixel_to_skycoord: この方法の実現

get_constellation(short_name=False, constellation_list='iau')[ソース]¶

この座標の星座を決定します SkyCoord 含まれています。

パラメータ

short_nameブルル.: Trueであれば，返される名前はIAU承認の略語名である.そうでなければ、星座のフルネームが使用されるだろう。
constellation_list応力.応力: 使う星座集。現在限りである 'iau' これは国際天文学連合が認めた88の“現代”星座を意味する。

返品

constellation文字列または文字列配列: これがスカラー座標である場合、コンステレーションの名前に戻る。もしそれが配列であれば SkyCoord これは，名前配列を返す.

参考

astropy.coordinates.get_constellation

注意事項

空の1つの点がどの星座にあるかを決定するために，まずB 1875を処理し，次に88個の現代星座のDelporte境界を用いて以下のようになる. Roman 1987 それがそうです。

classmethod guess_from_table(table, **coord_kwargs)[ソース]¶

新しいものを作成して戻ります SkyCoord 占星表からのデータです

この方法は、要求されたフレームのコンポーネントのサイズを区別しない名前(差分を含む)で始まる表列と一致し、それらの後に非英数字文字が続くことを前提とする。また，以下の条件を満たす列をマッチングする. end もし英数字文字でなければ その前に これです。

例えば，1番目のルールは以下のような名前の列を表す. 'RA[J2000]' あるいは…。 'ra' と解釈されます ra の属性 ICRS フレーム、しかし 'RAJ2000' あるいは…。 'radius' あります。 not それがそうです。同様に2つ目のルールは Galactic フレーム表現名は 'gal_l' 使用することができます l コンポーネントですが gall あるいは…。 'fill' そんなことないよ。

ここで英数字の定義はUnicodeによる英数字の定義に基づいているが，ない _ (通常は英数字と考えられる)。したがって，ASCIIでは，非英数字文字は <space>_!"#$%&'()*+,-./\:;<=>?@[]^`{{|}}~ ）。

パラメータ

表： Table または子類表や子類: その中からデータのテーブルをロードします。
**coord_kwargs: いずれの他のキーワードパラメータもそのクラスの構造関数に直接渡される.

返品

ニュース ： SkyCoord または子類SkyCoordかサブクラス: 新しい SkyCoord (またはサブクラス)オブジェクト。

賃上げをする

ValueError: 表中で1つのコンポーネントの複数の適合項目が見つかった場合，他の適合項でなければ有効なフレームワークコンポーネント名である.表にも見つかった値に“coord_kwargs”が与えられていれば.

insert(obj, values, axis=0)[ソース]¶

オブジェクト中の所与のインデックスの前に座標値を挿入し，新たなFrameオブジェクトを返す.

挿入する値は該当する定位置設定規則に適合しなければならない SkyCoord 物体です。

API署名と np.insert APIは、しかし、より多くの制限を受けている。INSERTインデックス仕様 obj 単一の整数でなければなりません axis きっとそうだ 0 インデックスの前に簡単に挿入するために用いる.

パラメータ

obj集積する.: その前の整数インデックス values 挿入されています。
valuesアレイ式.: 挿入する値です。もしタイプが values 数とは違います values マッチングタイプに変換します。
axis形が整っていて、オプションです: 挿入された軸に沿って values それがそうです。デフォルト値は0であり、これは唯一の許容値であり、1行に挿入される。

返品

out ： SkyCoord 実例.SkyCoord事例: 挿入値を持つ新しい座標オブジェクト

is_equivalent_frame(other)[ソース]¶

この対象の枠組みが other 物体です。

同じフレームワークとなるためには，2つのオブジェクトは同じフレームクラスであり，同じフレーム属性を持つ必要がある.二人の SkyCoord 相手は、 all 対象フレームに関連する属性だけではなく、フレーム属性を一致させなければならない。

パラメータ

otherSkyCoordまたはBasecoateFrame: 検査するもう一つの対象です。

返品

isequivブルル.: フレームが同じであればTrue，異なる場合はFalseとなる.

賃上げをする

TypeError: もし other 一つではない SkyCoord あるいはそうだ BaseCoordinateFrame あるいはサブクラスです

is_transformable_to(new_frame)[ソース]¶

この座標フレームを別の所与のフレームに変換することができるか否かが判断される。

パラメータ

new_frameFrameクラス、Frameオブジェクト、または文字列: 変換するためのアドバイスフレームワーク。

返品

transformableブールまたは文字列: True if this can be transformed to new_frame, False if not, or the string 'same' if new_frame is the same system as this object but no transformation is defined.

注意事項

返却値“Same”は、変換が機能することを示すが、そのオブジェクトのコピーのみが返される。期待される用途は

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

これは効果があります some_unknown_frame 同じFrame類だったのですが coord それがそうです。これは、フレーム属性(例えば、ICR)にかかわらずフレームが同じ場合に適用されるが、注意されたい。 できる限りのことをする また，同一のFrameクラスを定義することを忘れているが異なる属性を持つ2つのオブジェクト間の変換を表す.

match_to_catalog_3d(catalogcoord, nthneighbor=1)[ソース]¶

この座標がディレクトリ座標のセットに最も近い3次元一致を探す。

これは3次元の最も近い隣人を探し、以下の場合にのみ空との距離が異なることになります distance このオブジェクトに設置されているのか、それとも catalogcoord 物体です。

この機能の使用方法の詳細については、中の例を参照されたい色分解、オフセット、ディレクトリマッチング、および関連機能それがそうです。

パラメータ

編目コード ： SkyCoord あるいは…。 BaseCoordinateFrameSkyCoordまたはBasecoateFrame: その中で適合項の基底リストを検索する.これは、一般に、配列の座標オブジェクト(すなわち、 catalogcoord.isscalar == False ）
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全型配列: 索引から catalogcoord このオブジェクトの各座標の一致点を取得する.形状はこの対象にマッチする.
Sep 2 d ： Angle角を挟む.: このオブジェクトの各要素の最も近い一致間の空の間隔 catalogcoord それがそうです。形状はこの対象にマッチする.
dist3d量 [‘長さ’]: このオブジェクト内の各要素の最も近い一致間の3 D距離 catalogcoord それがそうです。形状はこの対象にマッチする.

参考

astropy.coordinates.match_coordinates_3d
SkyCoord.match_to_catalog_sky

注意事項

この方法には SciPy インストールするには、そうでなければ失敗します。

match_to_catalog_sky(catalogcoord, nthneighbor=1)[ソース]¶

リスト座標のセットにおいて、この座標に最も近い空一致を探す。

この機能の使用方法の詳細については、中の例を参照されたい色分解、オフセット、ディレクトリマッチング、および関連機能それがそうです。

パラメータ

編目コード ： SkyCoord あるいは…。 BaseCoordinateFrameSkyCoordまたはBasecoateFrame: その中で適合項の基底リストを検索する.これは、一般に、配列の座標オブジェクト(すなわち、 catalogcoord.isscalar == False ）
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全型配列: 索引から catalogcoord このオブジェクトの各座標の一致点を取得する.形状はこの対象にマッチする.
Sep 2 d ： Angle角を挟む.: このオブジェクトの各要素の最も近い一致間の空の間隔 catalogcoord それがそうです。形状はこの対象にマッチする.
dist3d量 [‘長さ’]: このオブジェクト内の各要素の最も近い一致間の3 D距離 catalogcoord それがそうです。形状はこの対象にマッチする.この事とこの2つのことをしない限り catalogcoord 関連する距離があれば，この数はすべての震源の距離を1(無量綱)と仮定する。

参考

astropy.coordinates.match_coordinates_sky
SkyCoord.match_to_catalog_3d

注意事項

この方法には SciPy インストールするには、そうでなければ失敗します。

position_angle(other)[ソース]¶

このオブジェクト間の空中位置角度(北の東)を計算します SkyCoord もう一回やります。

パラメータ

他にも ： SkyCoordSkyCoord: 位置角度の別の座標を計算する.これは、位置角度ベクトルの“頭”とみなされる。

返品

pa ： Angle角を挟む.: 以下の位置を指すベクトルの(正)位置角 self 至る other それがそうです。もしどれかがあれば self あるいは…。 other 配列が含まれていればこれは対応するものになります numpy 放送規則。

実例.

>>> 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

radial_velocity_correction(kind='barycentric', obstime=None, location=None)[ソース]¶

地球表面上の所与の時間と地点の径方向速度を重心速度または日心速度に変換するのに必要な補正値を計算した。

パラメータ

kind応力.応力: この速度は校正します。“重心”や“日心”でなければならない。
昏睡時間. ： Time あるいはなくても，オプションである.時間がないかどうか、オプションです: 校正の時間を計算する。もし…。 None vt.的 obstime 属性上のFrame属性 SkyCoord 使用されます。
位置： EarthLocation あるいはなくても，オプションである.EarthLocationまたはNone、オプション: 修正された視点位置を計算する.もし…。 None vt.的 location 入力フレーム属性 obstime この値が空であれば使用されます location 属性上のFrame属性 SkyCoord 使用されます。

返品

vcorr量 [“スピード”]: 肯定的な兆候の修正がある。つまり add これは観測された径方向速度に加算して重心(または日心)速度を得る。M/s精度以上の精度が必要な場合は、以下の説明を参照されたい。

賃上げをする

ValueError: もしどれかがあれば obstime あるいは…。 location 伝来のものだ None )Frame属性がここに設定されている場合 SkyCoord それがそうです。
TypeError: もし obstime あるいは…。 location パラメータやフレームワーク属性として提供することはできない.

注意事項

重心補正の計算精度は、日心補正よりも高く、追加の物理的要因(例えば、時間膨張)を含む。M/s精度が必要であれば、重心補正を使用してください。

ここでのアルゴリズムは、mm/sレベルで補正を行うのに十分であるが、適用には注意が必要である。戻った重心補正には光学近似v=z*cを用いる.厳密には，重心補正は乗性であり，適用すべきである.

>>> 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 Wright&Eastman(2014)3節で定義した重心補正赤移動である.上で与えられた適用式は，彼らの式(11)から導かれ，半径方向速度を仮定する. rv 同様の光学的約定を用いて定義されている.これは速度定義の問題と見なすことができ，それ自体はいかなる精度の損失も意味するものではなく，結果を解釈する過程で十分な慎重な措置がとられていることを前提としていることに注意されたい.完全相対論速度で表される重心補正(例えば、アプリケーションを実行する別のソフトウェアに入力として提供する)が必要な場合、以下のレシピを使用することができる。

>>> 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))  

See also doppler_optical, doppler_radio, and doppler_relativistic for more information on the velocity conventions.

デフォルトでは，この方法は内蔵星を用いて従来から太陽と地球位置を計算している.他の天体暦は設定することで solar_system_ephemeris 変数、直接または通過 with 陳述する。例えば、JPL天体暦を使用するには、以下の動作を実行してください。

>>> from astropy.coordinates import solar_system_ephemeris
>>> sc = SkyCoord(1*u.deg, 2*u.deg)
>>> with solar_system_ephemeris.set('jpl'):  
...     rv += sc.radial_velocity_correction(obstime=t, location=loc)  

search_around_3d(searcharoundcoords, distlimit)[ソース]¶

このオブジェクトでは、所与の3次元半径内に提供される点の周りのすべての座標のセットが検索される。

これは以下の点で使用するために設計されている SkyCoord オブジェクトは，スカラー座標ではない.スカラー座標については、使用したほうがいいです separation_3d それがそうです。

この機能の使用方法の詳細については、中の例を参照されたい色分解、オフセット、ディレクトリマッチング、および関連機能それがそうです。

パラメータ

海洋弦線 ： SkyCoord あるいは…。 BaseCoordinateFrameSkyCoordまたはBasecoateFrame: この中で適合点の座標を探すことを試みる. SkyCoord それがそうです。これは、スカラー座標オブジェクトではなく、配列座標を有するオブジェクトであるべきである。
distlimit量 [‘長さ’]: 探索する物理半径。

返品

idxsearcharound全型配列: 索引から searcharoundcoords 対応する要素にマッチしています idxself それがそうです。形状が一致する idxself それがそうです。
idxself全型配列: 索引から self 対応する要素にマッチしています idxsearcharound それがそうです。形状が一致する idxsearcharound それがそうです。
Sep 2 d ： Angle角を挟む.: 座標間の空中間隔。形状が一致する idxsearcharound そして idxself それがそうです。
dist3d量 [‘長さ’]: 座標間の3 D距離。形状が一致する idxsearcharound そして idxself それがそうです。

参考

astropy.coordinates.search_around_3d
SkyCoord.search_around_sky

注意事項

この方法には SciPy インストールするには、そうでなければ失敗します。

現在の実現では、返却値の順序は常に searcharoundcoords (だから) idxsearcharound 昇順に並べる)。しかし、これは実装詳細と考えられているので、将来のバージョンで変更される可能性があります。

search_around_sky(searcharoundcoords, seplimit)[ソース]¶

このオブジェクトでは、所与の空分離範囲内で提供される点のセットの周囲のすべての座標が検索される。

これは以下の点で使用するために設計されている SkyCoord オブジェクトは，スカラー座標ではない.スカラー座標については、使用したほうがいいです separation それがそうです。

この機能の使用方法の詳細については、中の例を参照されたい色分解、オフセット、ディレクトリマッチング、および関連機能それがそうです。

パラメータ

searcharoundcoordsクラス座標.: この中で適合点の座標を探すことを試みる. SkyCoord それがそうです。これは、スカラー座標オブジェクトではなく、配列座標を有するオブジェクトであるべきである。
seplimit量 [“天使”]: 空の分離は、中を探している。

返品

idxsearcharound全型配列: 索引から searcharoundcoords 対応する要素にマッチしています idxself それがそうです。形状が一致する idxself それがそうです。
idxself全型配列: 索引から self 対応する要素にマッチしています idxsearcharound それがそうです。形状が一致する idxsearcharound それがそうです。
Sep 2 d ： Angle角を挟む.: 座標間の空中間隔。形状が一致する idxsearcharound そして idxself それがそうです。
dist3d量 [‘長さ’]: 座標間の3 D距離。形状が一致する idxsearcharound そして idxself それがそうです。

参考

astropy.coordinates.search_around_sky
SkyCoord.search_around_3d

注意事項

この方法には SciPy インストールするには、そうでなければ失敗します。

現在の実現では、返却値の順序は常に searcharoundcoords (だから) idxsearcharound 昇順に並べる)。しかし、これは実装詳細と考えられているので、将来のバージョンで変更される可能性があります。

separation(other)[ソース]¶

この座標と他方の座標との間の空間隔を計算する。

注釈

もし other 座標オブジェクトは異なるフレームに位置し，まずそのオブジェクトのフレームを変換する.これを考慮しないと，直感的でない行動を招く可能性がある.特筆すべきは self.separation(other) そして other.separation(self) この場合、同じ答えが与えられないかもしれない。

この機能の使用方法の詳細については、中の例を参照されたい色分解、オフセット、ディレクトリマッチング、および関連機能それがそうです。

パラメータ

他にも ： SkyCoord あるいは…。 BaseCoordinateFrameSkyCoordまたはBasecoateFrame: 分離した座標を設定する.

返品

sep ： Angle角を挟む.: この点とこの2つの線の間の空の距離は other 座標です。

注意事項

分離はVincenty式を用いて計算され，両極と対極を含むすべての位置で安定している. [1].

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

separation_3d(other)[ソース]¶

この座標と他方の座標との3次元間隔を算出する。

この機能の使用方法の詳細については、中の例を参照されたい色分解、オフセット、ディレクトリマッチング、および関連機能それがそうです。

パラメータ

他にも ： SkyCoord あるいは…。 BaseCoordinateFrameSkyCoordまたはBasecoateFrame: 分離した座標を設定する.

返品

sep ： Distance距離: この2つの座標間の実空間距離。

賃上げをする

ValueError: この座標または他の座標に距離がなければ。

skyoffset_frame(rotation=None)[ソース]¶

このパラメータ付きスカイオフセット枠に戻ります SkyCoord 原点にあります。

返品

星枠. ： SkyOffsetFrameSkyOffsetFrame: このタイプと同じ空ずれ枠 SkyCoord (例えば、このオブジェクトがICRS座標を有する場合、結果フレームはSkyOffsetICRSであり、原点はそのオブジェクトを設定する)
rotation角度状: フレーム巡り. origin それがそうです。回転する記号は左手定則である.すなわち、非回転システムにおける特定の位置角度のオブジェクトは、最終フレームにおいて正緯度(Z)方向に送信される。

spherical_offsets_by(d_lon, d_lat)[ソース]¶

この座標からずれた指定角度ずれ量対の座標を算出する。

パラメータ

d_lon角度状: 経度方向の角度がずれている。経度“の定義は、座標のフレーム(例えば、RAは赤道座標を表す)に依存する。
d_lat角度状: 緯度方向の角度がずれている。“緯度”の定義は，この座標のフレーム(たとえば，赤道座標のDEC)に依存する.

返品

新しい座標. ： SkyCoordSkyCoord: オフセット量に対応して d_lat 緯度方向では d_lon 経度方向にあります。

参考

spherical_offsets_to: 別の座標の角度ずれを計算します
directional_offset_by: 座標をある方向に一定の角度だけずらす

注意事項

これは内部で使われています SkyOffsetFrame この転換をしようとしていますより完全な変換オフセットのセットを得るためには、ご利用ください SkyOffsetFrame あるいは…。 WCS 手で操作する。この特定の方法は、以下の操作を実行することによって再現することができる SkyCoord(SkyOffsetFrame(d_lon, d_lat, origin=self.frame).transform_to(self)) それがそうです。

spherical_offsets_to(tocoord)[ソース]¶

行く角度ずれを計算する from この座標は to もう一つ。

パラメータ

Tocoord ： BaseCoordinateFrameBaseCoordinateFrame: ずれ量の座標を調べる.

返品

lon_offset ： Angle角を挟む.: 経度方向の角度がずれている。経度“の定義は、座標のフレーム(例えば、RAは赤道座標を表す)に依存する。
lat_offset ： Angle角を挟む.: 緯度方向の角度がずれている。“緯度”の定義は，この座標のフレーム(たとえば，赤道座標のDEC)に依存する.

賃上げをする

ValueError: もし tocoord この写真と同じフレーム内にありません。これは違います separation オフセット成分は、フレームの特定の選択に大きく依存するので、``Separation_3 d``方法。

参考

separation: 上の 合計する. 角度オフセット(コンポーネントに分解されていない).
position_angle: オフセット方向とします。

注意事項

これは空ずれフレーム機構を用いるため，その対象のフレームクラスに新たな空ずれフレームが存在しなければ，新たな空ずれフレームが生成される.

to_pixel(wcs, origin=0, mode='all')[ソース]¶

属性はこの座標を画素座標に変換する. WCS 物体です。

パラメータ

wcs ： WCSWCS: 変換に用いるWCS
origin集積する.: 0からの画素座標か1からの画素座標かを返す。
mode‘All’または‘WCS’: 歪みを含めた変換を行うかどうか ('all' )またはコアWCS変換のみを含む ('wcs' ）。

返品

XP、YP ： numpy.ndarraynumpy.ndarray: 画素座標.

参考

astropy.wcs.utils.skycoord_to_pixel: この方法の実現

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"}
          'lon': {'pad': True, 'unit': "hour"}

見 to_string() 詳細情報とキーワードパラメータについては(座標を構成する2つの角度とも Angle 例)。キーワードパラメータは、スタイルのデフォルト値よりも優先され、転送されます。 to_string() それがそうです。

パラメータ

style{‘hmsdms’，‘dms’，‘decimal’}: 使用するフォーマット仕様。これらの符号化は、座標を表す3つの最も一般的な方法である。黙認する. decimal それがそうです。
kwargs: キーワードパラメータは to_string() それがそうです。

transform_to(frame, merge_attributes=True)[ソース]¶

この座標を新しいフレームに変換する.

正確なフレームに変換することは merge_attributes それがそうです。もし False ターゲットフレームは、完全に入力された方法で使用される。しかしこれは往々にして人々が望んでいるものではありませんたとえば，OblTime属性を持つICRS座標をFK 4に変換したい人がいると仮定すると，この場合，人間はこの情報を利用したい可能性がある.したがって，デフォルトの場合には merge_attributes はい。 True ここで、優先度は、(1)宛先フレーム内の値を明示的に設定(すなわち、非デフォルト)すること、(2)ソースフレーム内の値を明示的に設定すること、(3)宛先フレームにおけるデフォルト値を設定すること、である。

この2つの場合、ソース上に明示的に設定された任意の属性に注意してください SkyCoord ターゲットフレーム定義に属さないコンテンツは保持される(生成されたものに格納される) SkyCoord )したがって、往復することができる(例えば、FK 4からICRSまで、マスク時間を失うことなくFK 4に到達する)。

パラメータ

フレームワーク. ：str、 BaseCoordinateFrame クラスやインスタンス、または SkyCoord 実例.文字列は: この座標をフレームに変換する.もし1つが SkyCoord したがって、下位フレームを抽出し、他のすべての情報を無視する。
merge_attributesブル値、オプション: ソース内の属性を明示的に設定することによって、ターゲットフレーム内のデフォルト属性を上書きすることが許可されるかどうか(上記の注釈を参照；デフォルト： True ）。

返品

同軸. ： SkyCoordSkyCoord: 属性にはこの座標を表す新しいオブジェクトがある. frame フレームワーク。

賃上げをする

ValueError: 可能な変換経路がなければ。

ナビゲーション

SkyCoord¶