時計

BinTableHDU

class astropy.io.fits.BinTableHDU(data=None, header=None, name=None, uint=False, ver=None, character_as_bytes=False)[ソース]

ベースクラス: astropy.io.fits.hdu.table._TableBaseHDU

バイナリ表HDUクラス。

パラメータ
data 配列：配列 FITS_rec あるいは、あるいは Table配列しています

使用するデータです。

タイトル ： Headerタイトル

使用するヘッダです。

name応力.応力

充填する名前 EXTNAME キーワード。

uintブル値、オプション

とする. True 表が符号なし整数列を含む場合。

verInt>0またはなし、オプション

HDUのバージョンはキーワードの値になります EXTVER それがそうです。指定されていないかない場合は，デフォルトで考える. EXTVER 名刺1枚. header または1。(デフォルト値：なし)

character_as_bytesブルル.

文字列のバイトを返すかどうか。デフォルトではこれは False AND(Unicode)文字列を返すが，これはメモリマッピングを考慮せず，アクセス時に列全体をメモリにロードする.

add_checksum(when=None, override_datasum=False, checksum_keyword='CHECKSUM', datasum_keyword='DATASUM')

追加 CHECKSUM そして DATASUM 値は、HDUとデータ計算のチェックサムのカードからこのHDUにそれぞれ設定される。追加した DATASUM カードはカバーされるかもしれません。

パラメータ
when文字列、オプション

カードの注釈文字列；デフォルトの場合，アノテーションはチェックサムを計算する時間を表す.

override_datasumブル値、オプション

追加する CHECKSUM カードのみ

checksum_keyword文字列、オプション

チェックサム値を格納するためのHEADERキーワードの名前；約束によりこれは通常“CHECKSUM”であるが，異なるキーワードを用いる場合もある.

datasum_keyword文字列、オプション

見 checksum_keyword

注意事項

テストの目的で、まず呼び出します add_datasum 1つを使う when パラメータ、そして呼び出します add_checksum 1つを使う when 論証と override_datasum とする. True それがそうです。これは2枚のカードに一致した注釈を提供し、生成を許可することができます CHECKSUM 一致価値のあるカード。

add_datasum(when=None, datasum_keyword='DATASUM')

追加 DATASUM カードは、このHDUに入力され、データ計算のチェックサムとして値が設定される。

パラメータ
when文字列、オプション

カードの注釈文字列は，デフォルトでチェックサムを計算する時間を表す.

datasum_keyword文字列、オプション

データ値を格納するためのHeaderキーワードの名前；約束により，その名前は通常‘DATASUM’であるが，異なるキーワードを使用すべき用例が存在する.

返品
checksum集積する.

算出されたデータ量

注意事項

テストの目的で、ご提供ください when パラメータはカード中のアノテーション値が一致するようにする.これは生成を可能にします CHECKSUM 一致価値のあるカード。

property columns

♪the ColDefs オブジェクト，これらのオブジェクトはこの表中の列を記述する.

copy()

コピー表HDUは、タイトルとデータがコピーされます。

dump(datafile=None, cdfile=None, hfile=None, overwrite=False)[ソース]

表HDUをASCII形式のファイルに転送します。このテーブルは、3つの別個のファイルに転送することができ、1つは列定義を含み、1つはタイトルパラメータを含み、他方はテーブルデータのために使用される。

パラメータ
datafile類似パスまたは類似ファイル、オプション

データファイルを出力する。デフォルト値は，このHDUに関連するFITSファイルのルート名であり，拡張子を付加する. .txt それがそうです。

cdfile類似パスまたは類似ファイル、オプション

列定義ファイルを出力する.黙認する. None したがって，列定義出力は生成されない.

hfile類似パスまたは類似ファイル、オプション

ヘッダパラメータファイルを出力します。黙認する. None ヘッダパラメータ出力は生成されない.

overwriteブル値、オプション

もし True もしあれば、出力ファイルを上書きします(存在すれば)。1つの問題を引き起こしました OSError もし False また，出力ファイルが存在する.デフォルト値は False それがそうです。

バージョン 1.3 で変更: overwrite 時代遅れのものに取って代わる clobber 論争する。

注意事項

主な用途は dump 方法は、標準テキストエディタでテーブルデータおよびパラメータを表示および編集することを可能にします。♪the load 方法は、3つのプレーンテキスト(ASCII)ファイルから新しいテーブルを作成するために使用することができる。

  • データファイル： データファイルの各行は1行のテーブルデータを表す.データは列順に1列ずつ出力される.列が配列を含む場合、次の列に移動する前に、現在の行の列配列の各要素が出力される。行ごとに一行で終わります。

    整数データは21文字のフィールドで右に整列して出力され，空白の後に続く.浮動小数点データは21文字のフィールドに‘g’形式で右アライメント出力され，精度は15ビットであり，1つのスペースが続く.スペースを含まない文字列データの幅と TFORM 列のHeaderパラメータは，直後に空白となる.文字列データにスペース文字が含まれている場合は，文字列は引用符で導かれる ("" )である。行の最後のデータ要素の場合、フィールドの末尾のスペースは改行によって置換されます。

    可変長配列(‘P’フォーマット)を含む列データに対して，配列データの前に文字列がある 'VLA_Length= ' およびその行配列の整数長は，21文字のフィールドに左に整列し，スペースを後にする.

    注釈

    このフォーマットはサポートされています not 曖昧性を克服することは困難であるため，(‘q’フォーマット)を用いた可変長配列をサポートする.これは、ファイルフォーマットが、サイズが2 GBを超えるファイルに格納されているテーブルのVLA列をサポートしていないことを意味する。

    ビットフィールド(‘X’フォーマット)を表す列データの場合、フィールド内の各ビット値は、21文字のフィールドにおいて右整列出力が1(真を表す)または0(偽を表す)である。

  • Cdfile： 列定義ファイルの行ごとに表中のある列の定義を提供する.この行は、8個の16文字のフィールドに分割される。最初のフィールドは列名を提供する (TTYPEn )である。第2のフィールドは、列フォーマットを提供する (TFORMn )である。第3のフィールドは、表示フォーマットを提供する (TDISPn )である。第4のフィールドは物理単位を提供する (TUNITn )である。5つ目のフィールドは、多次元配列の次元を提供する (TDIMn )である。6つ目のフィールドは、未定義値を表す値を提供する (TNULLn )である。7番目のフィールドはスケーリング係数を提供します (TSCALn )である。8番目のフィールドはオフセット値を提供する (TZEROn )である。フィールド値 "" 値が与えられていない場合を表すために用いられる.

  • Hfile： ヘッダパラメータファイルの各行は、カード画像によって表される単一のHDUヘッダカードの定義を提供する。

