funjoin - クラウド上のオンライン

プログラム：

NAME

funjoin - 指定された列で2つ以上のFITSバイナリテーブルを結合する

SYNOPSIS

ファンジョイン [スイッチ] ...

OPTIONS

-a cols # すべてのファイルで有効にする列
-a1 cols ... an cols # 各ファイルで有効にする列
-b 'c1:bvl,c2:bv2' # すべてのファイルの共通列の値は空白
-bn 'c1:bv1,c2:bv2' # 特定のファイル内の列の空白値
-j col # すべてのファイルに結合する列
-j1 col ... jn col # 各ファイルで結合する列
-m min # 行を出力する最小一致数
-M max # 1行に出力するマッチの最大数
-s # 'jfiles' ステータス列を追加
-S col # ステータス列として col を追加
-t tol # 数値列の結合の許容範囲 [2ファイルのみ]

DESCRIPTION

ファンジョイン 32つ以上（最大XNUMX個）のFITSバイナリテーブルファイルの行を、
各ファイルの指定された結合列の値。注：結合列にはインデックスが必要です
関連ファイル。これらのファイルは、 ファンインデックス プログラム。

プログラムの最初の引数は、最初の入力 FITS テーブルまたは生のイベント ファイルを指定します。
「stdin」が指定された場合、データは標準入力から読み込まれます。後続の引数
結合する追加のイベントファイルとテーブルを指定します。最後の引数は出力FITSです。
ファイルにソフトウェアを指定する必要があります。

注意： Funtools Bracket Notationを使用してFITS拡張と行フィルタを指定します。
funjoinを実行しないと間違った結果が返されます。行は次のようにアクセスされ結合されます。
ファイルを直接インデックスし、すべてのフィルタリングをバイパスします。

結合列は、 -j コル スイッチ（列名を指定する）
すべてのファイルに使用する）または -j1 col1, -j2 col2、 ... -jn コルン スイッチ（
各ファイルに使用する列名）。結合列は各ファイルごとに指定する必要があります。
-j コル 　 -jn コルン 特定のファイルに指定されている場合は、後者が使用されます。結合列
文字列型または数値型のいずれかである必要があります。数値型と文字列型を混在させることは許可されていません。
特定の結合で同じキー列を使用する3つのファイルを結合する場合、
各ファイルでは以下を使用します:

funjoin -j キー in1.fits in2.fits in3.fits out.fits

3 番目のファイルには、次のように別のキーを指定できます。

funjoin -j key -j3 otherkey in1.fits in2.fits in3.fits out.fits

当学校区の -a 「コル」 スイッチ（および .A1 「列1」, .A2 「列2」 対応するもの）を使用して指定することができます
各入力ファイルに対してアクティブにする（つまり出力ファイルに書き込む）列。デフォルトでは、すべての
列が出力されます。

別々のファイルにある2つ以上の列が同じ名前を持つ場合、2番目（およびそれ以降）の列は
列の名前が変更され、アンダースコアと数値が追加されます。

当学校区の -m 分 　 -M マックス スイッチは、必要な結合の最小数と最大数を指定します。
行を書き出します。デフォルトの最小値は0結合（つまりすべての行が書き出される）で、
デフォルトの最大値は63（入力の制限が32の場合の結合の最大数）です。
例えば、ちょうど2つのファイルに列がある行だけを書き出すには、
一致するもの（つまり、1つの結合）:

funjoin -j key -m 1 -M 1 in1.fits in2.fits in3.fits ... out.fits

特定の行には、すべてのファイルが結合されていなくても、必要な数の結合を含めることができます。
（例えば、3つのファイルを結合するが、結合キーの値を持つのは2つだけである）。
この場合、結合されていないファイルのすべての列は、デフォルトで空白を使用して書き出されます。
（ゼロまたはNULL）。 -b c1:bv1、c2:bv2 および -b1 'c1:bv1,c2:bv2' -b2 'c1:bv1,c2 - bv2' ...
スイッチを使用して、すべてのファイルや列に共通の列に空白の値を設定できます。
指定されたファイル内のそれぞれ。各空白値文字列には、カンマ区切りのリストが含まれます。
column:blank_val指定子。浮動小数点値（単精度または倍精度）の場合、大文字と小文字は区別されません。
「nan」の非敏感な文字列値は、IEEE NaN (非数) を使用する必要があることを意味します。
したがって、たとえば次のようになります。

funjoin -b "AKEY:???" -b1 "A:-1" -b3 "G:NaN,E:-1,F:-100" ...

