PrimaryHDU¶
- class astropy.io.fits.PrimaryHDU(data=None, header=None, do_not_scale_image_data=False, ignore_blank=False, uint=True, scale_back=None)[ソース]¶
ベースクラス:
astropy.io.fits.hdu.image._ImageBaseHDU主要HDUクラスに適しています。
メインHDUを構築します。
- パラメータ
- data :配列または
astropy.io.fits.hdu.base.DELAYEDオプションです。配列や HDUのデータ。
- タイトル :
Headerオプションです。ヘッダ、オプション 使用するタイトル(テンプレートとして).もし…。
headerはい。None最小ヘッダが提供される。- do_not_scale_image_dataブル値、オプション
もし
Trueなお、読み出しにはBSCALE/BZEO値スケーリング画像データは使用しない。(デフォルト値:FALSE)- ignore_blankブル値、オプション
もし
Trueしたがって、空白タイトルキーワード(存在する場合)は無視される。そうでなければ、この値に等しい画素はNANに置き換えられる。(デフォルト値:FALSE)- uintブル値、オプション
記号整数データが解釈されています
BZERO中心的な価値ですBSCALE == 1符号なし整数データとする.例えばint16以下の機能を持つデータBZERO = 32768そしてBSCALE = 1と思われていますuint16データです。(デフォルト値:TRUE)- scale_backブル値、オプション
もし
Trueスケーリングされた画像データを含むファイルの変更を保存する場合は、データを元のタイプに復元し、元のBSCALE/BZEO値を再適用してください。データに対して浮動小数点演算を行った後に整数値に削減すると,精度が低下する可能性がある.SCALE_BACKが明示的に設定されていない限り、擬似符号なし整数の割合が自動的に再調整されるFalseそれがそうです。(デフォルト値:なし)
- data :配列または
- 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_datasum1つを使うwhenパラメータ、そして呼び出しますadd_checksum1つを使うwhen論証とoverride_datasumとする.Trueそれがそうです。これは2枚のカードに一致した注釈を提供し、生成を許可することができますCHECKSUM一致価値のあるカード。
- add_datasum(when=None, datasum_keyword='DATASUM')¶
追加
DATASUMカードは、このHDUに入力され、データ計算のチェックサムとして値が設定される。- パラメータ
- when文字列、オプション
カードの注釈文字列は,デフォルトでチェックサムを計算する時間を表す.
- datasum_keyword文字列、オプション
データ値を格納するためのHeaderキーワードの名前;約束により,その名前は通常‘DATASUM’であるが,異なるキーワードを使用すべき用例が存在する.
- 返品
- checksum集積する.
算出されたデータ量
注意事項
テストの目的で、ご提供ください
whenパラメータはカード中のアノテーション値が一致するようにする.これは生成を可能にしますCHECKSUM一致価値のあるカード。
- copy()¶
HDUをコピーし、ヘッダとデータがコピーされます。
- property data¶
画像/配列データとして
ndarrayそれがそうです。Numpy配列上の軸順序はFITSファイルで指定された順序とは逆であることを覚えておいてください.例えば、2 D画像の場合、“行”またはy軸は第1次元であり、“列”またはx軸は第2次元である。
BZEROおよびBSCALEパラメータを使用してデータをスケーリングする場合、この属性は、ファイルがオープンを使用しない限り、その物理値にスケーリングされたデータを返す。
do_not_scale_image_data=Trueそれがそうです。
- filebytes()¶
このHDUがファイルに書き込まれるバイト数を計算して返す.
- fileinfo()¶
辞書に戻り、任意の関連ファイルにおけるこのHDUの位置情報を詳細に示す。これらの値は,関連ファイルを読み出したり書き込みしたりした後にのみ有効である.
HDUListそれがそうです。- 返品
- DICTやNONE
辞書は、関連ファイルにおけるHDUの位置に関する情報を詳細に示す。返品
NoneHDUがファイルに関連付けられていない場合。辞書内容:
キー、キー
価値がある
ファイル.ファイル
HDUに関連するファイル·オブジェクト
ファイルパターン.
ファイルのモードを開く(読み出しのみ、コピー、更新、付加、OSTREAM)
HdrLoc
ファイル中のヘッダの開始バイト位置
データ位置
ファイル中のデータブロックの開始バイト位置
データスパン.
充填を含むデータサイズ
- 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, orBinTableHDU. Any unrecognized keyword arguments are simply ignored.
- 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)¶
選択されたオプションを用いて検証を実行します。
- scale(type=None, option='old', bscale=None, bzero=None)¶
ズーム画像データの使用
BSCALE/BZEROそれがそうです。このメソッドの呼び出しは拡張されます
dataキーワードを更新しますBSCALEそしてBZEROHDUの頭の上にあります。この方法は、データがスケーリングされるため、呼び出し後にあまり有用ではないので、出力ファイルを書き込む前にのみ使用すべきである。- パラメータ
- type文字列、オプション
destination data type, use a string representing a numpy dtype name, (e.g.
'uint8','int16','float32'etc.). If isNone, use the current data type.- option文字列、オプション
データをどのように拡張するか:
"old"uses the originalBSCALEandBZEROvalues from when the data was read/created (defaulting to 1 and 0 if they don't exist). For integer data only,"minmax"uses the minimum and maximum of the data to scale. User-specifiedbscale/bzero値は常に優先する。- Bscale、bZERO形が整っていて、オプションです
ユーザ指定
BSCALEそしてBZERO価値がある.
- property section¶
画像アレイの一部は、アレイ全体をメモリにロードすることなくアクセスされる。♪the
Sectionこの属性が返されるオブジェクトは,それ自体が直接使用すべきではない.逆に,その節のスライスは対応するデータスライスを返し,ロードする. only その節を記憶に書きなさい。パーティションの多くはmemmapによって淘汰されているが,非常に大きな画像の処理に応用されている.ご参照ください データセグメント. より詳細については、Astropy文書部分を参照してください。
- property shape¶
画像配列の形状は
self.data.shapeそれがそうです。
- property size¶
HDUデータ部分のサイズ(バイト)。
- 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)¶
HDUを新しいファイルに書き込みます。1つのHDUのみがファイルを書き込む必要がある場合、これは、ユーザにより容易な出力インタフェースを提供することができる便利な方法である。
- パラメータ
- name類似パスや類似ファイル
適合ファイルを出力する。ファイルオブジェクトが開いている場合には、書き込み可能モードで開かれなければならない。
- output_verify応力.応力
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.- overwriteブル値、オプション
もし
Trueもしあれば、出力ファイルを上書きします(存在すれば)。1つの問題を引き起こしましたOSErrorもしFalseまた,出力ファイルが存在する.デフォルト値はFalseそれがそうです。バージョン 1.3 で変更:
overwrite時代遅れのものに取って代わるclobber論争する。- checksumブルル.
いつ?
True2つを同時に追加するDATASUMそしてCHECKSUMファイルを書き込む際にHDUのヘッダにカードを追加します。