インストールする¶

要求する.¶

astropy 以下のような厳しい要求がある。

Python 3.7 あるいは後で
Numpy 1.17 あるいは後で
PyERFA 1.7.3 あるいは後で

astropy オプションの機能はまた、他のソフトウェアパッケージに依存します：

scipy 1.1 またはそれ以上：複数のモジュールの様々な機能に電力を供給する。
h5py: 読み書きをするには、以下の操作を実行してください Table HDF 5ファイルの/からHDF 5ファイルのオブジェクトへ。
BeautifulSoup: 本を読む Table HTML文書中のオブジェクト.
html5lib: 本を読む Table オブジェクトはHTML文書から抽出する. pandas 読者。
bleach: HTML変換が禁止されている場合は、テキストのクリーニングに使用されます Table HTMLライタです。
PyYAML 3.13 あるいはもっと遅い：読む/書く Table オブジェクトは，拡張CSV ASCIIテーブルフォーマットから拡張CSV ASCIIテーブルフォーマットに変換され，様々なフォーマットの混合が直列化される.
xmllint: 投票可能なXML文書を検証するには，以下の操作を実行してください.これはPythonの外部にインストールされたコマンドラインツールです
pandas: 変換するには、以下の操作を実行してください Table パンダDataFrameオブジェクトから/指向オブジェクト.使用するには0.14以上のバージョンが必要ですジャイアントパンダ. 読み書き用I/O機能 Table 物体です。
sortedcontainers もっと早くするために SCEngine インデックスエンジンは Table これは、場合によってはデフォルトインデックスエンジンよりも遅い可能性があるにもかかわらず。
pytz: タイムゾーンを指定してタイムゾーン間で変換するには、以下の操作を実行してください。
jplephem: 太陽系天体を検索するジェット推進実験室天体暦。
matplotlib 3.0 以上：印刷機能を提供する astropy.visualization 強くなりました。
setuptools: チューブを挿入するための入口点を発見するための astropy.modeling.fitting それがそうです。
mpmath: #年の‘Kraft-Burrow-Nousek’区間 poisson_conf_interval それがそうです。
asdf 2.6 またはそれ以上：様々なAstropyクラスを移植可能な階層化された人間可読表現形態にシーケンス化することを可能にする。
bottleneck: σ−クロッピングやその他NaN値を持つ配列に対して統計情報を計算する機能が必要となる可能性が向上した。

しかし、これらの特定の機能が必要な場合にのみ、これらのパッケージをインストールする必要があることに注意されたい。 astropy これらの依存項を実装していなくても導入する.

テストでは、以下のパッケージを使用することを選択することができます。

pytest-astropy: See テストのソースコードバージョン astropy
pytest-xdist: 分散テストに用いられています
pytest-mpl: Matplotlibパターンをテストするために用いた.
objgraph: 参照漏れをテストするためにのみ使用される。
IPython 4.2 or later: Used for testing the notebook interface of Table.
coverage: コードカバー率メトリックに用いられる.
skyfield: 太陽系座標をテストするために使われています
spgp4: 衛星の位置をテストするために使われています
tox: 自動化テストと文書生成に用いた.

インストール中です `astropy`¶

もしあなたがPython初心者である場合、および/または慣れていない場合 Python virtual environments まずインストールを提案します Anaconda Distribution それがそうです。すべてのプラットフォーム(Linux、Mac、Windows)上で実行でき、root権限を必要とすることなく、機能的に整った科学的なPythonをユーザーディレクトリにインストールすることができます。

パイプを使う¶

警告

ニシキヘビPython発行版のユーザーは Condaを使用するそれがそうです。

インストールする astropy with pip 実行：：

pip install astropy

既存の依存項をアップグレードしないことを保証するためには、以下の動作を実行することもできる。

pip install astropy --no-deps

一方，実装するには astropy すべての利用可能なオプションの依存項に加えて、以下の動作を実行することができます。

pip install astropy[all]

ほとんどの場合、これは、前訳バージョン(これを呼ぶ)をインストールする車 )しかし、最新バージョンのPythonを使用している場合、新しいバージョンのAsterpyが発表された場合、または非一般的なプラットフォームのためにAstcopyを構築している場合、Asterpyはソースファイルからインストールされます。なお、この場合、Cコンパイラが必要となる(例えば、 gcc あるいは…。 clang )のインストール(参照) Building from source 以下)実装の成功を確保する.

