funtable-クラウドでのオンライン

プログラム：

NAME

funtable-選択した行をFuntoolsファイルからFITSバイナリテーブルにコピーします

SYNOPSIS

ファンタブル [-a] [-i⎪-z] [-m] [-s cols] [列]

OPTIONS

-a＃テーブル拡張として既存の出力ファイルに追加
-i＃画像データの場合、X列とY列のみを生成します
-m＃テーブルの場合、リージョンごとに個別のファイルを書き込みます
-s "col1 ..."＃並べ替える列
-z＃画像データの場合、ゼロ値のピクセルを出力します

DESCRIPTION

ファンタブル FITSの指定されたFITS拡張機能（バイナリテーブルのみ）から行を選択します
ファイル、または非FITS生イベントファイルから、それらの行をFITSバイナリテーブルに書き込みます
ファイル。 また、画像または生の配列ファイルからFITSバイナリテーブルを作成します。

プログラムの最初の引数は、FITSファイル、rawイベントファイル、またはraw配列を指定します
ファイル。 「stdin」を指定すると、標準入力からデータが読み込まれます。 Funtoolsを使用する
FITS拡張機能とフィルターを指定するための括弧表記。 XNUMX番目の引数は
FITSファイルを出力します。 「stdout」が指定されている場合、FITSバイナリテーブルは
標準出力。 デフォルトでは、入力ファイルのすべての列が出力ファイルにコピーされます。
選択した列は、オプションのXNUMX番目の引数を使用して次の形式で出力できます。

"column1 column1 ... columnN"

　 ファンタブル プログラムは通常、テーブルを使用してFITSバイナリテーブルから行を選択するために使用されます
フィルタおよび/または空間領域フィルタ。 たとえば、選択した行のみをコピーできます（および
次のようなコマンドで実行して、選択した列のみを出力します）。

[sh] funtable "test.ev [pha == 1 && pi == 10]" stdout "xy pipha"⎪fundispstdin
XY PHA PI
------- ------- ------- ---------
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10

特別コラム $ REGION 各行のリージョンIDを書き込むように指定できます。

[sh $] funtable "test.ev [time-（int）time> =。99 && annulus（0 0 0 10 n = 3）]" stdout'xy time $REGION'⎪fundispstdin
XY時間領域
-------- -------- ---------- ----------
5 -6 40.99000000 3
4 -5 59.99000000 2
-1 0 154.99000000 1
-2 1 168.99000000 1
-3 2 183.99000000 2
-4 3 199.99000000 2
-5 4 216.99000000 2
-6 5 234.99000000 3
-7 6 253.99000000 3

ここでは、適切な小数時間で、その位置もXNUMXつ以内にある行のみです。
XNUMXつの環が書かれています。

列の前にマイナス記号を使用すると、列を表示から除外できます。

[sh $] funtable "test.ev [time-（int）time> =。99]" stdout "-time"⎪fundispstdin
XY PHA PI DX DY
-------- -------- -------- ---------- ----------- ----- ------
5-6 5-6 5.50-6.50
4-5 4-5 4.50-5.50
-1 0 -1 0 -1.50 0.50
-2 1 -2 1 -2.50 1.50
-3 2 -3 2 -3.50 2.50
-4 3 -4 3 -4.50 3.50
-5 4 -5 4 -5.50 4.50
-6 5 -6 5 -6.50 5.50
-7 6 -7 6 -7.50 6.50

時間列を除くすべての列が書き込まれます。

一般に、列をアクティブ化および非アクティブ化するためのルールは次のとおりです。

・除外列のみが指定されている場合、除外列を除くすべての列は
有効化されます。

・インクルード列のみが指定されている場合は、指定された列のみがアクティブ化されます。

・包含列と除外列の混合が指定されている場合、除外以外のすべて
列がアクティブになります。 この最後のケースはあいまいであり、ルールは任意です。

列名を明示的に指定することに加えて、特別な記号 + & - することができます
アクティブ化および非アクティブ化に使用されます を 列。 これは、アクティベートする場合に便利です。
$ REGION列と他のすべての列。 ルールに従って、構文「$ REGION」
領域列のみをアクティブにし、残りを非アクティブにします。 「+ $ REGION」を使用してアクティブ化します
すべての列とリージョン列。

通常、選択したテーブルのみが出力ファイルにコピーされます。 FITSバイナリテーブルでは、
他のすべてのFITS拡張機能を次のように出力ファイルにコピーすることが望ましい場合があります。
良い。 これは、入力の拡張子の名前に「+」記号を追加することで実行できます。
ファイル名。 たとえば、以下の最初のコマンドはEVENTテーブルのみをコピーしますが、
XNUMX番目のコマンドは、他の拡張機能もコピーします。

[sh] funtable "/proj/rd/data/snr.ev [EVENTS]" events.ev
[sh] funtable "/proj/rd/data/snr.ev [EVENTS +]" eventsandmore.ev

