♪the relax
キーワードパラメータは非標準FITS WCSキーワードの処理を制御する.
デフォルト値に注意してください relax
はい。 True
for reading (to accept all non standard keywords), and False
for writing (to write out only standard keywords), in accordance with Postel's prescription :
“受け入れは寛容で、送るものは保守的でなければならない”
見出し読み取り弛緩定数¶
WCS
, Wcsprm
and
find_all_wcs
have a relax argument, which may be
either True
, False
or an int
.
もし
True
,(デフォルト),処理解析器が認識したすべての非標準WCSを拡張する.もし
False
したがって,拡張(正誤表中の拡張であっても)は扱われない.条件を満たさないキーワードは,タイトル中の非WCSキーワードと同様に処理される,すなわちそれらを無視すればよい.もし1つが
int
どの非標準WCSキーワードを受け入れるかの細粒度制御を提供するためのビットフィールドである。フラグビットは将来変更される可能性がありますので、先頭の定数を用いて設定すべきですWCSHDR_
はい。astropy.wcs
モジュールです。例えば、受け入れることは
CD00i00j
そしてPC00i00j
使用::relax = astropy.wcs.WCSHDR_CD00i00j | astropy.wcs.WCSHDR_PC00i00j
解析器はいつも処理します
EPOCH
自属EQUINOXa
両方が存在すればVSOURCEa
いつも従属しているZSOURCEa
それがそうです。同じように
VELREF
WCSファイルIIIに属する形式主義から.
フラグビットは:
WCSHDR_none
:いかなる拡張も受け入れない(正誤表の拡張であっても).タイトル中の非WCSキーワードと同様に要求に適合しないキーワード,すなわちそれらを直接無視する.(これは通過したことに相当するFalse
)WCSHDR_all
:パーサが認識したすべての拡張子を受け取る.(これはデフォルトの行為や伝達に相当するTrue
)。WCSHDR_reject
:非標準鍵レコード(以下のフラグの1つが明示的に受け入れられていないレコード)を拒否する.デフォルトで警告が表示されます。このフラグは、ヘッダに存在しないように、非標準キーワードが存在する信号を送信するために使用されてもよく、そうでなければ、ヘッダに存在しないように単純に無視されるであろう。これは主にFITSヘッダがWCS規格を満たしているかどうかをテストするために用いられる.
鍵レコードは、以下の点で非標準的である可能性がある。
キーワードは文法的に有効である可能性があるが,キーワード値のタイプが正しくないか文法が無効であるか,あるいはキーワード注釈のフォーマットが正しくない可能性がある.
このキーワードはWCSキーワードと非常に類似している可能性があるが,実際には基準を満たしていないためではない.例えば
CRPIX01
1つのように見えますCRPIXja
キーワードですが、実際には軸番号上のプリアンブルゼロは基本適合基準に違反しています。同じようにLONPOLE2
有効ではないLONPOLEa
キーワード、実際には解析器はそれに何もできません。この基準はキーワードの使用を提案しないかもしれない。以下のフラグの1つで明示的に受け入れられなければ拒否される.
WCSHDR_CROTAia
: AcceptCROTAia
,iCROTna
,TCROTna
WCSHDR_EPOCHa
:受け入れるEPOCHa
それがそうです。WCSHDR_VELREFa
:受け入れるVELREFa
それがそうです。The constructor always recognizes the AIPS-convention keywords,
CROTAn
,EPOCH
, andVELREF
for the primary representation(a = ' ')
but alternates are non-standard.構造関数受容
EPOCHa
そしてVELREFa
そうでない限りWCSHDR_AUXIMG
有効になりました。WCSHDR_CD00i00j
:受け入れるCD00i00j
それがそうです。WCSHDR_PC00i00j
:受け入れるPC00i00j
それがそうです。WCSHDR_PROJPn
:受け入れるPROJPn
それがそうです。These appeared in early drafts of WCS Paper I+II (before they were split) and are equivalent to
CDi_ja
,PCi_ja
, andPVi_ma
for the primary representation(a = ' ')
.PROJPn
is equivalent toPVi_ma
withm
=n
<= 9, and is associated exclusively with the latitude axis.WCSHDR_CD0i_0ja
:受け入れるCD0i_0ja
(wcspih()).WCSHDR_PC0i_0ja
:受け入れるPC0i_0ja
(wcspih()).WCSHDR_PV0i_0ma
:受け入れるPV0i_0ja
(wcspih()).WCSHDR_PS0i_0ma
:受け入れるPS0i_0ja
(wcspih()).数値インデックスは、例えば、デュアルパラメータキーワードにプリアンブルゼロを有することができる。
PC01_01
それがそうです。WCSファイルI(2.1.2および2.1.4節)は、プリアンブルゼロを明示的に禁止する。FITS 3.0標準文書(第4.1.2.1節)で規定されている、シングルパラメトリックキーワード(例えば、CTYPEia
)“プリアンブルゼロはあってはならない”は、後に8.1節で“プリアンブルゼロは使用できない”と規定される。PVi_ma
そしてPSi_ma
それがそうです。しかし、不注意のため、それはこれに対して黙っていた。PCi_ja
そしてCDi_ja
それがそうです。Wcslb 5.0以上を使用して構築された場合にのみ利用可能である。
WCSHDR_RADECSYS
:受け入れるRADECSYS
それがそうです。これはWCS文書I+IIの早期草稿に現れ,その後置き換えられる.RADESYSa
それがそうです。構造関数受容RADECSYS
そうでない限りWCSHDR_AUXIMG
有効になりました。WCSHDR_VSOURCE
:受け入れるVSOURCEa
あるいは…。VSOUna
それがそうです。この点はWCS文書IIIの早期草稿に現れ,その後放棄され,代わりにZSOURCEa
そしてZSOUna
それがそうです。構造関数受容VSOURCEa
そうでない限りWCSHDR_AUXIMG
有効になりました。WCSHDR_DOBSn
:許可DOBSn
コラムのシミュレーションに特化していますDATE-OBS
それがそうです。不注意のため、基準ではこれが正式に定義されたことがない。WCSHDR_LONGKEY
:交互バイナリテーブルと画素リストWCSキーワードを受け取る長い形式,すなわち“a”の非空白を持つ.具体的には、jCRPXna TCRPXna : jCRPXn jCRPna TCRPXn TCRPna CRPIXja - TPCn_ka : - ijPCna - TPn_ka PCi_ja - TCDn_ka : - ijCDna - TCn_ka CDi_ja iCDLTna TCDLTna : iCDLTn iCDEna TCDLTn TCDEna CDELTia iCUNIna TCUNIna : iCUNIn iCUNna TCUNIn TCUNna CUNITia iCTYPna TCTYPna : iCTYPn iCTYna TCTYPn TCTYna CTYPEia iCRVLna TCRVLna : iCRVLn iCRVna TCRVLn TCRVna CRVALia iPVn_ma TPVn_ma : - iVn_ma - TVn_ma PVi_ma iPSn_ma TPSn_ma : - iSn_ma - TSn_ma PSi_ma
このうち,主に標準入替えフォームおよび画像タイトル等価項がコロンの右側に表示されている.
The long form of these keywords could be described as quasi- standard.
TPCn_ka
,iPVn_ma
, andTPVn_ma
appeared by mistake in the examples in WCS Paper II and subsequently these and alsoTCDn_ka
,iPSn_ma
andTPSn_ma
were legitimized by the errata to the WCS papers.厳密には、他の長いテーブルは非標準的であり、実際にはWCSファイルの任意の草稿や正誤表には現れない。しかし、主な形態の自然な延長として、それらは他の意図を持っている可能性はあまりない。したがって,もちろん,得られたキーワードが8文字の制限を超えない限り,それらを受け入れることは安全であるはずである.
もし
WCSHDR_CNAMn
有効であれば、以下のことも受け入れます。iCNAMna TCNAMna : --- iCNAna --- TCNAna CNAMEia iCRDEna TCRDEna : --- iCRDna --- TCRDna CRDERia iCSYEna TCSYEna : --- iCSYna --- TCSYna CSYERia
Note that
CNAMEia
,CRDERia
,CSYERia
, and their variants are not used byastropy.wcs
but are stored as auxiliary information.WCSHDR_CNAMn
: AcceptiCNAMn
,iCRDEn
,iCSYEn
,TCNAMn
,TCRDEn
, andTCSYEn
, i.e. witha
blank. While non-standard, these are the analogues ofiCTYPn
,TCTYPn
, etc.WCSHDR_AUXIMG
:範囲を表す補助WCSキーワードを有する画像タイトル形式で、すべての画像にデフォルト値を提供することを可能にする。このデフォルト値はキーワードの列特定形式でカバーされる可能性がある.例えばこのようなキーワードは
EQUINOXa
バイナリテーブル内のすべての画像配列に適用されるか、または代替表現を有するすべての画素リスト列a
されない限りEQUIna
それがそうです。具体的には、キーワードは:
LATPOLEa for LATPna LONPOLEa for LONPna RESTFREQ for RFRQna RESTFRQa for RFRQna RESTWAVa for RWAVna
そのキー値は実際にWCSLIBによって使用され,wcsprm structにのみ格納されている補助情報を提供するキーワードも含まれている:
EPOCH - ... (No column-specific form.) EPOCHa - ... Only if WCSHDR_EPOCHa is set. EQUINOXa for EQUIna RADESYSa for RADEna RADECSYS for RADEna ... Only if WCSHDR_RADECSYS is set. SPECSYSa for SPECna SSYSOBSa for SOBSna SSYSSRCa for SSRCna VELOSYSa for VSYSna VELANGLa for VANGna VELREF - ... (No column-specific form.) VELREFa - ... Only if WCSHDR_VELREFa is set. VSOURCEa for VSOUna ... Only if WCSHDR_VSOURCE is set. WCSNAMEa for WCSNna ... Or TWCSna (see below). ZSOURCEa for ZSOUna DATE-AVG for DAVGn DATE-OBS for DOBSn MJD-AVG for MJDAn MJD-OBS for MJDOBn OBSGEO-X for OBSGXn OBSGEO-Y for OBSGYn OBSGEO-Z for OBSGZn
ここで、左側の画像タイトルキーワードは、右側の列特定キーワードにデフォルト値を提供する。
最後のグループのキーワードは例えば
MJD-OBS
すべての置換表現法に適用されるので,MJD-OBS
タイトルのすべての画像にデフォルト値が提供されます。この補助継承機構は、バイナリテーブル画像アレイおよび画素リストにも同様に適用可能である。これらのキーワードの多くはデフォルト値を持っていません例外的には
LONPOLEa
そしてLATPOLEa
そして、そしてRADESYSa
そしてEQUINOXa
これらはお互いにデフォルト値を提供します。使用中の唯一の潜在的な困難はWCSHDR_AUXIMG
この4つのキーワードのうちの1つを誤って継承したことです似ていない
WCSHDR_ALLIMG
これらの補助WCS画像タイトルキーワードのうちの1つ(または全部)の存在自体は、結果として生じないWcsprm
バックアップのために作成されたオブジェクトを表示するa
それがそうです。これは、これらのキーワードのデフォルト値と組み合わせて使用される場合、非平凡な座標表現、例えば、非平凡な座標表現を作成するのに十分な情報を提供できないからである。CTYPEia
これらは軸番号によってパラメータ化される.WCSHDR_ALLIMG
:使用を許可する画像タイトル形式 all 画像タイトルWCSキーワードは、バイナリテーブル内のすべての画像アレイにデフォルト値を提供するために使用される。画素リストではありません)このデフォルト値はキーワードの列特定形式でカバーされる可能性がある.例えばこのようなキーワードは
CRPIXja
代替表現を有するバイナリテーブル内のすべての画像配列に適用されるa
されない限りjCRPna
それがそうです。具体的には、キーワードは上に列挙されたキーワードです
WCSHDR_AUXIMG
また:WCSAXESa for WCAXna
これは、座標次元と、軸番号によってパラメータ化された以下のキーワードとを定義する。
CRPIXja for jCRPna PCi_ja for ijPCna CDi_ja for ijCDna CDELTia for iCDEna CROTAi for iCROTn CROTAia - ... Only if WCSHDR_CROTAia is set. CUNITia for iCUNna CTYPEia for iCTYna CRVALia for iCRVna PVi_ma for iVn_ma PSi_ma for iSn_ma CNAMEia for iCNAna CRDERia for iCRDna CSYERia for iCSYna
ここで、左側の画像タイトルキーワードは、右側の列特定キーワードにデフォルト値を提供する。
この完全継承機構は、後者の場合、座標軸番号と列番号との間に明確に定義された関連がないため、バイナリテーブル画像配列にのみ適用され、画素リストには適用されない。
Note that
CNAMEia
,CRDERia
,CSYERia
, and their variants are not used by pywcs but are stored in theWcsprm
object as auxiliary information.特に注意しなければならないのは少なくとも1つは
Wcsprm
対象はそれぞれになりますa
上に列挙された画像タイトルキーワードのうちの1つに見つかります。If the image header keywords for
a
are not inherited by a binary table, then the struct will not be associated with any particular table column number and it is up to the user to provide an association.If the image header keywords for
a
are inherited by a binary table image array, then those keywords are considered to be "exhausted" and do not result in a separateWcsprm
object.
タイトル記入弛緩定数¶
to_header
and to_header_string
has a relax argument which may be either True
, False
or an
int
.
もし
True
すべての識別可能な拡張子を書き込む.もし
False
(デフォルト)は,安全と思われる拡張子と推薦されたすべての拡張子を書くことに相当する.WCSHDO_safe
(以下に述べる).もし1つが
int
どの非標準WCSキーワードを受け入れるかの細粒度制御を提供するためのビットフィールドである。フラグビットは将来変更される可能性がありますので、先頭の定数を用いて設定すべきですWCSHDO_
はい。astropy.wcs
モジュールです。
フラグビットは:
WCSHDO_none
:拡張子は使用しないでください。WCSHDO_all
:すべての識別された拡張子を書き込むことは,各フラグビットを設定することに相当する.WCSHDO_safe
:安全と推奨されるすべての拡張を書いてください。WCSHDO_DOBSn
:書き込みDOBSn
コラムのシミュレーションに特化していますDATE-OBS
バイナリテーブルおよび画素リストに用いられる。政府はWCSファイルIIIを発売DATE-AVG
そしてDAVGn
でも不注意でDOBSn
標準的に正式に定義されたことはない。使用代替案DOBSn
書くことです。DATE-OBS
これは表全体に適用される。この使い方は安全だと思われていますので、使うことをお勧めします。WCSHDO_TPCn_ka
:私が定義したWCS紙TPn_ka
そしてTCn_ka
画素リストの場合しかしWCS紙IIは
TPCn_ka
1つの例とその後の世界科学大会の論文正誤表ではTPCn_ka
そしてTCDn_ka
画素リストの場合キーワードが八文字を超えない限り。この用法は安全であると考えられ,短い形の非助記憶簡潔性のために推奨されている。
WCSHDO_PVn_ma
:私が定義したWCS紙iVn_ma
そしてiSn_ma
バイナリファイルとTVn_ma
そしてTSn_ma
画素リストの場合しかしWCS紙IIは
iPVn_ma
そしてTPVn_ma
これらの例では,その後のWCS論文正誤表で用いる.iPVn_ma
そしてiPSn_ma
バイナリファイルとTPVn_ma
そしてTPSn_ma
画素リストの場合キーワードが八文字を超えない限り。この用法は安全であると考えられ,短い形の非助記憶簡潔性のために推奨されている。
WCSHDO_CRPXna
:歴史的な理由でWCSファイルを定義しましたjCRPXn
,iCDLTn
,iCUNIn
,iCTYPn
, andiCRVLn
for bintables andTCRPXn
,TCDLTn
,TCUNIn
,TCTYPn
, andTCRVLn
for pixel lists予備バージョン説明子がない場合に使用されます。しかし,8文字のキーワード制限により,99個以上のWCSの列番号を格納するために定義した.
jCRPna
,iCDEna
,iCUNna
,iCTYna
andiCRVna
for bintables andTCRPna
,TCDEna
,TCUNna
,TCTYna
andTCRVna
for pixel listsfor use with an alternate version specifier (the
a
). Like thePC
,CD
,PV
, andPS
keywords there is a tendency to confuse these two forms for column numbers up to 99. It is very unlikely that any parser would reject keywords in the first set with a non-blank alternate version specifier so this usage is considered to be safe and is recommended.
WCSHDO_CNAMna
:WCSファイルIおよびIIIの定義iCNAna
,iCRDna
, andiCSYna
for bintables andTCNAna
,TCRDna
, andTCSYna
for pixel lists以上のように類推すると,長い形では
iCNAMna
,iCRDEna
, andiCSYEna
for bintables andTCNAMna
,TCRDEna
, andTCSYEna
for pixel listsこれらのキーワードは補助情報のみを提供しており,世界座標を計算する必要はないことに注意されたい.この使い方は安全ではないかもしれませんが、今のところはおすすめできません。
WCSHDO_WCSNna
:書き込みWCSNna
ではなくTWCSna
ピクセルリストに使います。構造関数処理の際WCSNna
そしてTWCSna
同様に、他の解析器はできないかもしれない。したがって、このような使い方は安全ではないかもしれませんが、今のところ使用をお勧めしませWCSHDO_SIP
:単純イメージング多項式(SIP)キーワードを書く.WCSHDO_P12
,WCSHDO_P13
,WCSHDO_P14
,WCSHDO_P15
,WCSHDO_P16
,WCSHDO_P17
,WCSHDO_EFMT
これらの定数は,返されたWCSキーワードの精度を制御する.
to_header
それがそうです。WCSHDO_P12
:すべての浮動小数点キー値(12ビット有効数字)に“%20.12 G”フォーマットを使用WCSHDO_P13
:すべての浮動小数点キー値に“%21.13 G”フォーマット(有効数字13個)を使用WCSHDO_P14
:すべての浮動小数点キー値(14ビット有効数字)に“%22.14 G”フォーマットを使用WCSHDO_P15
:すべての浮動小数点キー値(15ビット有効数字)に対して“%23.15 G”フォーマットを使用WCSHDO_P16
:すべての浮動小数点キー値(16ビット有効数字)に“%24.16 G”フォーマットを使用WCSHDO_P17
:すべての浮動小数点キー値に“%25.17 G”フォーマット(17ビット有効数字)を使用WCSHDO_EFMT
:上記のデフォルト“%G”フォーマットではなく“%E”フォーマットを使用します。