QDP

class astropy.io.ascii.QDP(table_id=None, names=None, err_specs=None, sep=None)[ソース]

ベースクラス: astropy.io.ascii.basic.Basic

素早くきれいなグラフです。

例::

! Initial comment line 1
! Initial comment line 2
READ TERR 1
READ SERR 3
! Table 0 comment
!a a(pos) a(neg) b be c d
53000.5   0.25  -0.5   1  1.5  3.5 2
54000.5   1.25  -1.5   2  2.5  4.5 3
NO NO NO NO NO
! Table 1 comment
!a a(pos) a(neg) b be c d
54000.5   2.25  -2.5   NO  3.5  5.5 5
55000.5   3.25  -3.5   4  4.5  6.5 nan

上の入力テーブルは、いくつかの初期注釈、エラーコマンド、次いで2つのテーブルを含む。このファイルフォーマットは、複数のテーブルを含むことができ、これらのテーブルの間は行全体で構成される NO S.注釈は感嘆符であり,欠けた値は単一である. NO 参加作品。区切りは通常スペースで、コンマは少ない。QDPフォーマットはデータ列とエラー列を区別する.上の表にはコマンドが含まれています:

READ TERR 1
READ SERR 3

これは、データ列1の後に、その正エラーバーと正エラーバーとを含む2つのエラー列があり、その後、エラーバーがないデータ列2、次いで列3、次いで列3を有する対称エラーの列、次いで残りのデータ列であることを意味する。

As explained below, table headers are highly inconsistent. Possible comments containing column names will be ignored and columns will be called col1, col2, etc. unless the user specifies their names with the names= keyword argument, When passing column names, pass only the names of the data columns, not the error columns. Error information will be encoded in the names of the table columns. (e.g. a_perr and a_nerr for the positive and negative error of column a, b_err the symmetric error of column b.)

このフォーマットに表を書き込む場合、ユーザは転送することができます err_specs キーワード伝達辞書 {{'serr': [3], 'terr': [1, 2]}} これは、データ列1および2には2つの付加列があり、各列には正負の誤りがあり、データ列3には対称誤りを有する付加列があることを意味する(まるで READ SERR そして READ TERR 上記の命令)

タイトルはアノテーションのみであり,タスクによって配布される表は約定を用いる点で大きく異なる可能性がある.例えば、Swift−Gehrelsタスクによって配信されるライト曲線は、ラベルの数がCOLSの数と一致しないように、1つのタイトルエントリに追加の空間を有する。したがって,列名を符号化する可能性のあるアノテーションを無視し,名前仕様をユーザに残す.

例::

>               Extra space
>                   |
>                   v
>!     MJD       Err (pos)       Err(neg)        Rate            Error
>53000.123456   2.378e-05     -2.378472e-05     NO             0.212439

これらのリーダおよびライタクラスは、どの注釈がすべてのテーブルに属し、どれが各テーブルに属するかを理解するために努力する。一般的なコメントは initial_comments 各表のメタデータ。各テーブルの注釈は comments メタです。

例::

t = Table.read(example_qdp, format='ascii.qdp', table_id=1, names=['a', 'b', 'c', 'd'])

2番目の表を読み取る (table_id=1 )書類の中で example.qdp 上表を含める。4つの列名がありますが、7つのデータ列がありますが、なぜですか?なぜなら READ SERR そして READ TERR コマンドには3つのエラー列が表示されている. t.meta['initial_comments'] 文書に含まれる最初の2つの注釈行を t.meta['comments'] 含まれています Table 1 comment

このテーブルは、以下に示すように、別のファイルに書き込み、同じ情報を保持することができる。

t.write(test_file, err_specs={'terr': [1], 'serr': [3]})

注意してください。 terr そして serr 命令はライタに渡される.

方法要約

read \(表)

どうぞお読みください table 属性が決定したフォーマットは結果を返す. outputter 属性です。

write \(表)

書く. table 文字列リストとします。

方法文書

read(table)[ソース]

どうぞお読みください table 属性が決定したフォーマットは結果を返す. outputter 属性です。

♪the table パラメータは、インスタンスが処理可能な任意の文字列またはオブジェクトである inputter それがそうです。基本入力器クラスの場合 table 以下の1つであってもよい。

  • 書類名.

  • クラスファイル·オブジェクト

  • すべての見出しとデータ行を含む文字列(改行区切り)(少なくとも2行が必要)

  • 文字列リスト

パラメータ
table文字列、類似ファイル、リスト

表を入力します。

返品
Table

出力表.

write(table)[ソース]

書く. table 文字列リストとします。

パラメータ
Table

テーブルデータを入力します。

返品
linesリスト.リスト

ASCII表に対応する文字列リスト