funcone - クラウドでオンライン

プログラム：

NAME

funcone - RA、Dec 列を含むバイナリ テーブルのコーン検索

SYNOPSIS

ファンコーン [コラム]

OPTIONS

-d deccol:[hdr] # Dec 列名、単位 (def: DEC:d)
-j # リストファイルから列を結合します
-J # リストファイルの列を結合し、すべての行を出力します
-l listfile # リストから中心と半径を読み取る
-L listfile # リストから中心と半径を読み取り、リスト行を出力します
-n # コーン制限をフィルターとして使用しません
-r racol:[hdr] # RA カラム名、単位 (def: RA:h)
-x # RA_CEN、DEC_CEN、RAD_CEN、CONE_KEY 列を追加します
-X # RA_CEN、DEC_CEN、RAD_CEN、CONE_KEY 列を追加し、すべての行を出力します

DESCRIPTION

Funcone は、FITS バイナリ テーブルの RA 列と Dec 列に対して円錐検索を実行します。 の
表の各行の中心赤経赤赤位置から赤経赤赤までの距離は、
計算された。 距離が指定した半径未満の行が出力されます。

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

XNUMX 番目と XNUMX 番目の必須引数は、赤経と赤経の中心位置です。 デフォルトでは、
赤経は時間で指定され、赤経は度で指定されます。 単位を変更できます
これらのいずれかを文字「d」 (度)、「h」 (時間)、または「r」 (ラジアン) に追加します。
XNUMX 進表記がサポートされており、hms と dms はコロンまたはスペースで区切られます。 （いつ
スペースを使用する場合は、文字列全体が引用符で囲まれていることを確認してください。)

XNUMX 番目の必須引数は、コーン検索の半径です。 デフォルトでは、半径の値は
度で与えられます。 単位は文字「d」（度）を追加することで変更できます。
「r」(ラジアン)、「'」(分角)、または「"」(秒)。

デフォルトでは、入力ファイルのすべての列が出力ファイルにコピーされます。 選択された列
オプションの XNUMX 番目の引数を次の形式で使用して出力できます。

"column1 column1 ... columnN"

XNUMX 番目の引数を使用すると、次の場合にリスト ファイルから選択した列を出力できます。 -j スイッチ
使用されている。 円錐の計算で使用される赤経および赤経の列は、
選択が解除されました。

また、デフォルトでは、RA と Dec の列名は「RA」と「Dec」という名前になり、次のように指定されます。
それぞれ時間と度の単位。 次を使用して、名前と単位の両方を変更できます。
-r [RA] および/または -d [Dec] スイッチ。 再度、「h」「d」「r」のいずれかが付加されます。
単位を指定する列名ですが、この場合、列名の間にコロン「:」が必要です。
名前と単位の仕様。

Status -l [リストファイル] スイッチが使用されている場合、センター RA、センター Dec、および
radius はリスト ファイル (FITS テーブルまたは ASCII 列テキストにすることができます) から取得できます。
ファイル）。 この場合、XNUMX 番目 (赤経中心)、XNUMX 番目 (赤経中心)、XNUMX 番目 (半径)
コマンド ライン引数は、リスト ファイル内の列名にすることができます (そのパラメータが指定されている場合)
変化します)、または数値 (そのパラメーターが静的な場合)。 カラム名が
赤経、赤緯、または半径に指定した場合は、コロンの後に「h」、「d」、または「r」を追加できます。
単位を指定します (半径の ' と " も)。円錐検索アルゴリズムは、それぞれに対して XNUMX 回実行されます。
リスト内の行、指定された列またはからの赤経、赤経、および半径の値を取得します。
コマンドラインで指定された静的な数値。

リストを使用する場合、各反復からのすべての有効な行が XNUMX つの出力ファイルに書き込まれます。
-x リスト ファイルのどの行が、
指定された出力行。 このスイッチにより、中心の赤経、赤経、半径、および
出力ファイルに追加される行番号 (RA_CEN、DEC_CEN、RAD_CEN という列)
と CONE_KEY をそれぞれ指定します。 あるいは、 -j (結合) スイッチはすべての列を追加します
リスト行から出力行まで (基本的にはリスト行と入力行の結合)、
CONE_KEY 行番号とともに。 これら XNUMX つのスイッチは相互に排他的です。

　 -X および -J スイッチは、それぞれの小文字の対応するものと同じデータを書き込みます。
コーンサーチを満たす行。 さらに、これらのスイッチは、
コーン検索を満たさないイベント ファイル。 このような場合、その CONE_KEY 列は
-1 の値が与えられ、中心とリストの位置情報は XNUMX に設定されます。
指定された行に対して。 したがって、入力イベント ファイルのすべての行が出力されることが保証されます。
追加の検索情報を持つ少なくとも XNUMX つのコーン検索を満たす行を含む。

　 -L スイッチは次のように動作します。 -l リストファイルから中心を取得するという点で変わります。
ただし、-j スイッチも暗黙的に設定されるため、出力行は行の結合となります。
入力イベント行と中心位置行。 さらに、このスイッチはすべてのデータを書き込みます。
その行のコーン検索基準を満たすイベントがない中心位置行。
CONE_KEY 列には、どの列にも近づかなかった中央行の値 -2 が与えられます。
データ行とイベント列はそのような行に対してゼロに設定されます。 このようにして、すべてのセンターが
行は少なくとも XNUMX 回は出力されることが保証されます。

「全行」のいずれかが切り替わった場合（-X, -Jまたは -L) が指定されている場合、JSTAT という名前の新しい列が指定されます。
が出力テーブルに追加されます。 この列の正の値は中心を示します
このデータ行が成功したリスト ファイル内の行番号 (1 から始まる) の位置
コーン検索で一致しました。 値 -1 は、データ行がどの中心とも一致しなかったことを意味します
位置。 値 -2 は、中心位置がどのデータ行とも一致しなかったことを意味します。

中心位置と半径が与えられると、円錐探索アルゴリズムが限界パラメーターを計算します。
指定された円錐を囲むボックスに対して、位置の値が存在する行のみをテストします
その制限内で。 小さいファイルの場合、このコーン制限に関連するオーバーヘッドは
フィルタリングにより、すべてのイベントをテストした場合よりもプログラムの実行が遅くなる可能性があります。 あなたはできる
を使用してコーン制限フィルタリングをオフにします。 -n 切り替えて処理が高速化されるかどうかを確認します
(ポジションの大きなリストを処理する場合に特に便利です)。

たとえば、デフォルトのコーン検索では、時間と度の列「RA」と「Dec」が使用されます。
（それぞれ）および赤経位置（時間単位）、赤経および半径（度単位）：

フノン 内側にフィット 外側にフィット 23.45 34.56 0.01

RA 位置を度単位で指定するには:

ファンコーン 内側にフィット 外側にフィット 23.45d 34.56 0.01

リストから赤経と赤経を取得しますが、半径には静的な値を使用します (また、
リスト内の各行の識別情報):

funcone -x -l list.txt in.fits out.fits MYRA MYDec 0.01

ユーザー指定の列 (度単位)、赤経位置 (時間単位) (XNUMX 進法)、XNUMX 月
度単位の位置 (XNUMX 進数表記) と円弧分単位の半径:

funcone -r myRa:d -d myDec in.fits out.fits 12:30:15.5 30:12 15'

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