もしあなたが1つを手に入れたら PermissionError これは、Pythonインストールに新しいパッケージをインストールするために必要な管理アクセス権限がないことを意味します。この場合は、ご利用を考えてみてください --user オプションは、ソフトウェアパッケージをホームディレクトリにインストールします。この操作をどのように実行するかに関するより多くの情報を読むことができます pip documentation それがそうです。

あるいはもしあなたが利用しようとしているなら astropy 付属パッケージのように、インストールを検討してください astropy 1つになる virtualenv それがそうです。

vt.やって、やる not インストールする astropy あるいは他の使用 sudo リスクを完全に意識しない限り

Condaを使用する¶

インストールする astropy Conda Runを使用して：：

conda install astropy

astropy デフォルトの場合、すぐに Anaconda Distribution それがそうです。最新バージョンに更新するには、実行してください。

conda update astropy

新バージョンの astropy 配布されており、Condaに利用可能なパケットがある場合。以下のコマンドを使用して、利用可能なバージョンリストをチェックすることができます conda search astropy それがそうです。

以下のコマンドを使用してオプションのすべての依存アイテムをインストールすることを強くお勧めします。

conda install -c astropy -c defaults \
  scipy h5py beautifulsoup4 html5lib bleach pyyaml pandas sortedcontainers \
  pytz matplotlib setuptools mpmath bottleneck jplephem asdf

テスト(以下参照)とサポートを実行することもできます建築文書. 以下をご利用ください。私たちは pip 最新バージョンと互換性のある最新バージョンを得ることを保証します pytest そして sphinx バージョン：：

pip install pytest-astropy sphinx-astropy

警告

使用しようとする pip アップグレードするインストールは、以下の操作を実行してください astropy それ自体が設置損傷を招く可能性がある。

テストはインストールされています `astropy`¶

インストールされたバージョンをテストする astropy 正しく動作する鍵は使用です Asterpy.test() 機能：：

import astropy
astropy.test()

テストは実行され、どんな障害も印刷されるべきです。 Astropy issue tracker それがそうです。

このテストを実行する方法は機能しないかもしれません astropy 出所が分布している。参照してくださいテストのソースコードバージョン astropy ソースコードディレクトリからテストを実行する方法に関する情報、または運行テスト. もっと細かいことを知っています。

ソースから構築する¶

前提条件.¶

構築するためにはコンパイラキットとPythonの開発ヘッドが必要です astropy それがそうです。他の特定の構築依存項をインストールする必要はありません(例えば Cython あるいは…。 jinja2 )なぜならこれらは pyproject.toml ファイルは，pipにより自動的に一時構築環境に実装される.

Linuxに必要な条件¶

Linuxでは、パケットマネージャを発行するために使用するのは、通常、前提条件を構築することを保証する最も簡単な方法です。 astropy それがそうです。ソースコードから構築するためには、Linuxリリース版のPython開発パッケージおよびpipが必要です。

Debian/Ubuntuについて：

sudo apt-get install python3-dev python3-numpy-dev python3-setuptools cython3 python3-jinja2 python3-pytest-astropy

Fedora/RHELの場合：

sudo yum install python3-devel python3-numpy python3-setuptools python3-Cython python3-jinja2 python3-pytest-astropy

注釈

開発者バージョンを構築した astropy 以上のパッケージの更新バージョンが必要な場合がありますが、発行版リポジトリで提供されているバージョンではありません。そうでしたら、Debianのような発行版を更新してみることができます testing )、または、以下のコマンドを使用して、より多くの最新バージョンのソフトウェアパッケージをインストールする pip あるいは…。 conda 仮想環境では。

Mac OS Xの必須条件¶

MacOS Xでは、以下のコマンドを使用してXCodeコマンドラインツールをインストールする必要があります。

xcode-select --install

画面上の説明に従って必要なコマンドラインツールをインストールします。ご注意ください、確かにそうしています not 完全なXCode発行版をインストールする必要があります(MacOSX 10.9以降を使用しているとします)。

