get_pkg_data_filename

astropy.utils.data.get_pkg_data_filename(data_name, package=None, show_progress=True, remote_timeout=None)

パケットの標準位置からデータファイルを検索し、データのローカルファイル名を提供する。

この関数は get_pkg_data_fileobj しかしこのファイルに戻ります name 読み取り可能な類似ファイルのオブジェクトではありませんこれは，この関数がつねにリモートファイルをローカルにキャッシュしなければならないことを意味する. get_pkg_data_fileobj それがそうです。

パラメータ

data_name応力.応力

必要なデータファイルの名前/場所。以下の選択肢の1つ：

• ソース配信に含まれるデータファイルの名前。このパスは，この関数を呼び出すモジュールに対して.例えば、もし astropy.pkname 使用 'data/file.dat' 書類を入れる astropy/pkgname/data/file.dat それがそうです。2点はレベルを上げるために使うことができます。同じ例では '../data/file.dat' 得る astropy/data/file.dat それがそうです。

• マッチするローカルファイルが存在しない場合は，Astropyデータサーバにそのファイルを問い合わせる.

• このようなハッシュは compute_hash プレフィックスは、‘hash/34 c 33 b 3 b 0 d 56 eb9462003 af 249 effer 28’のような‘hash/’であることを要求することができる。まずローカルでハッシュを検索し，見つからなければAstropyデータサーバに問い合わせる.

package文字列、オプション

指定された場合、呼び出しモジュールに対するデフォルトのパケットルックアップではなく、所与のパケットに対するファイルが検索される。

show_progressブル値、オプション

ファイルがリモートサーバからダウンロードされた場合、プログレスバーが表示されるか否か。デフォルト値は True それがそうです。

remote_timeout浮いている.

要求のタイムアウト時間(秒単位)(デフォルトで配置可能であるとする. astropy.utils.data.Conf.remote_timeout ）。

返品

filename応力.応力

ローカルファイルシステム上で要求されたデータに対応するファイルパス data_name それがそうです。

賃上げをする

urllib.error.URLError

もしリモートファイルが見つからなかったら。

OSError

ローカルファイルの書き込みや読み出し時に問題が発生する.

参考

get_pkg_data_contents

ファイルまたはurlの内容をバイトオブジェクトの形で返す.

get_pkg_data_fileobj

データを含む類似ファイルのオブジェクトを返す

実例.

これは検索します astropy.wcs テスト：

>>> from astropy.utils.data import get_pkg_data_filename
>>> fn = get_pkg_data_filename('data/3d_cd.hdr',
...                            package='astropy.wcs.tests')
>>> with open(fn) as f:
...     fcontents = f.read()
...

これは、ローカルまたはAstpyデータサーバからハッシュを介してデータファイルを検索する：

>>> from astropy.utils.data import get_pkg_data_filename
>>> fn = get_pkg_data_filename('hash/34c33b3eb0d56eb9462003af249eff28')  
>>> with open(fn) as f:
...     fcontents = f.read()
...