SLLIB + SFITSIO ダイジェスト版 HTML マニュアル

使用頻度の高い API について，主要な内容を記述した，ビギナー向けのリファレンスマニュアルです．

SLLIB クラス:	ストリーム / 文字列 / 文字列配列 / 文字列連想配列 / 多次元配列
SLLIB クラス用関数:	多次元配列用の統計用関数 / 多次元配列用の数学関数 / 多次元配列用の複素関数
SLLIB クラス以外:	定数・型の定義 / C99互換の複素数・複素関数
SFITSIO クラス:	fitscc / fits_hdu / fits_image / fits_table / fits_table_col / fits_header / fits_header_record
SFITSIO クラス以外:	関数 / 定数・型の定義 / FITSファイルの部分読み出し機能 / FITSテンプレート / 規約外FITS拡張

SFITSIO: FITSファイルの部分読み出し機能

fitsccクラスの read_stream() または access_stream() では，次のコードのようにIRAF風の表記により n次元の画像やテーブルの一部分だけを読み出す事が可能です．

    sz = fits.read_stream("image.fits.gz[1:100,*]");

特定のHDUだけを読み取る事も可能で，これにより，途中から不正なデータが現れるFITSファイルや，非標準な規約のHDUが追加されているFITSファイルも，その一部分を読み取る事ができます．

この部分読み出し機能では，FITS ファイルの内容すべてをメモリに取り込む事はなく，ディスクのシーケンシャルリードと順方向のシーク(可能な場合)により実現しています．したがって，メモリに載らないような巨大な FITS ファイルでも(圧縮ファイルであっても)，必要な部分を読み出す事ができます．

SFITSIOでは，IRAF/CFITSIOの場合と同様の記法と， SFITSIOで新たに定義した「より論理的な」記法の， 2通りをサポートしています．

IRAF/CFITSIO的な記法

元のFITSファイル中の複数のHDUの中から，1つのHDUを選び，画像の一部を読み取る指定が可能です．典型的には次のような形です．

    sz = fits.read_stream("image.fits.gz[1][1:100,*]");

この記法による表現は，SFITSIO内部でこの後で解説する SFITSIO公式の記法に変換され，FITSファイルの部分読みが実行されます．上記の例の場合，ファイル名を含む引数は "image.fits.gz[1[1:100,*]]" と変換されます．

この後で解説しますが，画像の領域指定の部分については，画像の反転「"[100:1,*]"」「"[-*,*]"」， 0-indexedを示す丸括弧「"(0:99,*)"」も，IRAF/CFITSIO的な記法でも使う事ができます．

SFITSIO公式の論理的な記法

SFITSIO公式の記法では，より論理的で現代的な表現となっており，従来できなかった複数のHDUの選択が可能になっています．

文法の一般的解説

ファイル名直後における，同じ階層の「[」「]」のペアは一組だけとし，[] の中にセミコロン区切りで複数のHDUに関する指定を書く．
```
myfile.fits[HDU指定A; HDU指定B; ... HDU指定Z]
```

各HDU指定では，階層が1つ下の [] か () で画像の領域またはテーブルの領域を指定できる．

myfile.fits[HDU指定A[1-indexedによる領域指定]; ...]
myfile.fits[HDU指定A(0-indexedによる領域指定); ...]

画像の領域またはテーブルの領域は，次元の小さいものから順に記述し，各次元はカンマで区切る．要素について，任意の範囲を指定する場合はコロンを挟んで開始点と終了点を指定し，全範囲を指定する場合は「*」と書いても良い．なお，指定可能な次元数に制限は無い．
```
myfile.fits[HDU指定A[開始点:終了点,*, ...]; ...]
```
HDUのタイプ，HDUのversionを指定する場合は「::」で区切る．
```
myfile.fits[HDUタイプ::HDU名::HDUバージョン[...]; ...]
```
HDUのタイプは「i」「b」「a」でそれぞれImage，バイナリテーブル，ASCIIテーブルを意味する．
「::」で区切られた要素が2つの場合は， HDUタイプが省略されたものとみなす．
HDU指定の直後に「{n}」で読むべきHDUの数を限定できる．
括弧，カンマ，セミコロンの前後の空白は無視される．
HDU名は，EXTNAME の値文字列か数字(常に0-indexed)で指定する．名前指定の場合，シェルのマッチと同一の動作となる．
テーブルのカラムは，名前または数字で指定する．複数のカラムを飛び飛びで指定する場合は，セミコロン区切りで記述する．名前指定の場合，シェルのマッチと同一の動作となる．
画像およびテーブルの行について，指定範囲の表記「A:B」において B < A の場合，あるいは範囲指定の表記が「-*」の場合，オブジェクト内の要素順は逆転する．

使用例

HDU番号が 0,1,4 のもののみ読む．
```
myfile.fits[0;1;4]
```
HDU番号2のもの以外をすべて読む．
```
myfile.fits[-2]
```
文字列マッチ(前方一致)するHDUのみ読む．
```
myfile.fits[EVENT*]
```
文字列マッチするHDUのうち，最初の2つのみ読む．
```
myfile.fits[EVENT*{2}]
```
バイナリテーブルのみ全部読む．
```
myfile.fits[b::*::*]
```
Image HDUの画像の一部分を読む(後者は0-indexed)．
```
myfile.fits[1[1:100,*]]
myfile.fits[1(0:99,*)]
```

画像の反転．

myfile.fits[1[100:1,*]]
myfile.fits[1[-*,*]]

三次元Imageの最初の1枚だけ読む(0-indexed)．
```
myfile.fits[0(*,*,0)]
```

バイナリテーブルの指定(行の指定はImageの場合と同様)．

myfile.fits[EVENT[1:10,1:100]]
myfile.fits[EVENT(0:9,0:99)]
myfile.fits [EVENT [TIME;*TEMP*, 1:100] ]