♪the instructions for building NumPy from source Pythonパッケージを構築するための環境を設定する良いリソースです。

ソースパックを取得する¶

ソースパック.¶

最新の安定ソースコードパケット astropy 可 downloaded here それがそうです。

リポジトリを開発する¶

最新の開発バージョンは astropy 以下のコマンドを使用してGitHubからクローンすることができます：

git clone git://github.com/astropy/astropy.git

もしあなたが開発に参加したいなら astropy 会いましょう開発者文書それがそうです。本稿では，実装に必要な基礎知識のみを紹介する astropy それがそうです。

建設と設置¶

構築とインストールのためには、以下の操作を実行してください astropy (源木の根から)：：

pip install .

このようにコードをインストールして変更する場合には、変更を反映するためにInstallコマンドを再実行する必要があります。あるいは、あなたは使用することができます：

pip install -e .

どれが設置されていますか astropy 開発/編集可能モードでは、これは、コード内の変更がインストールされたバージョンに直ちに反映されることを意味します。

故障排除¶

エラーが発生した場合、正しいインストール権限がないことを示唆します astropy デフォルト設定に設定 site-packages ディレクトリは、以下のコマンドを使用してインストールを試みることができます。

pip install . --user

これは、ホームディレクトリのデフォルトディレクトリにインストールされます。

外部Cライブラリ¶

♪the astropy ソースコードには多くのライブラリのCソースコードが付加されている.デフォルトでは、これらの内部コピーは生成のために使用される astropy それがそうです。しかし、ライブラリのうちの1つを使用してシステム範囲をインストールしたい場合には、モードを使用して環境変数を設定することができます。 ASTROPY_USE_SYSTEM_??? 至る 1 ソフトウェアパッケージを構築/インストールする際に.

例えば、構築するためには astropy システムを使用したEXPATパーサライブラリ，使用：

ASTROPY_USE_SYSTEM_EXPAT=1 pip install -e .

すべてのシステムライブラリを用いて構築するためには、使用してください。

ASTROPY_USE_SYSTEM_ALL=1 pip install -e .

現在は束ねられたCライブラリと astropy 内容：

wcslib 見 cextern/wcslib/README 結束版に使われていますシステムバージョンをご利用の場合は、設定してください ASTROPY_USE_SYSTEM_WCSLIB=1 それがそうです。
cfitsio 見 cextern/cfitsio/changes.txt 結束版に使われていますシステムバージョンをご利用の場合は、設定してください ASTROPY_USE_SYSTEM_CFITSIO=1 それがそうです。
expat 見 cextern/expat/README 結束版に使われていますシステムバージョンをご利用の場合は、設定してください ASTROPY_USE_SYSTEM_EXPAT=1 それがそうです。

インストール中です `astropy` CASAに入る¶

ご希望でしたらご利用いただけます astropy 中に入って CASA 最も簡単な方法は，CASA内部からこの操作を実行することである.

まず私たちは pip インストールされています。CASAを正常に起動し、入力：

CASA <2>: from setuptools.command import easy_install

CASA <3>: easy_install.main(['--user', 'pip'])

いま，CASAを脱退して再開し，以下のコマンドを入力して実装する. astropy **

CASA <2>: import subprocess, sys

CASA <3>: subprocess.check_call([sys.executable, '-m', 'pip', 'install', '--user', 'astropy'])

そして再びCASAを閉じて開けて、導入することができるはずです astropy **

CASA <2>: import astropy

どんなものでも astropy 付属パッケージ(例えば、同じ方法でインストールすることができる) spectral-cube 電波天文学に役立つかもしれない他のソフトウェアパッケージ)もあります

注釈

以上の説明はすべてのシステムでテストされていない.私たちはいくつかの例が確かに有効だということを知っているが、これがすべてのシステムで有効であることを保証することはできない。もしあなたがインストールすれば astropy CASAに関する問題が発生し始めましたので、ご確認ください known CASA issues もしあなたがそこであなたの問題に遭遇しなかったら、新しいのを発表してください。

建築文書.¶

注釈

