♪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それがそうです。同じように
VELREFWCSファイルIIIに属する形式主義から.
フラグビットは:
WCSHDR_none:いかなる拡張も受け入れない(正誤表の拡張であっても).タイトル中の非WCSキーワードと同様に要求に適合しないキーワード,すなわちそれらを直接無視する.(これは通過したことに相当するFalse)WCSHDR_all:パーサが認識したすべての拡張子を受け取る.(これはデフォルトの行為や伝達に相当するTrue)。WCSHDR_reject:非標準鍵レコード(以下のフラグの1つが明示的に受け入れられていないレコード)を拒否する.デフォルトで警告が表示されます。このフラグは、ヘッダに存在しないように、非標準キーワードが存在する信号を送信するために使用されてもよく、そうでなければ、ヘッダに存在しないように単純に無視されるであろう。これは主にFITSヘッダがWCS規格を満たしているかどうかをテストするために用いられる.
鍵レコードは、以下の点で非標準的である可能性がある。
キーワードは文法的に有効である可能性があるが,キーワード値のタイプが正しくないか文法が無効であるか,あるいはキーワード注釈のフォーマットが正しくない可能性がある.
このキーワードはWCSキーワードと非常に類似している可能性があるが,実際には基準を満たしていないためではない.例えば
CRPIX011つのように見えますCRPIXjaキーワードですが、実際には軸番号上のプリアンブルゼロは基本適合基準に違反しています。同じようにLONPOLE2有効ではないLONPOLEaキーワード、実際には解析器はそれに何もできません。この基準はキーワードの使用を提案しないかもしれない。以下のフラグの1つで明示的に受け入れられなければ拒否される.
WCSHDR_CROTAia: AcceptCROTAia,iCROTna,TCROTnaWCSHDR_EPOCHa:受け入れるEPOCHaそれがそうです。WCSHDR_VELREFa:受け入れるVELREFaそれがそうです。The constructor always recognizes the AIPS-convention keywords,
CROTAn,EPOCH, andVELREFfor 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_mafor the primary representation(a = ' ').PROJPnis equivalent toPVi_mawithm=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_maappeared by mistake in the examples in WCS Paper II and subsequently these and alsoTCDn_ka,iPSn_maandTPSn_mawere 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.wcsbut are stored as auxiliary information.WCSHDR_CNAMn: AcceptiCNAMn,iCRDEn,iCSYEn,TCNAMn,TCRDEn, andTCSYEn, i.e. withablank. 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 theWcsprmobject as auxiliary information.特に注意しなければならないのは少なくとも1つは
Wcsprm対象はそれぞれになりますa上に列挙された画像タイトルキーワードのうちの1つに見つかります。If the image header keywords for
aare 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
aare inherited by a binary table image array, then those keywords are considered to be "exhausted" and do not result in a separateWcsprmobject.
タイトル記入弛緩定数¶
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_ka1つの例とその後の世界科学大会の論文正誤表では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, andiCRVLnfor bintables andTCRPXn,TCDLTn,TCUNIn,TCTYPn, andTCRVLnfor pixel lists予備バージョン説明子がない場合に使用されます。しかし,8文字のキーワード制限により,99個以上のWCSの列番号を格納するために定義した.
jCRPna,iCDEna,iCUNna,iCTYnaandiCRVnafor bintables andTCRPna,TCDEna,TCUNna,TCTYnaandTCRVnafor pixel listsfor use with an alternate version specifier (the
a). Like thePC,CD,PV, andPSkeywords 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, andiCSYnafor bintables andTCNAna,TCRDna, andTCSYnafor pixel lists以上のように類推すると,長い形では
iCNAMna,iCRDEna, andiCSYEnafor bintables andTCNAMna,TCRDEna, andTCSYEnafor 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”フォーマットを使用します。