♪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: Accept CROTAia, iCROTna, TCROTna

  • WCSHDR_EPOCHa :受け入れる EPOCHa それがそうです。

  • WCSHDR_VELREFa :受け入れる VELREFa それがそうです。

    The constructor always recognizes the AIPS-convention keywords, CROTAn, EPOCH, and VELREF 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, and PVi_ma for the primary representation (a = ' '). PROJPn is equivalent to PVi_ma with m = 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, and TPVn_ma appeared by mistake in the examples in WCS Paper II and subsequently these and also TCDn_ka, iPSn_ma and TPSn_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 by astropy.wcs but are stored as auxiliary information.

  • WCSHDR_CNAMn: Accept iCNAMn, iCRDEn, iCSYEn, TCNAMn, TCRDEn, and TCSYEn, i.e. with a blank. While non-standard, these are the analogues of iCTYPn, 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 the Wcsprm 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 separate Wcsprm 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, and iCRVLn for bintables and

    • TCRPXn, TCDLTn, TCUNIn, TCTYPn, and TCRVLn for pixel lists

      予備バージョン説明子がない場合に使用されます。しかし,8文字のキーワード制限により,99個以上のWCSの列番号を格納するために定義した.

    • jCRPna, iCDEna, iCUNna, iCTYna and iCRVna for bintables and

    • TCRPna, TCDEna, TCUNna, TCTYna and TCRVna for pixel lists

      for use with an alternate version specifier (the a). Like the PC, CD, PV, and PS 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, and iCSYna for bintables and

    • TCNAna, TCRDna, and TCSYna for pixel lists

      以上のように類推すると,長い形では

    • iCNAMna, iCRDEna, and iCSYEna for bintables and

    • TCNAMna, TCRDEna, and TCSYEna 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”フォーマットを使用します。