入力ファイルが画像または生の配列ファイルの場合、 ファンタブル FITSを生成します
画像のピクセル値からのバイナリテーブル。 指定することはできませんのでご注意ください
出力する列（コマンドライン引数3を使用）。 代わりに、XNUMXつの方法があります
画像からそのようなバイナリテーブルを作成します。 デフォルトでは、3列のテーブルが生成されます。
列は「X」、「Y」、および「VALUE」です。 画像のピクセルごとに、単一の行（イベント）
画像のdim1とdim2の値が割り当てられた「X」列と「Y」列で生成されます
それぞれピクセルと「VALUE」列にピクセルの値が割り当てられています。 ある種の
テーブル、実行中 ファンヒスト 「値」列で実行すると同じ結果が得られます ファンヒスト
元の画像に。

Status -i （「個別」行）スイッチが指定されている場合、「X」列と「Y」列のみが指定されます。
生成されます。 この場合、画像内の各正のピクセル値はn行（イベント）を生成します。
ここで、nはそのピクセルの整数値に等しい（浮動小数点の場合は0.5を加えたもの）
データ）。 事実上、 -i テーブルの行をほぼ再作成します
入力画像にビニングされます。 （もちろん、これはおおよそ正しいだけです。
結果のx、y位置は整数化されます。）

Status -s [col1 col2 ... コロン] （ "sort"）スイッチが指定されている場合、バイナリの出力行
テーブルは、指定された列を並べ替えキーとして使用して並べ替えられます。 ソートキーは
スカラー列であり、出力ファイルの一部である必要があります（つまり、列で並べ替えることはできません）
ただし、出力には含めないでください）。 この施設は _選別 プログラム（に含まれています
funtools）、パスからアクセスできる必要があります。

バイナリテーブルの場合、 -m （「複数のファイル」）スイッチは、それぞれに個別のファイルを生成します
フィルタ仕様の領域。つまり、各ファイルにはその領域の行のみが含まれます。
フィルタを通過したがどの領域にも属していない行も、別のファイルに入れられます。

によって生成された個別の出力ファイル名 -m スイッチはから自動的に生成されます
関連するリージョンのリージョンIDを含むルート出力ファイル。 （その地域に注意してください
idは1から始まるため、id 0に関連付けられたファイル名には、
フィルタしますが、特定の領域にはありません。）出力ファイル名は次のように生成されます。

・$ n仕様は、ルートファイル名のどこでも使用できます（適切に引用されている
シェルから保護します）、関連付けられたID番号になるように拡張されます
領域。 例えば：

funtable -m input.fits '[cir（512,512,1）; cir（520,520,1）...]' 'foo.goo_ $ n.fits'

foo.goo_0.fitsという名前のファイルを生成します（どのリージョンにも存在しないが、通過する行の場合）
フィルタ）、foo.goo_1.fits（リージョンID＃1の行、最初のリージョン）、foo.goo_2.fits
（リージョンID＃2の行）など。出力ルートには一重引用符が必要であることに注意してください。
'$'をシェルから保護します。

・$ nが指定されていない場合、リージョンIDはの最初のドット（。）の前に配置されます。
ファイル名。 したがって：

funtable -m input.fits '[cir（512,512,1）; cir（520,520,1）...]' foo.evt.fits

foo0.evt.fitsという名前のファイルを生成します（どのリージョンにも存在しないが、通過する行の場合）
フィルタ）、foo1.evt.fits（リージョンID＃1の行）、foo2.evt.fits（リージョンIDの行）
＃2）など

・ルート出力ファイル名にドットが指定されていない場合、リージョンIDは次のようになります。
ファイル名に追加されます。 したがって：

funtable -m input.fits '[cir（512,512,1）; cir（520,520,1）...]' 'foo_evt'

foo_evt0という名前のファイルを生成します（どのリージョンにも存在しないが、
filter）、foo_evt1（リージョンID＃1の行）、foo_evt2（リージョンID＃2の行）など。

複数ファイルメカニズムは、個々のソースデータファイルを生成する簡単な方法を提供します
データをXNUMX回通過します。

デフォルトでは、新しいFITSファイルが作成され、バイナリテーブルが最初のファイルに書き込まれます
拡大。 の場合 -a （追加）スイッチが指定されている場合、テーブルは既存のものに追加されます
BINTABLE拡張子としてのFITSファイル。 出力FITSファイルがすでに存在している必要があることに注意してください。

Status -z （「ゼロ」ピクセル値）スイッチが指定され、 -i 指定されていない場合、ピクセル
値がゼロの場合、「VALUE」列がゼロに設定されて出力されます。 明らかに、これは
個々のイベントが出力される場合、スイッチは意味がありません。

onworks.netサービスを使用してオンラインでfuntableを使用する