EarthLocation

class astropy.coordinates.EarthLocation(*args, **kwargs)

ベースクラス: astropy.units.quantity.Quantity

地球上の位置です

まず，地心(x，y，z)座標が与えられた場合に初期化を試み，失敗すれば大地座標(経度，緯度，参照楕円球上方の高さ)を仮定した場合に別の試みを行う.大地測定形式を用いた場合，測定された経度は東に向かって増加するため，西経は負である。内部には，座標は地心単位で格納される.

To ensure a specific type of coordinates is used, use the corresponding class methods (from_geocentric and from_geodetic) or initialize the arguments with names (x, y, z for geocentric; lon, lat, height for geodetic). See the class methods for details.

注意事項

このような座標変換フレームワークは ITRS フレームワーク。適当なのを探してください ITRS 相手、ご利用ください itrs 財産です。

属性要約

ellipsoid \	大地座標に変換するためのデフォルト球体。
geocentric \	X、Y、Zの数のタプルに変換します
geodetic \	デフォルトの球体の大地座標に変換する.
height \	デフォルトの球体の位置高。
info \	名前、記述、フォーマットなどのメタ情報のコンテナ。
itrs \	Vbl.一種 ITRS デフォルトの場合，このオブジェクトの位置は obstime それがそうです。
lat \	デフォルトでは球体の位置緯度。
lon \	デフォルトの球体の位置経度。
x \	地心座標のX成分。
y \	地心座標のY成分。
z \	地心座標のZ成分。

方法要約

from_geocentric \(X，y，z[, unit] )	地球上の位置は、地心座標から初期化される。
from_geodetic \(長い，後[, height, ellipsoid] )	地球上の位置は、大地座標から初期化される。
get_gcrs \(BUBTIME)	速度GCR位置 obstime GCRS座標とします。
get_gcrs_posvel \(BUBTIME)	要求された位置でこのオブジェクトのGCR位置と速度を計算する. obstime それがそうです。
get_itrs \([obstime] )	1つを生成する ITRS オブジェクトは，そのオブジェクトの位置が要求されたものに位置する. obstime それがそうです。
get_site_names \()	天文台名リストの取得 of_site それがそうです。
gravitational_redshift \(BUBSTIME[, bodies, masses] )	地球の重力の赤の移動に戻ります
of_address \(アドレス[, get_height, google_api_key] )	OpenStreetMap Nominatimツールに問い合わせることで、所与のアドレスのこのようなオブジェクトを返します [1] (デフォルト)またはGoogleジオコーディングAPI [2], これは、指定されたAPI鍵を必要とする。
of_site \(サイト_名前)	既知の天文台/サイトのこのようなオブジェクトを名前で返します。
to_geocentric \()	X、Y、Zの数のタプルに変換します
to_geodetic \([ellipsoid] )	大地座標に変換する。

属性文書

ellipsoid

大地座標に変換するためのデフォルト球体。

geocentric

X、Y、Zの数のタプルに変換します

geodetic

デフォルトの球体の大地座標に変換する.

height

デフォルトの球体の位置高。

info

名前、記述、フォーマットなどのメタ情報のコンテナ。これは，オブジェクトを表中の混合列として用いる場合に必要であるが，メタ情報を格納する一般的な方法としても利用可能である.

itrs

Vbl.一種 ITRS デフォルトの場合，このオブジェクトの位置は obstime それがそうです。

lat

デフォルトでは球体の位置緯度。

lon

デフォルトの球体の位置経度。

x

地心座標のX成分。

y

地心座標のY成分。

z

地心座標のZ成分。

方法文書

classmethod from_geocentric(x, y, z, unit=None)

地球上の位置は、地心座標から初期化される。

パラメータ

X、y、z ： Quantity 配列のような数量やアレイ状

デカルト座標。数量でなければ unit 与えるべきです。

unitクラスユニットまたはクラスなし

Physical unit of the coordinate values. If x, y, and/or z are quantities, they will be converted to this unit.

賃上げをする

astropy.units.UnitsError

If the units on x, y, and z do not match or an invalid unit is given.

ValueError

If the shapes of x, y, and z do not match.

TypeError

もし x 一つではない Quantity そして何の単位も与えられていない。

classmethod from_geodetic(lon, lat, height=0.0, ellipsoid=None)

