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_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
一致価値のあるカード。
- 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の位置に関する情報を詳細に示す。返品
None
HDUがファイルに関連付けられていない場合。辞書内容:
キー、キー
価値がある
ファイル.ファイル
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
そしてBZERO
HDUの頭の上にあります。この方法は、データがスケーリングされるため、呼び出し後にあまり有用ではないので、出力ファイルを書き込む前にのみ使用すべきである。- パラメータ
- 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 originalBSCALE
andBZERO
values 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ブルル.
いつ?
True
2つを同時に追加するDATASUM
そしてCHECKSUM
ファイルを書き込む際にHDUのヘッダにカードを追加します。