filebytes()

このHDUがファイルに書き込まれるバイト数を計算して返す.

fileinfo()

辞書に戻り、任意の関連ファイルにおけるこのHDUの位置情報を詳細に示す。これらの値は，関連ファイルを読み出したり書き込みしたりした後にのみ有効である. HDUList それがそうです。

返品
DICTやNONE

辞書は、関連ファイルにおけるHDUの位置に関する情報を詳細に示す。返品 None HDUがファイルに関連付けられていない場合。

辞書内容：

キー、キー

価値がある

ファイル.ファイル

HDUに関連するファイル·オブジェクト

ファイルパターン.

ファイルのモードを開く(読み出しのみ、コピー、更新、付加、OSTREAM)

HdrLoc

ファイル中のヘッダの開始バイト位置

データ位置

ファイル中のデータブロックの開始バイト位置

データスパン.

充填を含むデータサイズ
classmethod from_columns(columns, header=None, nrows=0, fill=False, character_as_bytes=False, **kwargs)

もし1つ与えたら ColDefs 対象は、 Column オブジェクト、または別のテーブルHDUまたはテーブルデータ(a FITS_rec あるいは複数のフィールド numpy.ndarray あるいは…。 numpy.recarray オブジェクトは，入力中の列定義を用いて，そのメソッドを呼び出すクラスを返す新しい表HDUを定義する.

また見られる. FITS_rec.from_columns それがそうです。

パラメータ
columns序列.序列.

表データの列を作成するためのオブジェクト、または列構造を有するオブジェクト ColDefs インスタンス化することができる。これには既存の BinTableHDU あるいは…。 TableHDU あるいは1つ numpy.recarray いくつか例を挙げましょう

これらの列にデータ配列が追加されている場合、データは、新しいテーブルを初期化するために使用されてもよい。そうでなければ、入力列は、要求行数を有する新しいテーブルのテンプレートとして使用される。

タイトル ： Headerタイトル

オプションの Header 対象は新しいHDUをインスタンス化する.定義表構造に特に関連するタイトルキーワード(“TXXXn”キーワード、例えばTTYPEn)は、提供される列定義によって上書きされるが、他のすべての情報的キーワードおよびデータモデル固有のキーワードは保持される。

nrows集積する.

新しい表の行数。入力列にそれに関連するデータがあれば，最大入力列の大きさを用いる.そうでなければ，デフォルト値は0となる.

fillブルル.

もし True すべてのセルはゼロまたは空白で充填されます。もし…。 False 入力からデータをコピーすると，未定義のセルはゼロ/空白で満たされる.

character_as_bytesブルル.

HDUからのアクセス時に文字列のバイトを返すかどうか。デフォルトではこれは False AND(Unicode)文字列を返すが，大型表に対しては大量のメモリを占有する可能性がある.

注意事項

HDUクラスが受け取る他のキーワードパラメータ __init__ キーワードパラメータとして入力することも可能である.

classmethod fromstring(data, checksum=False, ignore_missing_end=False, **kwargs)

適切なタイプの新しいHDUオブジェクトは、HDUのヘッダ全体およびオプションでそのデータを含む文字列から作成される。

なお、バックアップファイルオブジェクトがない文字列から新しいHDUを作成する場合、そのHDUのデータは読み出し専用である可能性がある。これは、下位文字列が不変のPython文字列/バイトオブジェクトであるか、または何らかの読み書きメモリバッファであるかに依存する(例えば、 memoryview それがそうです。

パラメータ
data文字列、バイト配列、メモリビュー、ndarray

HDUヘッダとデータを含むバイト文字列。

checksumブル値、オプション

HDUのチェックサムおよび/またはデータを検査する。

ignore_missing_endブル値、オプション

タイトルデータに欠落しているエンドカードは無視される。エンドカードがない場合、ヘッダの末尾が明確でなく、HDUが破損する可能性があることに注意してください。この場合、有効なFITSヘッダデータで開始されない最初の2880ブロックがデータの開始であると仮定する。

kwargs任意選択.

May consist of additional keyword arguments specific to an HDU type--these correspond to keywords recognized by the constructors of different HDU classes such as PrimaryHDU, ImageHDU, or BinTableHDU. Any unrecognized keyword arguments are simply ignored.

classmethod load(datafile, cdfile=None, hfile=None, replace=False, header=None)[ソース]

入力されたASCIIファイルから表を作成する.入力は最大3つの個々のファイルからのものであり、1つは列定義を含み、1つはタイトルパラメータを含み、他方は列データを含む。

列定義とタイトルパラメータファイルは必要ではない.列定義および/またはHeaderパラメータがない場合、Headerパラメータから与えられたHeaderオブジェクトから列定義および/またはHeaderパラメータが取得され、そうでなければ、合理的なデフォルト値が推定される(このモードの使用は推奨されないが)。

パラメータ
datafile類似パスや類似ファイル

ASCIIフォームデータを含む入力データファイル.

cdfile類似パスまたは類似ファイル、オプション

テーブルの列に関連付けられた名前、フォーマット、表示フォーマット、物理単位、多次元配列次元、未定義値、スケーリング係数、およびオフセットを含む入力列定義ファイル。もし…。 None すると，列定義はそのオブジェクト中の現在値をとる.

hfile類似パスまたは類似ファイル、オプション

表に関連付けるタイトルパラメータ定義を含む入力パラメータ定義ファイル.もし…。 None この場合、タイトルパラメータは、そのオブジェクトタイトルから取得された現在値を定義する。

replaceブル値、オプション

いつ？ True ヘッダ全体が現在のヘッダのみを更新するのではなく、ASCIIファイルの内容に置き換えられるべきであることを示す。

タイトル ： Header オプションです。ヘッダ、オプション

Cdfileおよびhfileが失われた場合、このHeaderオブジェクトは、新しいテーブルおよびHDUを作成する際に使用される。そうでなければ、このヘッダは、hfile中のキーワードの代わりになり、hfileは、このヘッダに存在しない値を更新するためにのみ使用される。 replace=True ここで、ヘッダファイルの値は、完全にhfileの値に置き換えられる。

注意事項

主な用途は load 方法は，標準テキストエディタで編集されたASCIIデータの表データとパラメータの入力を許可する.♪the dump 方法は、初期ASCIIファイルを作成するために使用することができます。

  • データファイル： データファイルの各行は1行のテーブルデータを表す.データは列順に1列ずつ出力される.列が配列を含む場合、次の列に移動する前に、現在の行の列配列の各要素が出力される。行ごとに一行で終わります。

    整数データは21文字のフィールドで右に整列して出力され，空白の後に続く.浮動小数点データは21文字のフィールドに‘g’形式で右アライメント出力され，精度は15ビットであり，1つのスペースが続く.スペースを含まない文字列データの幅と TFORM 列のHeaderパラメータは，直後に空白となる.文字列データにスペース文字が含まれている場合は，文字列は引用符で導かれる ("" )である。行の最後のデータ要素の場合、フィールドの末尾のスペースは改行によって置換されます。

    可変長配列(‘P’フォーマット)を含む列データに対して，配列データの前に文字列がある 'VLA_Length= ' およびその行配列の整数長は，21文字のフィールドに左に整列し，スペースを後にする.

    注釈

    このフォーマットはサポートされています not 曖昧性を克服することは困難であるため，(‘q’フォーマット)を用いた可変長配列をサポートする.これは、ファイルフォーマットが、サイズが2 GBを超えるファイルに格納されているテーブルのVLA列をサポートしていないことを意味する。

    ビットフィールド(‘X’フォーマット)を表す列データの場合、フィールド内の各ビット値は、21文字のフィールドにおいて右整列出力が1(真を表す)または0(偽を表す)である。

  • Cdfile： 列定義ファイルの行ごとに表中のある列の定義を提供する.この行は、8個の16文字のフィールドに分割される。最初のフィールドは列名を提供する (TTYPEn )である。第2のフィールドは、列フォーマットを提供する (TFORMn )である。第3のフィールドは、表示フォーマットを提供する (TDISPn )である。第4のフィールドは物理単位を提供する (TUNITn )である。5つ目のフィールドは、多次元配列の次元を提供する (TDIMn )である。6つ目のフィールドは、未定義値を表す値を提供する (TNULLn )である。7番目のフィールドはスケーリング係数を提供します (TSCALn )である。8番目のフィールドはオフセット値を提供する (TZEROn )である。フィールド値 "" 値が与えられていない場合を表すために用いられる.

  • Hfile： ヘッダパラメータファイルの各行は、カード画像によって表される単一のHDUヘッダカードの定義を提供する。

classmethod match_header(header)[ソース]

これは，ASCIIとバイナリテーブルHDUタイプの共有機能を実現した抽象タイプであり，その代わりにこの2つのタイプを用いるべきである.

classmethod readfrom(fileobj, checksum=False, ignore_missing_end=False, **kwargs)

ファイルからHDUを読み込む。一般に、HDUは、以下のコマンドを使用して開くべきです。 open() FITSファイルのHDUリスト全体を読み込みます。しかしこの方法は対称性のために提供されています writeto() それがそうです。

パラメータ
fileobj書類状.

適合ファイルを入力します。ファイルのルックアップポインタはHDUの先頭にあると仮定する.

checksumブルル.

もし True この2つを検証します DATASUM そして CHECKSUM カード値(HDUヘッダに存在する場合)は、ファイル内のすべてのHDUのヘッダおよびデータと一致する。

ignore_missing_endブルル.

開いて欠けている END 最後のタイトルのカードです

req_cards(keyword, pos, test, fix_value, option, errlist)

検査に必要な Card それがそうです。

パラメータ
keyword応力.応力

検証するキーワード

pos全体的に、呼び出すことができます

もし1つが int タイトル内のカードの正確な位置を指定します。Pythonはゼロインデックスだということを覚えておいてください pos=0 要求カードはタイトルの最初のカードである.Callableが与えられたら、キーワードの実際の位置であるパラメータを受け入れて返すべきです。 True あるいは…。 False それがそうです。これはカスタム評価に使用することができる。例えばもし pos=lambda idx: idx > 10 これは、キーワードのインデックスが10より大きいかどうかをチェックするだろう。

test呼び戻すことができる

これは、所与のキーワードの値に渡され、返される呼び出し可能なもの(通常は関数)であるべきである。 True あるいは…。 False それがそうです。これは、所与のキーワードに関連する値を検証するために使用されてもよい。

fix_value文字列、整型、浮動小数点型、複合型、ブール型、無

Fitsキーワードが使用する有効値(与えられた場合) test 無効値を置き換えることはできません。言い換えれば、キーワードの現在値が無効である場合、これは代替としてデフォルト値を提供する。もし…。 None 代替値がなければ，キーワードは修復できない.

option応力.応力

Output verification option. Must be one of "fix", "silentfix", "ignore", "warn", or "exception". May also be any combination of "fix" or "silentfix" with "+ignore", +warn, or +exception" (e.g. ``"fix+warn"). See 検証オプション for more info.

errlistリスト.リスト

FITSファイルで発見された検証エラーリスト；これは、主に検証システムが複数のHDUにわたるエラーおよびペアを収集するために使用される req_cards それがそうです。

注意事項

もし pos=None カードは、タイトル内の任意の位置に存在することができる。カードが存在しない場合、新しいカードは fix_value その作成時の価値として。まだ使えます test 論争する。

run_option(option='warn', err_text='', fix_text='Fixed.', fix=None, fixable=True)

選択されたオプションを用いて検証を実行します。

property size

HDUデータ部分のサイズ(バイト)。

update()

列の最新の変更を反映するようにタイトルキーワードを更新します。

verify(option='warn')

事例中のすべての値を検証する.

パラメータ
option応力.応力

Output verification option. Must be one of "fix", "silentfix", "ignore", "warn", or "exception". May also be any combination of "fix" or "silentfix" with "+ignore", "+warn", or "+exception" (e.g. "fix+warn"). See 検証オプション for more info.

verify_checksum()

検証 CHECKSUM キーワードは、現在のHDUチェックサムについて計算された値に一致する。

返品
valid集積する.

  • 0-障害

  • 1-成功

  • 2-いいえ CHECKSUM キーワードが存在する

verify_datasum()

検証 DATASUM キーワードと為 DATASUM 現在のHDUデータの。

返品
valid集積する.

  • 0-障害

  • 1-成功

  • 2-いいえ DATASUM キーワードが存在する

writeto(name, output_verify='exception', overwrite=False, checksum=False)

その動作方式は通常のWriteto()と類似しているが、デフォルト値が予め設定されている PrimaryHDU HDUを拡張するために必要なものです(拡張HDUは独立して動作できません)。

バージョン 1.3 で変更: overwrite 時代遅れのものに取って代わる clobber 論争する。

TableHDU

class astropy.io.fits.TableHDU(data=None, header=None, name=None, ver=None, character_as_bytes=False)[ソース]

ベースクラス: astropy.io.fits.hdu.table._TableBaseHDU

ASCII表拡張HDUクラスに適している。

パラメータ
data ：配列または FITS_rec配列や

使用するデータです。

タイトル ： Headerタイトル

使用するヘッダです。

name応力.応力

充填する名前 EXTNAME キーワード。

verInt>0またはなし、オプション

HDUのバージョンはキーワードの値になります EXTVER それがそうです。指定されていないかない場合は，デフォルトで考える. EXTVER 名刺1枚. header または1。(デフォルト値：なし)

character_as_bytesブルル.

文字列のバイトを返すかどうか。デフォルトではこれは False AND(Unicode)文字列を返すが，これはメモリマッピングを考慮せず，アクセス時に列全体をメモリにロードする.

add_checksum(when=None, override_datasum=False, checksum_keyword='CHECKSUM', datasum_keyword='DATASUM')

追加 CHECKSUM そして DATASUM 値は、HDUとデータ計算のチェックサムのカードからこのHDUにそれぞれ設定される。追加した DATASUM カードはカバーされるかもしれません。

パラメータ
when文字列、オプション

カードの注釈文字列；デフォルトの場合，アノテーションはチェックサムを計算する時間を表す.

override_datasumブル値、オプション

追加する CHECKSUM カードのみ

checksum_keyword文字列、オプション

チェックサム値を格納するためのHEADERキーワードの名前；約束によりこれは通常“CHECKSUM”であるが，異なるキーワードを用いる場合もある.

datasum_keyword文字列、オプション

見 checksum_keyword

注意事項

テストの目的で、まず呼び出します add_datasum 1つを使う when パラメータ、そして呼び出します add_checksum 1つを使う when 論証と override_datasum とする. True それがそうです。これは2枚のカードに一致した注釈を提供し、生成を許可することができます CHECKSUM 一致価値のあるカード。

add_datasum(when=None, datasum_keyword='DATASUM')

追加 DATASUM カードは、このHDUに入力され、データ計算のチェックサムとして値が設定される。

パラメータ
when文字列、オプション

カードの注釈文字列は，デフォルトでチェックサムを計算する時間を表す.

datasum_keyword文字列、オプション

データ値を格納するためのHeaderキーワードの名前；約束により，その名前は通常‘DATASUM’であるが，異なるキーワードを使用すべき用例が存在する.

返品
checksum集積する.

算出されたデータ量

注意事項

テストの目的で、ご提供ください when パラメータはカード中のアノテーション値が一致するようにする.これは生成を可能にします CHECKSUM 一致価値のあるカード。

property columns

♪the ColDefs オブジェクト，これらのオブジェクトはこの表中の列を記述する.

copy()

コピー表HDUは、タイトルとデータがコピーされます。

filebytes()

このHDUがファイルに書き込まれるバイト数を計算して返す.

fileinfo()

辞書に戻り、任意の関連ファイルにおけるこのHDUの位置情報を詳細に示す。これらの値は，関連ファイルを読み出したり書き込みしたりした後にのみ有効である. HDUList それがそうです。

返品
DICTやNONE

辞書は、関連ファイルにおけるHDUの位置に関する情報を詳細に示す。返品 None HDUがファイルに関連付けられていない場合。

辞書内容：

キー、キー

価値がある

ファイル.ファイル

HDUに関連するファイル·オブジェクト

ファイルパターン.

ファイルのモードを開く(読み出しのみ、コピー、更新、付加、OSTREAM)

HdrLoc

ファイル中のヘッダの開始バイト位置

データ位置

ファイル中のデータブロックの開始バイト位置

データスパン.

充填を含むデータサイズ
classmethod from_columns(columns, header=None, nrows=0, fill=False, character_as_bytes=False, **kwargs)

もし1つ与えたら ColDefs 対象は、 Column オブジェクト、または別のテーブルHDUまたはテーブルデータ(a FITS_rec あるいは複数のフィールド numpy.ndarray あるいは…。 numpy.recarray オブジェクトは，入力中の列定義を用いて，そのメソッドを呼び出すクラスを返す新しい表HDUを定義する.

また見られる. FITS_rec.from_columns それがそうです。

パラメータ
columns序列.序列.

表データの列を作成するためのオブジェクト、または列構造を有するオブジェクト ColDefs インスタンス化することができる。これには既存の BinTableHDU あるいは…。 TableHDU あるいは1つ numpy.recarray いくつか例を挙げましょう

これらの列にデータ配列が追加されている場合、データは、新しいテーブルを初期化するために使用されてもよい。そうでなければ、入力列は、要求行数を有する新しいテーブルのテンプレートとして使用される。

タイトル ： Headerタイトル

オプションの Header 対象は新しいHDUをインスタンス化する.定義表構造に特に関連するタイトルキーワード(“TXXXn”キーワード、例えばTTYPEn)は、提供される列定義によって上書きされるが、他のすべての情報的キーワードおよびデータモデル固有のキーワードは保持される。

nrows集積する.

新しい表の行数。入力列にそれに関連するデータがあれば，最大入力列の大きさを用いる.そうでなければ，デフォルト値は0となる.

fillブルル.

もし True すべてのセルはゼロまたは空白で充填されます。もし…。 False 入力からデータをコピーすると，未定義のセルはゼロ/空白で満たされる.

character_as_bytesブルル.

HDUからのアクセス時に文字列のバイトを返すかどうか。デフォルトではこれは False AND(Unicode)文字列を返すが，大型表に対しては大量のメモリを占有する可能性がある.

注意事項

HDUクラスが受け取る他のキーワードパラメータ __init__ キーワードパラメータとして入力することも可能である.

classmethod fromstring(data, checksum=False, ignore_missing_end=False, **kwargs)

適切なタイプの新しいHDUオブジェクトは、HDUのヘッダ全体およびオプションでそのデータを含む文字列から作成される。

なお、バックアップファイルオブジェクトがない文字列から新しいHDUを作成する場合、そのHDUのデータは読み出し専用である可能性がある。これは、下位文字列が不変のPython文字列/バイトオブジェクトであるか、または何らかの読み書きメモリバッファであるかに依存する(例えば、 memoryview それがそうです。

パラメータ
data文字列、バイト配列、メモリビュー、ndarray

HDUヘッダとデータを含むバイト文字列。

checksumブル値、オプション

HDUのチェックサムおよび/またはデータを検査する。

ignore_missing_endブル値、オプション

タイトルデータに欠落しているエンドカードは無視される。エンドカードがない場合、ヘッダの末尾が明確でなく、HDUが破損する可能性があることに注意してください。この場合、有効なFITSヘッダデータで開始されない最初の2880ブロックがデータの開始であると仮定する。

kwargs任意選択.

May consist of additional keyword arguments specific to an HDU type--these correspond to keywords recognized by the constructors of different HDU classes such as PrimaryHDU, ImageHDU, or BinTableHDU. Any unrecognized keyword arguments are simply ignored.

classmethod match_header(header)[ソース]

これは，ASCIIとバイナリテーブルHDUタイプの共有機能を実現した抽象タイプであり，その代わりにこの2つのタイプを用いるべきである.

classmethod readfrom(fileobj, checksum=False, ignore_missing_end=False, **kwargs)

ファイルからHDUを読み込む。一般に、HDUは、以下のコマンドを使用して開くべきです。 open() FITSファイルのHDUリスト全体を読み込みます。しかしこの方法は対称性のために提供されています writeto() それがそうです。

パラメータ
fileobj書類状.

適合ファイルを入力します。ファイルのルックアップポインタはHDUの先頭にあると仮定する.

checksumブルル.

もし True この2つを検証します DATASUM そして CHECKSUM カード値(HDUヘッダに存在する場合)は、ファイル内のすべてのHDUのヘッダおよびデータと一致する。

ignore_missing_endブルル.

開いて欠けている END 最後のタイトルのカードです

req_cards(keyword, pos, test, fix_value, option, errlist)

検査に必要な Card それがそうです。

パラメータ
keyword応力.応力

検証するキーワード

pos全体的に、呼び出すことができます

もし1つが int タイトル内のカードの正確な位置を指定します。Pythonはゼロインデックスだということを覚えておいてください pos=0 要求カードはタイトルの最初のカードである.Callableが与えられたら、キーワードの実際の位置であるパラメータを受け入れて返すべきです。 True あるいは…。 False それがそうです。これはカスタム評価に使用することができる。例えばもし pos=lambda idx: idx > 10 これは、キーワードのインデックスが10より大きいかどうかをチェックするだろう。

test呼び戻すことができる

これは、所与のキーワードの値に渡され、返される呼び出し可能なもの(通常は関数)であるべきである。 True あるいは…。 False それがそうです。これは、所与のキーワードに関連する値を検証するために使用されてもよい。

fix_value文字列、整型、浮動小数点型、複合型、ブール型、無

Fitsキーワードが使用する有効値(与えられた場合) test 無効値を置き換えることはできません。言い換えれば、キーワードの現在値が無効である場合、これは代替としてデフォルト値を提供する。もし…。 None 代替値がなければ，キーワードは修復できない.

option応力.応力

Output verification option. Must be one of "fix", "silentfix", "ignore", "warn", or "exception". May also be any combination of "fix" or "silentfix" with "+ignore", +warn, or +exception" (e.g. ``"fix+warn"). See 検証オプション for more info.

errlistリスト.リスト

FITSファイルで発見された検証エラーリスト；これは、主に検証システムが複数のHDUにわたるエラーおよびペアを収集するために使用される req_cards それがそうです。

注意事項

もし pos=None カードは、タイトル内の任意の位置に存在することができる。カードが存在しない場合、新しいカードは fix_value その作成時の価値として。まだ使えます test 論争する。

run_option(option='warn', err_text='', fix_text='Fixed.', fix=None, fixable=True)

選択されたオプションを用いて検証を実行します。

property size

HDUデータ部分のサイズ(バイト)。

update()

列の最新の変更を反映するようにタイトルキーワードを更新します。

verify(option='warn')

事例中のすべての値を検証する.

パラメータ
option応力.応力

Output verification option. Must be one of "fix", "silentfix", "ignore", "warn", or "exception". May also be any combination of "fix" or "silentfix" with "+ignore", "+warn", or "+exception" (e.g. "fix+warn"). See 検証オプション for more info.

verify_checksum()

検証 CHECKSUM キーワードは、現在のHDUチェックサムについて計算された値に一致する。

返品
valid集積する.

  • 0-障害

  • 1-成功

  • 2-いいえ CHECKSUM キーワードが存在する

verify_datasum()

検証 DATASUM キーワードと為 DATASUM 現在のHDUデータの。

返品
valid集積する.

  • 0-障害

  • 1-成功

  • 2-いいえ DATASUM キーワードが存在する

writeto(name, output_verify='exception', overwrite=False, checksum=False)

その動作方式は通常のWriteto()と類似しているが、デフォルト値が予め設定されている PrimaryHDU HDUを拡張するために必要なものです(拡張HDUは独立して動作できません)。

バージョン 1.3 で変更: overwrite 時代遅れのものに取って代わる clobber 論争する。

Column

class astropy.io.fits.Column(name=None, format=None, unit=None, null=None, bscale=None, bzero=None, disp=None, start=None, dim=None, array=None, ascii=None, coord_type=None, coord_unit=None, coord_ref_point=None, coord_ref_value=None, coord_inc=None, time_ref_pos=None)[ソース]

ベースクラス: astropy.io.fits.util.NotifierMixin

Class which contains the definition of one column, e.g. ttype, tform, etc. and the array containing values for the column.

1つを構築することは Column 属性を指定することで。以下の属性を除くすべての属性 format オプションでございます 列作成. そして ASCII表の作成 以下の内容に関するより多くの情報 TFORM キーワード。

パラメータ
name文字列、オプション

名前を並べて，それに対応する. TTYPE キーワード

format応力.応力

列形式は、 TFORM キーワード

unit文字列、オプション

列単位は，それに対応する. TUNIT キーワード

null文字列、オプション

空の値は TNULL キーワード

bscale類整型、オプション

Bscale値は TSCAL キーワード

bzero類整型、オプション

B 0の値は TZERO キーワード

disp文字列、オプション

表示形式は、 TDISP キーワード

start形が整っていて、オプションです

列開始位置(ASCII表のみ)は，対応する TBCOL キーワード

dim文字列、オプション

対応する列次元 TDIM キーワード

array反復可能、オプション

a list, numpy.ndarray (or other iterable that can be used to initialize an ndarray) providing initial data for this column. The array will be automatically converted, if possible, to the data format of the column. In the case were non-trivial bscale and/or bzero arguments are given, the values in the array must be the physical values--that is, the values of column as if the scaling has already been applied (the array stored on the column object will then be converted back to its storage values).

asciiブル値、オプション

集 True これがASCII表の列を記述している場合；これは列形式の曖昧性解消に必要である可能性がある

coord_type文字列、オプション

対応する座標/軸タイプ TCTYP キーワード

coord_unit文字列、オプション

対応する座標/軸単位 TCUNI キーワード

coord_ref_point類整型、オプション

対応する基準点の画素座標 TCRPX キーワード

coord_ref_value類整型、オプション

対応する基準点の座標値 TCRVL キーワード

coord_inc類整型、オプション

基準点に対応する座標増分 TCDLT キーワード

time_ref_pos文字列、オプション

対応する時間座標列の参照位置 TRPOS キーワード

property array

フライドポテト(The Numpy) ndarray これに関連して Column それがそうです。

もし使用して伝達すれば array パラメータ，これはこの配列に戻る.ただし、この列が後でテーブルに追加される場合、例えばVIA BinTableHDU.from_columns 一般に、この属性は、もはや同じ配列ではない可能性があるテーブル内の関連フィールドを参照するために更新されるであろう。

property ascii

これがそうであろうとなかろうと Column ASCII表中の列を示す.

copy()[ソース]

この書類のコピーを返してください Column それがそうです。

ColDefs

class astropy.io.fits.ColDefs(input, ascii=False)[ソース]

ベースクラス: astropy.io.fits.util.NotifierMixin

クラスを列に定義する.

それは Column 属性(例えば ColDefs 以下の属性を持つ names 同時に…。 Column あります。 name )である。それぞれの属性は ColDefs すべてのオブジェクトからの対応する属性値のリストである Column 物体です。

パラメータ
入力 ：順番 Column あるいは…。 ColDefs Ndarrayまたは recarray序列.序列.

既存の表HDU、既存の ColDefs または任意のマルチフィールドNumpy配列または numpy.recarray それがそうです。

asciiブルル.

Trueを用いることでASCIIリストの使用が確保できる.

add_col(column)[ソース]

1つ追加する Column 列定義に追加する.

change_attrib(col_name, attrib, new_value)[ソース]

属性を変更する(で KEYWORD_ATTRIBUTES リスト)の Column それがそうです。

パラメータ
col_name文字列または全体型

変更する列名または索引

attrib応力.応力

属性名

new_value客体.

属性の新しい値

change_name(col_name, new_name)[ソース]

更に変更する. Column 彼の名前です。

パラメータ
col_name応力.応力

列の現在の名称

new_name応力.応力

列の新名称

change_unit(col_name, new_unit)[ソース]

更に変更する. Column の単位です。

パラメータ
col_name文字列または全体型

列名または索引

new_unit応力.応力

柱の新しい単位

del_col(col_name)[ソース]

(の定義を)1つ削除する Column それがそうです。

col_name文字列または全体型

列の名称または索引

info(attrib='all', output=None)[ソース]

列定義の属性情報を取得する.

パラメータ
attrib応力.応力

リストされた1つまたは複数の属性であってもよい astropy.io.fits.column.KEYWORD_ATTRIBUTES それがそうです。黙認する. "all" これはすべての属性を印刷します。それは複数とスペースを許す。2つ以上の属性名がある場合は、コンマで区切らなければならない。

output類似書類、オプション

出力する類似ファイルのオブジェクト.デフォルトの場合、標準出力に出力されます。もし…。 False 属性を dict 代わりに。

注意事項

デフォルトの場合、関数は何も返さず、stdoutにのみ印刷される。

FITS_rec

class astropy.io.fits.FITS_rec(input)[ソース]

ベースクラス: numpy.recarray

配列類の記録に適している.

FITS_rec 表HDUのデータ部分のデータ部分である.これは層で覆われています recarray スケーリングされた列を処理することができます

それは継承されています numpy.ndarray それがそうです。

RecarrayからFITSレコード配列を構築する.

property columns

Coldefsのユーザがアクセスを見ることができる.

copy(order='C')[ソース]

Numpy文書の嘘 numpy.ndarray.copy is not equivalent to numpy.copy. Differences include that it re-views the copied array as self's ndarray subclass, as though it were taking a slice; this means _ 呼び出し_array_finalize__ﾟ`，コピーはすべての配列属性(を含む)を共有する ``._converted ！！)したがって，これらすべての属性を深さコピーする必要があり，2つの配列が本当に何のデータも共有しないようにする必要がある.

field(key)[ソース]

一望できる美しい景色 Column のデータを配列とする.

property formats

フォーマットに適したリストを作成します。

classmethod from_columns(columns, nrows=0, fill=False, character_as_bytes=False)[ソース]

1つ出しました ColDefs 未知のソースのオブジェクトは、新しいものを初期化します FITS_rec 物体です。

注釈

これはもともと new_table 関数は，クラスメソッドに移動されるが，その機能の大部分はつねに初期化と同じであるからである. FITS_rec 対象やその多くの部分は FITS_rec._scale_back それがそうです。

パラメータ
列 ：順番 Column あるいはそうだ ColDefs序列.序列.

その中から表データの列を作成しなければならない.これらの列にデータ配列が追加されている場合、データは、新しいテーブルを初期化するために使用されてもよい。そうでなければ、入力列は、要求行数を有する新しいテーブルのテンプレートとして使用される。

nrows集積する.

新しい表の行数。入力列にそれに関連するデータがあれば，最大入力列の大きさを用いる.そうでなければ，デフォルト値は0となる.

fillブルル.

もし True すべてのセルはゼロまたは空白で充填されます。もし…。 False 入力からデータをコピーすると，未定義のセルはゼロ/空白で満たされる.

property names

名前リストを列記する。

FITS_record

class astropy.io.fits.FITS_record(input, row=0, start=None, end=None, step=None, base=None, **kwargs)[ソース]

ベースクラス: object

レコードレベルに合う。

FITS_record 訪問に用いる FITS_rec 相手。これはスケーリングされた列を処理することを可能にします。また、ASCIIテーブルに列挙された変換/スケーリングも処理します。♪the FITS_record クラスには1つ必要だ FITS_rec 対象を入力とする.

パラメータ
input配列.

改行の配列をお願いします。

row形が整っていて、オプションです

配列の先頭論理行.

start形が整っていて、オプションです

このオブジェクトに関連付けられた行中の開始列.対に使う FITS_rec 物体です。

end形が整っていて、オプションです

このオブジェクトに関連する行中の終了列.対に使う FITS_rec 物体です。

field(field)[ソース]

レコードのフィールドデータを取得する.

setfield(field, value)[ソース]

記録されたフィールドデータを設定します。

表関数

tabledump()

astropy.io.fits.tabledump(filename, datafile=None, cdfile=None, hfile=None, ext=1, overwrite=False)[ソース]

表HDUをASCII形式のファイルに転送します。このテーブルは、3つの別個のファイルに転送することができ、1つは列定義を含み、1つはタイトルパラメータを含み、他方はテーブルデータのために使用される。

パラメータ
filename類似パスや類似ファイル

適合ファイルを入力します。

datafile類似パスまたは類似ファイル、オプション

データファイルを出力する。デフォルト値はFITSファイルを入力するルート名，かかと下線，かかと拡張子(EXT)，かかと拡張子である. .txt それがそうです。

cdfile類似パスまたは類似ファイル、オプション

列定義ファイルを出力する.黙認する. None したがって，列定義出力は生成されない.

hfile類似パスまたは類似ファイル、オプション

ヘッダパラメータファイルを出力します。黙認する. None ヘッダパラメータ出力は生成されない.

ext集積する.

ダンプする表HDUの内線番号が含まれています。

overwriteブル値、オプション

もし True もしあれば、出力ファイルを上書きします(存在すれば)。1つの問題を引き起こしました OSError もし False また，出力ファイルが存在する.デフォルト値は False それがそうです。

バージョン 1.3 で変更: overwrite 時代遅れのものに取って代わる clobber 論争する。

注意事項

主な用途は tabledump 機能は，標準テキストエディタで表データとパラメータを編集することを可能にすることである.♪the tableload 関数は、3つのASCIIファイルからテーブルを再組み立てするために使用することができる。

  • データファイル： データファイルの各行は1行のテーブルデータを表す.データは列順に1列ずつ出力される.列が配列を含む場合、次の列に移動する前に、現在の行の列配列の各要素が出力される。行ごとに一行で終わります。

    整数データは21文字のフィールドで右に整列して出力され，空白の後に続く.浮動小数点データは21文字のフィールドに‘g’形式で右アライメント出力され，精度は15ビットであり，1つのスペースが続く.スペースを含まない文字列データの幅と TFORM 列のHeaderパラメータは，直後に空白となる.文字列データにスペース文字が含まれている場合は，文字列は引用符で導かれる ("" )である。行の最後のデータ要素の場合、フィールドの末尾のスペースは改行によって置換されます。

    可変長配列(‘P’フォーマット)を含む列データに対して，配列データの前に文字列がある 'VLA_Length= ' およびその行配列の整数長は，21文字のフィールドに左に整列し，スペースを後にする.

    注釈

    このフォーマットはサポートされています not 曖昧性を克服することは困難であるため，(‘q’フォーマット)を用いた可変長配列をサポートする.これは、ファイルフォーマットが、サイズが2 GBを超えるファイルに格納されているテーブルのVLA列をサポートしていないことを意味する。

    ビットフィールド(‘X’フォーマット)を表す列データの場合、フィールド内の各ビット値は、21文字のフィールドにおいて右整列出力が1(真を表す)または0(偽を表す)である。

  • Cdfile： 列定義ファイルの行ごとに表中のある列の定義を提供する.この行は、8個の16文字のフィールドに分割される。最初のフィールドは列名を提供する (TTYPEn )である。第2のフィールドは、列フォーマットを提供する (TFORMn )である。第3のフィールドは、表示フォーマットを提供する (TDISPn )である。第4のフィールドは物理単位を提供する (TUNITn )である。5つ目のフィールドは、多次元配列の次元を提供する (TDIMn )である。6つ目のフィールドは、未定義値を表す値を提供する (TNULLn )である。7番目のフィールドはスケーリング係数を提供します (TSCALn )である。8番目のフィールドはオフセット値を提供する (TZEROn )である。フィールド値 "" 値が与えられていない場合を表すために用いられる.

  • Hfile： ヘッダパラメータファイルの各行は、カード画像によって表される単一のHDUヘッダカードの定義を提供する。

tableload()

astropy.io.fits.tableload(datafile, cdfile, hfile=None)[ソース]

入力されたASCIIファイルから表を作成する.入力は最大3つの個々のファイルからのものであり、1つは列定義を含み、1つはタイトルパラメータを含み、他方は列データを含む。ヘッダパラメータファイルは必要ではない.ヘッダパラメータファイルが存在しない場合には，最小ヘッダを構築する.

パラメータ
datafile類似パスや類似ファイル

ASCIIフォームデータを含む入力データファイル.

cdfile類似パスや類似ファイル

テーブルの列に関連付けられた名前、フォーマット、表示フォーマット、物理単位、多次元配列次元、未定義値、スケーリング係数、およびオフセットを含む入力列定義ファイル。

hfile類似パスまたは類似ファイル、オプション

表に関連付けるタイトルパラメータ定義を含む入力パラメータ定義ファイル.もし…。 None 最小ヘッダを構成する.

注意事項

主な用途は tableload 機能は，ASCIIデータ，すなわち標準テキストエディタで編集されたフォームデータとパラメータの入力を許可することである.TABLEDAUMP関数を使用して、初期ASCIIファイルを作成することができます。

  • データファイル： データファイルの各行は1行のテーブルデータを表す.データは列順に1列ずつ出力される.列が配列を含む場合、次の列に移動する前に、現在の行の列配列の各要素が出力される。行ごとに一行で終わります。

    整数データは21文字のフィールドで右に整列して出力され，空白の後に続く.浮動小数点データは21文字のフィールドに‘g’形式で右アライメント出力され，精度は15ビットであり，1つのスペースが続く.スペースを含まない文字列データの幅と TFORM 列のHeaderパラメータは，直後に空白となる.文字列データにスペース文字が含まれている場合は，文字列は引用符で導かれる ("" )である。行の最後のデータ要素の場合、フィールドの末尾のスペースは改行によって置換されます。

    可変長配列(‘P’フォーマット)を含む列データに対して，配列データの前に文字列がある 'VLA_Length= ' およびその行配列の整数長は，21文字のフィールドに左に整列し，スペースを後にする.

    注釈

    このフォーマットはサポートされています not 曖昧性を克服することは困難であるため，(‘q’フォーマット)を用いた可変長配列をサポートする.これは、ファイルフォーマットが、サイズが2 GBを超えるファイルに格納されているテーブルのVLA列をサポートしていないことを意味する。

    ビットフィールド(‘X’フォーマット)を表す列データの場合、フィールド内の各ビット値は、21文字のフィールドにおいて右整列出力が1(真を表す)または0(偽を表す)である。

  • Cdfile： 列定義ファイルの行ごとに表中のある列の定義を提供する.この行は、8個の16文字のフィールドに分割される。最初のフィールドは列名を提供する (TTYPEn )である。第2のフィールドは、列フォーマットを提供する (TFORMn )である。第3のフィールドは、表示フォーマットを提供する (TDISPn )である。第4のフィールドは物理単位を提供する (TUNITn )である。5つ目のフィールドは、多次元配列の次元を提供する (TDIMn )である。6つ目のフィールドは、未定義値を表す値を提供する (TNULLn )である。7番目のフィールドはスケーリング係数を提供します (TSCALn )である。8番目のフィールドはオフセット値を提供する (TZEROn )である。フィールド値 "" 値が与えられていない場合を表すために用いられる.

  • Hfile： ヘッダパラメータファイルの各行は、カード画像によって表される単一のHDUヘッダカードの定義を提供する。

table_to_hdu()

astropy.io.fits.table_to_hdu(table, character_as_bytes=False)[ソース]

変換して Table 相手が適切である BinTableHDU それがそうです。

パラメータ
tableastropy.table.Table

変換する時計です。

character_as_bytesブルル.

HDUからのアクセス時に文字列のバイトを返すかどうか。デフォルトではこれは False AND(Unicode)文字列を返すが，大型表に対しては大量のメモリを占有する可能性がある.

返品
table_hdu ： BinTableHDUBinTable HDU

FITSバイナリテーブルHDU。