地球上の位置は、大地座標から初期化される。

パラメータ

lon ： Longitude 浮遊しています経度や浮動小数点

地球東経。初期化であってもよい Angle オブジェクト(浮いていれば度単位).

lat ： Latitude 浮遊しています緯度や変動

地球の緯度。初期化であってもよい Latitude オブジェクト(浮いていれば度単位).

height量 [‘長さ’] 浮遊していてもオプションです

スフェロイド上方の高さ(浮動であれば米単位；デフォルト値：0)を参考にした。

ellipsoid文字列、オプション

使用するのはスフェロイドの名称(デフォルト値：‘WGS 84’)を参照する。使用可能なスフェロイドとしては，‘WGS 84’，‘GRS 80’，‘WGS 72’がある。

賃上げをする

astropy.units.UnitsError

もし装置が開いたら lon そして lat 角形と一致しないか、または height 一定の長さがあります。

ValueError

If lon, lat, and height do not have the same shape, or if ellipsoid is not recognized as among the ones implemented.

注意事項

地心座標への変換については，ERFAルーチン gd2gc 使っています。Https：//github.com/Liberfa/erfaを参照

get_gcrs(obstime)

速度GCR位置 obstime GCRS座標とします。

パラメータ

昏睡時間. ： Time時間です。

♪the obstime GCRの位置/速度を計算するには、以下の操作を実行してください。

返品

gcrs ： GCRS 実例.GCRSの例

速度も含まれています。

get_gcrs_posvel(obstime)

要求された位置でこのオブジェクトのGCR位置と速度を計算する. obstime それがそうです。

パラメータ

昏睡時間. ： Time時間です。

♪the obstime GCRの位置/速度を計算するには、以下の操作を実行してください。

返品

ファジィ論理. ： CartesianRepresentationCartesianRepresentation

対象のGCR位置

わかりにくい. ： CartesianRepresentationCartesianRepresentation

物体のGCRS速度

get_itrs(obstime=None)

1つを生成する ITRS オブジェクトは，そのオブジェクトの位置が要求されたものに位置する. obstime それがそうです。

パラメータ

昏睡時間. ： Time あるいはない.時間かないか

♪the obstime 新しいものに応用する ITRS あるいはない場合はデフォルト値となる. obstime 使用されます。

返品

itrs ： ITRSITRS

ITRSフレームワークにおける新しいオブジェクト

classmethod get_site_names()

天文台名リストの取得 of_site それがそうです。

注釈

この関数を呼び出すと，まずAstpyデータサーバからサイト情報のダウンロードを試みる.それが利用できない(すなわち、インターネット接続が利用できない)場合、それはAsterpyに含まれるリストに返される(これは限られた時代遅れのサイトのセットである)。サイトを追加すべきだとお考えでしたら、どうぞ astropy-data repository それがそうです。

返品

names文字列リスト

有効天文台名一覧

参考

of_site

この関数が返す1つのサイト名の実際のLocationオブジェクトを取得する.

gravitational_redshift(obstime, bodies=['sun', 'jupiter', 'moon'], masses={})

地球の重力の赤の移動に戻ります

要求された太陽系天体による3メートル/秒オーダーの引力赤移動を計算する。

パラメータ

昏睡時間. ： Time時間です。

♪the obstime 赤移動を計算して…で赤移動を計算する.

bodies反復可能、オプション

赤シフト計算に含まれる物体(地球を除く)。リスト要素は、任意の本文名でなければなりません。 get_body_barycentric 受け入れます。木星、太陽、月を黙認する。常に地球を含んでいます 地球は…。 位置)。