つまり、どのファイルでも結合されていないAKEY列には文字列「???」が含まれ、
ファイル1の結合されたA列には-1の値が含まれ、ファイル3の結合されていないG列には-XNUMXの値が含まれ
IEEE NaNが含まれますが、同じファイルの結合されていないE列とF列には、
それぞれ-1と-100の値です。もちろん、共通空白値と特定の空白値は
同じ列に指定されている場合は、特定の空白値が使用されます。

特定の行の空白でないコンポーネントであるファイルを区別するために、 -s （ステータス）スイッチ
出力ファイルに「JFILES」というビットマスク列を追加することができます。この列には、
ビットは、指定された行を構成する空白でないファイルごとに設定され、ビット0は
最初のファイルにビット1、XNUMX番目のファイルにビットXNUMX、というように続きます。ファイル名自体は
FITSヘッダーにJFILE1、JFILE2などのパラメータとして追加されます。 -S コル スイッチを使用すると
ステータス列の名前をデフォルトの「JFILES」から変更します。

行間の結合は、1つのファイル内のすべての行の特定の結合の直積です。
2番目のファイルのすべての行の結合列の値が同じで、
など。つまり、ファイル1に結合列の値が2の行が100行ある場合、ファイル2には結合列の値が3の行がXNUMX行ある。
同じ値で、file3 に 4 行がある場合、結合の結果、2 * 3 * 4 = 24 行が出力されます。

結合アルゴリズムは、結合列に関連付けられたインデックスファイルを直接処理します。
各ファイルで、現在のすべての列の最小値が基準として選択され、これが
値は他のファイル内の同じ値の列を結合するために使用されます。このようにして、インデックスは
ファイルは正確に 1 回だけ走査されます。

当学校区の -t 通行料 スイッチは数値列の許容値を指定します。現在、
許容値により、一度に2つのファイルしか結合できません。（全く異なるアルゴリズムは
許容差を使用して2つ以上のファイルを結合する必要がある。これは考慮すべき事項である。
今後実装予定です。

次の例は、funjoinの多くの機能を示しています。入力ファイルt1.fits、
t2.fits と t3.fits には次の列が含まれています。

[sh] fundisp t1.fits
AKEY KEY AB
----------- ------ ------ ------
ああ 0 0 1
1 3 4
ccc 2 6 7
3 9 10日
イー 4 12 13
fff 5 15 16
ggg 6 18 19
時 7 21 22

fundisp t2.fits
AKEY KEY CD
----------- ------ ------ ------
8 24 25ページ
ggg 6 18 19
イー 4 12 13
ccc 2 6 7
ああ 0 0 1

fundisp t3.fits
AKEY KEY EFG ------------ ------ -------- --------
-----------
ggg 6 18 19 100.10
jjj 9 27 28 200.20
aaa 0 0 1 300.30
ddd 3 9 10 400.40

これらの入力ファイルを指定すると、次の funjoin コマンドが実行されます。

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
「エイキー：？？」 -b1 "AKEY:XXX,A:255" -b3 "G:NaN,E:-1,F:-100" \
-j キー t1.fits t2.fits t3.fits foo.fits

KEY列でファイルを結合し、B列（t1.fits内）、D列（tXNUMX.fits内）を除くすべての列を出力します。
t2.fits)とE(t3.fits)、AKEY(グローバルだが上書き)に空白値を設定する
t1.fitsのA（ファイル1）、G、E、F（ファイル3）です。JFILES列は
各行で使用されたファイルをフラグ付けする出力:

AKEY キー A AKEY_2 KEY_2 C AKEY_3 KEY_3 FG JFILES
------------ ------ ------ ------ ------------ ------ ----------- -------- --------- --------
ああ 0 0 ああ 0 0 ああ 0 1 300.30 7
bbb 1 3 ??? 0 0 ??? 0～100ナン1
ccc 2 6 ccc 2 6 ??? 0～100ナン3
ddd 3 9 ??? 0 0 ddd 3 10 400.40 5
ええ 4 12 ええ 4 12 ??? 0～100ナン3
fff 5 15 ??? 0 0 ??? 0～100ナン1
ggg 6 18 ggg 6 18 ggg 6 19 100.10 7
ああ、7 21 ??? 0 0 ??? 0～100ナン1
XXX 0 255 iii 8 24 ??? 0～100ナン2
XXX 0 255 ??? 0 0 jjj 9 28 200.20 4

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