解析する.

astropy.io.votable.parse(source, columns=None, invalid='exception', verify=None, chunk_size=256, table_number=None, table_id=None, filename=None, unit_format=None, datatype_mapping=None, _debug_python_based_parser=False)[ソース]

1つ解析する VOTABLE XML文書(または類似文書のオブジェクト)を返し、1つを返す VOTableFile 物体です。

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

パスまたは類似ファイルのオブジェクト、その中に含まれる VOTABLE XML文書。ファイルであれば、読み取り可能でなければならない。

columns文字列、オプション

出力に含まれるフィールド名リスト。デフォルトの場合、すべてのフィールドが含まれます。

invalid文字列、オプション

次の値の1つ:

  • ‘Exception’:無効値に遭遇した場合に例外(デフォルト値)を開始します。

  • ‘MASK’:マスク無効値

verify{‘無視’,‘警告’,‘異常’},オプション

いつ? 'exception' したがって,文書が仕様に違反した場合にエラーを起こし,そうでなければ警告を発する. ('warn' )または沈黙が続く ('ignore' )である。標準Python機構を使用して警告を制御することができます。ご参照ください warnings モジュール、より多くの情報を知る。提供されていない場合は、構成設定を使用します。 astropy.io.votable.verify デフォルトは“無視”である.

バージョン 4.0 で変更: verify 代わりになった pedantic パラメータ,このパラメータは将来的には破棄されるであろう.

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

配列の前に読み出す行数に変換する.数字が大きいほど速度が速くなるかもしれないが、より多くのメモリを消費する。

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

ファイルに読み込む表の数。もし…。 None すべての表を読み取ります。数字であれば,0はファイル中の最初のテーブルを表し,その番号のテーブルのみが解析され読み込みされる.すべきでない. table_id それがそうです。

table_id文字列、オプション

ファイルに読み込む表のID。すべきでない. table_number それがそうです。

filename文字列、オプション

エラーメッセージで使用されるファイル名、URL、または他の識別子。もし…。 ファイル名 Noneのために 源. 文字列(すなわちパス)であれば 源. エラーメッセージのファイル名として使用される.だからね、 ファイル名 ソースが類似ファイルのオブジェクトである場合にのみ必要である.

unit_formatStr、astterpy.units.format.Baseインスタンスまたはなし、オプション

The unit format to use when parsing unit attributes. If a string, must be the name of a unit formatter. The built-in formats include generic, fits, cds, and vounit. A custom formatter may be provided by passing a UnitBase instance. If None (default), the unit format to use will be the one specified by the VOTable specification (which is cds up to version 1.3 of VOTable, and vounit in more recent versions of the spec).

datatype_mappingDICT、オプション

データタイプ名のマッピング (str )有効な投票可能データタイプ名(文字列)に変換します。例えば、読み出しているファイルにデータタイプ“unsignedInt”(votableにおける無効データタイプ)が含まれている場合には、マッピングを含むようにしてください。 {{"unsignedInt": "long"}} それがそうです。

返品
投票可能なVOTableFile 客体.VOTable Fileオブジェクト

参考

astropy.io.votable.exceptions

この関数は異常を引き起こす可能性がある。