Astropyドキュメントの最新(およびアーカイブ)バージョンは、Astropyドキュメントの最新(およびアーカイブ)バージョンが位置する必要があるので、新しいドキュメントを作成しているか、またはインターネットにアクセスできない限り、一般にドキュメントを構築する必要はあり docs.astropy.org それがそうです。

依存性.¶

文書を構築するためには astropy ソースコードといくつかの追加パッケージ。文書を構築する最も簡単な方法は tox 中で述べたとおり家を建てる. それがそうです。もしあなたがそうすることを望むなら、あなたはこの部分の残りの部分をスキップすることができる。

一方、Sphinxを手動で呼び出して文書を構築したい場合には、多くの依存項がインストールされていることを確保する必要があります。Condaを用いれば，依存項を実装する最も簡単な方法は：

conda install -c astropy sphinx-astropy

Condaがない場合は、指定することで [docs] インストール時 astropy Pipを使用して：：

pip install -e '.[docs]'

インストールもお選びいただけます sphinx-astropy Pip：：を含むバッグ

pip install sphinx-astropy

Astropy生態系におけるソフトウェアパッケージの汎用構成を提供することに加えて、このソフトウェアパッケージは、主な依存項を自動的に取得する1つの方法として使用することができる。

Sphinx -文書のメインパッケージを構築するために使用されます
astropy-sphinx-theme -使用されているデフォルトの‘bootstrap’トピック astropy いくつかの付属パッケージがあります
sphinx-automodapi -APIドキュメントの自動生成が容易な拡張
sphinx-gallery -インスタンスライブラリを生成するための拡張
numpydoc -NumPyDoc形式の文書文字列を解析するための拡張
pillow -一例で使用
Graphviz -継承マップの生成(condaパケットまたはシステムインストールの形態で提供されていますが、pipでは提供されていません)

注釈

この二人とも pip 上記のインストール方法は含まれていません Graphviz それがそうです。ソフトウェアパッケージを個別にインストールしない場合、文書構築プロセスは、大量の冗長な警告(これは、真の警告を隠蔽する可能性がある)を生成し、継承マップも生成しない。

家を建てる.¶

Astropy文書を構築できる2つの方法がある.最も簡単な方法は，以下のtoxコマンドを実行することである(から astropy ソースディレクトリ)：：

tox -e build_docs

そうすれば、これが自動的に完了するので、文書依存項をインストールする必要はありません。文書が構築されるのは docs/_build/html ディレクトリは、Webブラウザを指すことで docs/_build/html/index.html それがそうです。

あるいは、以下の動作を実行することができます。

cd docs
make html

文書は同じ位置で生成される.インストールされているAsterpyバージョンを使用しているので、現在のリポジトリバージョンの使用を確保したい場合には、以下のコマンドを使用してインストールする必要があります。

pip install -e .[docs]

もっと変更する docs カタログです。

第2の方法では、以下のコマンドを使用してLaTeX文書を生成することができる：

make latex

LaTeXファイル Astropy.tex あるだろう docs/_build/latex カタログ、そして使用可能 pdflatex それがそうです。

報告問題·要求機能¶

上述したように、構築文書は、多くのSphinx拡張および他のパケットに依存する。どのパッケージが問題になったのか、あるいは新しい機能を実現する必要があるかをいつも知っているわけではありませんので、 core astropy package issue tracker それがそうです。しかし、もしよろしければ、いくつかの依存項目の問題をリポジトリに開くこともできます。

文書の外観に関する要求/問題(例えば、CSS関連)については、 astropy-sphinx-theme issue tracker それがそうです。
自動生成されたAPI文書に関する要求/問題(特定の文書文字列の問題ではなく、一般的な問題のように見える)については、ご利用いただけます sphinx-automodapi issue tracker それがそうです。
デフォルト構成に関連する問題(例えば、デフォルトでどのような拡張を有効にするか)については、使用することができます。 sphinx-astropy issue tracker それがそうです。

テストのソースコードバージョン `astropy`¶

ソースコードの書き出しでテストを実行する最も簡単な方法は astropy 使用することです tox **

tox -e test-alldeps

他にも選択肢があります運行テスト. もしあなたがテスト過程をもっとよくコントロールしたいなら。

ナビゲーション