funjoin - 云端在线

程序：

您的姓名

funjoin - 在指定的列上连接两个或多个 FITS 二进制表

概要

有趣的 [开关] ...

配置

-a cols # 在所有文件中激活的列
-a1 cols ... an cols # 在每个文件中激活的列
-b 'c1:bvl,c2:bv2' # 所有文件中公共列的空白值
-bn 'c1:bv1,c2:bv2' # 特定文件中列的空白值
-j col # 要加入所有文件的列
-j1 col ... jn col # 在每个文件中加入的列
-m min # min 匹配输出一行
-M max # 最大匹配输出一行
-s # 添加'jfiles' 状态列
-S col # 添加 col 作为状态列
-t tol # 加入数字列的容忍度 [仅 2 个文件]

商品描述

有趣的 连接来自两个或更多（最多 32 个）FITS 二进制表文件的行，基于
每个文件中指定连接列的值。 注意：连接列必须有索引
与之关联的文件。 这些文件是使用 乐趣指数 程序。

程序的第一个参数指定第一个输入 FITS 表或原始事件文件。
如果指定了“stdin”，则从标准输入读取数据。 后续参数
指定要加入的其他事件文件和表。 最后一个参数是输出 FITS
文件中。

注意：做 不能 使用 Funtools Bracket Notation 指定 FITS 扩展和行过滤器
运行 funjoin 否则你会得到错误的结果。 使用
直接索引文件，这绕过了所有过滤。

连接列是使用 -j 山坳 开关（指定一个列名
用于所有文件）或与 -j1 col1, -j2 col2... -jn 柯恩 开关（指定一个
用于每个文件的列名）。 必须为每个文件指定一个连接列。 如果两者
-j 山坳 和 -jn 柯恩 为给定文件指定，然后使用后者。 加入列
必须是字符串类型或数字类型； 混合数字和字符串是非法的
给定连接中的列。 例如，要使用相同的键列连接三个文件
每个文件，使用：

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

可以通过这种方式为第三个文件指定不同的键：

funjoin -j key -j3 otherkey in1.适合 in2.适合 in3.适合 out.适合

-a “上校” 开关（和 .A1 “col1”, .A2 “cols2” 对应物）可用于指定
为每个输入文件激活（即写入输出文件）的列。 默认情况下，所有
列是输出。

如果来自不同文件的两列或更多列具有相同的名称，则第二个（及后续）
列被重命名为附加下划线和数值。

-m 分钟 和 -M 最大 开关指定所需的最小和最大连接数
写出一行。 默认最小值是 0 个连接（即所有行都被写出）并且
默认最大值为 63（可能的最大连接数，限制为 32 个输入
文件）。 例如，只写出那些正好有两个文件有列的行
那场比赛（即一个加入）：

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

给定的行可以有必要数量的连接，而无需连接所有文件
（例如，三个文件正在连接，但只有两个文件具有给定的连接键值）。 在这
情况下，未连接文件的所有列都被写出，默认情况下，使用空格
（零或 NULL）。 这 -b c1:bv1,c2:bv2 和 -b1 'c1:bv1,c2:bv2' -b2 'c1:bv1,c2 - bv2' ...
开关可用于设置所有文件和/或列共有的列的空白值
分别在指定的文件中。 每个空值字符串包含一个逗号分隔的列表
列的：blank_val 说明符。 对于浮点值（单精度或双精度），一个 case-
“nan”的不敏感字符串值意味着应使用 IEEE NaN（非数字）。
因此，例如：

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

意味着任何文件中的非连接 AKEY 列将包含字符串“???”，非连接
加入文件 1 的 A 列将包含值 -1，文件 3 的未加入 G 列
将包含 IEEE NaN，而同一文件的非连接 E 和 F 列将包含
值分别为 -1 和 -100。 当然，常见和特定的空白值在哪里
为同一列指定，则使用特定的空白值。

为了区分哪些文件是给定行的非空白组件， -s （状态）开关
可用于将名为“JFILES”的位掩码列添加到输出文件。 在本专栏中，一个
为组成给定行的每个非空白文件设置位，位 0 对应于
第一个文件，位 1 到第二个文件，依此类推。 文件名本身存储在
FITS 标头作为名为 JFILE1、JFILE2 等的参数。 -S 山坳 开关允许你
将状态列的名称从默认的“JFILES”更改。

行之间的连接是具有给定连接的一个文件中所有行的笛卡尔积
列值，第二个文件中的所有行的连接列都具有相同的值，并且
很快。 因此，如果文件 1 有 2 行连接列值为 100，则文件 2 有 3 行
相同的值，并且 file3 有 4 行，则连接结果为 2*3*4=24 行被输出。

连接算法直接处理与连接列关联的索引文件
每个文件。 选择当前所有列的最小值作为基数，这个
value 用于连接其他文件中的等值列。 这样，索引
文件只遍历一次。

-t TOL 开关指定数字列的容差值。 目前，一个
容差值一次只能连接两个文件。 （一个完全不同的算法是
需要使用容差连接两个以上的文件，我们可能会考虑
将来实施。）

以下示例显示了 funjoin 的许多功能。 输入文件 t1.fits，
t2.fits 和 t3.fits 包含以下列：

[sh]fundisp t1.fits
AKEY AB
————————————————————————
0 0 1
BB 1 3 4
抄送 2 6 7
滴滴 3 9 10
ee 4 12 13
5 15 16
嘎嘎 6 18 19
7 21 22

Fundisp t2.fits
AKEY KEY CD
————————————————————————
三 8 24 25
嘎嘎 6 18 19
ee 4 12 13
抄送 2 6 7
0 0 1

Fundisp t3.fits
AKEY KEY EFG ------------ ------ -------- --------
-----------
格格 6 18 19 100.10
jjj 9 27 28 200.20
AAA 0 0 1 300.30
滴滴 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（在
t2.fits）和 E（在 t3.fits 中），并为 AKEY 设置空白值（全局，但被覆盖
对于 t1.fits) 和 A（在文件 1 中）和 G、E 和 F（在文件 3 中）。 JFILES 列将是
输出以标记每行中使用了哪些文件：

AKEY KEY A AKEY_2 KEY_2 C AKEY_3 KEY_3 FG JFILES
------------ ------ ------ -------------- ------ ------ -- ---------- ------ -------- ----------- --------
AAA 0 0 AAA 0 0 AAA 0 1 300.30 7
bbb 1 3 ??? 0 0 ??? 0 -100 南 1
ccc 2 6 ccc 2 6 ??? 0 -100 南 3
滴滴 3 9 ？？？ 0 0 ddd 3 10 400.40 5
ee 4 12 ee 4 12 ??? 0 -100 南 3
fff 5 15 ??? 0 0 ??? 0 -100 南 1
格格 6 18 格格 6 18 格格 6 19 100.10 7
hhh 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