大衆.大衆. ：DICT [str, Quantity] オプションです。Dict[文字列，

要求された物体が仮定した質量または引力パラメータ(G*質量) bodies それがそうです。太陽、木星、月、地球を覆うデフォルト値、または他の物体の品質を伝達するために使用することができる。

返品

赤の移動. ： Quantity量

所与の遮蔽時間において、速度単位で表される引力が赤く移動する。

classmethod of_address(address, get_height=False, google_api_key=None)

OpenStreetMap Nominatimツールに問い合わせることで、所与のアドレスのこのようなオブジェクトを返します [1] (デフォルト)またはGoogleジオコーディングAPI [2], これは、指定されたAPI鍵を必要とする。

各位置に容易にアクセスできる便利で迅速な機能である。正確な位置を指定する必要がある場合には、初期値設定項を直接使用して、経度、緯度、標高を入力する必要がある。

バックグラウンドでは，これは上記のいずれかのAPIにWebクエリを発行するだけである.これは乱用されるという意味ではない！OpenStreetMapとGoogleはIPベースのクエリ制限を使用しており、1時間に数千個以上のクエリが送信された場合、IPは禁止されます。 [2].

警告

クエリが1つ以上の位置に戻る場合(例えば、検索 address='springfield' )であれば、この関数は使用される 1つ目は 戻った位置。

パラメータ

address応力.応力

その位置のアドレスを取得しなければならない.Google Maps APIによれば、これは、完全に指定されたストリートアドレス(例えば、ニューヨーク州メインストリート123番地)または都市名(例えば、コネチカット州ダンバリー)などであってもよい。

get_heightブル値、オプション

これはGoogle APIを使用する場合にのみ有効です！ご参照ください google_api_key 下のブロックです。検索された位置を用いてGoogle Maps Elevation APIに対して2回目のクエリを実行し，入力アドレスの高さを検索する. [3].

google_api_key文字列、オプション

ジオコーディングAPIおよびオプションでElevation APIが有効になったGoogle API鍵。参照してください [4] より多くの情報を得ることができます

返品

位置 ： EarthLocation (またはサブクラス)インスタンスEarthLocation(またはサブクラス)事例

住所の位置を入力する。Typeになります

参考文献

1(1,2)

https://nominatim.openstreetmap.org/

2(1,2,3)

https://developers.google.com/maps/documentation/geocoding/start

3

https://developers.google.com/maps/documentation/elevation/start

4

https://developers.google.com/maps/documentation/geocoding/get-api-key

classmethod of_site(site_name)

既知の天文台/サイトのこのようなオブジェクトを名前で返します。

これは、機能的に整った天文台およびそのすべての属性の詳細なレジストリではなく、基本サイト情報を取得するための迅速で便利な機能である。

このサイトに関する他の情報は .info.meta この方法を用いて得られたサイト辞書(以下の例を参照)。

注釈

この関数を呼び出す際には，Astpyデータサーバからサイト情報のダウンロードを試みる.サイトの追加をご希望でしたら、お申し付けください astropy-data repository それがそうです。レジストリ内にあるサイト(すなわち、インターネット接続が利用できない)が見つからない場合、それは内蔵リストに依存し、将来、このバンドルリストは、オンラインバージョンから抽出された仕様天文台のバージョン制御リストを含むことができるが、現在は一例としてグリニッジロイヤル天文台のみを含む。

パラメータ

site_name応力.応力

天文台名(小書を区別しない)。

返品

site ： EarthLocation (またはサブクラス)インスタンスEarthLocation(またはサブクラス)事例

天文台の位置。返されたクラスはこれと同じになる.

参考

get_site_names

この機能でアクセス可能なサイトリスト

実例.

>>> from astropy.coordinates import EarthLocation
>>> keck = EarthLocation.of_site('Keck Observatory')  
>>> keck.geodetic  
GeodeticLocation(lon=<Longitude -155.47833333 deg>, lat=<Latitude 19.82833333 deg>, height=<Quantity 4160. m>)
>>> keck.info  
name = W. M. Keck Observatory
dtype = void192
unit = m
class = EarthLocation
n_bad = 0
>>> keck.info.meta  
{'source': 'IRAF Observatory Database', 'timezone': 'US/Aleutian'}

to_geocentric()

X、Y、Zの数のタプルに変換します

to_geodetic(ellipsoid=None)

大地座標に変換する。

パラメータ

ellipsoid文字列、オプション

使用するのはスフェロイドを参考にします。デフォルト値は座標を初期化する際に使用する座標である.オプションとして、‘WGS 84’，‘GRS 80’，‘WGS 72’がある.

返品

経度、経度、高度 ： Quantity量

The tuple is a GeodeticLocation namedtuple and is comprised of instances of Longitude, Latitude, and Quantity.

賃上げをする

ValueError

もし ellipsoid 施行された措置の中の一つとは考えられない。

注意事項

大地座標への変換については，ERFAルーチン gc2gd 使っています。Https：//github.com/Liberfa/erfaを参照