funcone - 云端在线

程序：

您的姓名

funcone - 包含 RA、Dec 列的二进制表的锥形搜索

概要

功能 [列]

配置

-d deccol:[hdr] # 十进制列名，单位 (def: DEC:d)
-j # 连接列表文件中的列
-J # 连接列表文件中的列，输出所有行
-l listfile # 从列表中读取中心和半径
-L listfile # 从列表中读取中心和半径，输出列表行
-n # 不要使用锥形限制作为过滤器
-r racol:[hdr] # RA 列名，单位（定义：RA:h）
-x # 附加 RA_CEN、DEC_CEN、RAD_CEN、CONE_KEY cols
-X # 追加 RA_CEN、DEC_CEN、RAD_CEN、CONE_KEY cols，输出所有行

商品描述

Funcone 对 FITS 二进制表的 RA 和 Dec 列执行锥搜索。 这
表中每一行从中心 RA、Dec 位置到 RA、Dec 的距离为
计算。 输出距离小于指定半径的行。

程序的第一个参数指定 FITS 文件、原始事件文件或原始数组
文件。 如果指定了“stdin”，则从标准输入读取数据。 使用 Funtools
用于指定 FITS 扩展和过滤器的括号表示法。 第二个论点是
输出 FITS 文件。 如果指定了“stdout”，则将 FITS 二进制表写入
标准输出。

第三个和第四个必需参数是 RA 和 Dec 中心位置。 默认情况下，
RA 以小时为单位指定，而 Dec 以度为单位指定。 您可以更改单位
通过附加字符“d”（度）、“h”（小时）或“r”（弧度）来实现。
支持十六进制表示法，用冒号或空格分隔 hms 和 dms。 （什么时候
使用空格，请确保整个字符串都被引用。）

第五个必需参数是锥形搜索的半径。 默认情况下，半径值
以度为单位。 可以通过附加字符“d”（度）来更改单位，
"r"（弧度）、"'"（弧分）或 '"'（弧秒）。

默认情况下，输入文件的所有列都被复制到输出文件中。 选定的列
可以使用以下形式的可选第六个参数输出：

“column1 column1 ... columnN”

第七个参数允许您在以下情况下从列表文件中输出选定的列 -j 开关
用来。 请注意，锥计算中使用的 RA 和 Dec 列不得为
取消选择。

同样默认情况下，RA 和 Dec 列名称被命名为“RA”和“Dec”，并在
分别以小时和度为单位。 您可以使用更改名称和单位
-r [RA] 和/或 -d [Dec] 开关。 再一次，将“h”、“d”或“r”之一附加到
用于指定单位的列名，但在这种情况下，列名之间必须有一个冒号“:”
名称和单位规格。

如果 -l [列表文件] 使用开关，然后中心 RA、中心 Dec 和
半径可以从列表文件中获取（可以是 FITS 表或 ASCII 列文本
文件）。 在这种情况下，第三个（中心 RA）、第四个（中心 XNUMX 月）和第五个（半径）
命令行参数可以是列表文件中的列名（如果该参数
变化）或数字值（如果该参数是静态的）。 当列名是
为 RA、Dec 或半径指定，您可以附加一个冒号，后跟“h”、“d”或“r”
指定单位（还有 ' 和 " 用于半径）。锥形搜索算法为每个运行一次
列表中的行，从指定的列或从
在命令行上指定的静态数值。

使用列表时，每次迭代中的所有有效行都将写入单个输出文件。
使用 -x 切换以帮助描述列表文件的哪一行用于生成
给定的输出行。 此开关会导致中心 RA、Dec、半径和
要附加到输出文件的行号，在名为 RA_CEN、DEC_CEN、RAD_CEN 的列中
和 CONE_KEY，分别。 或者， -j (join) 开关将追加所有列
从列表行到输出行（本质上是列表行和输入行的连接），
连同 CONE_KEY 行号。 这两个开关是互斥的。

-X 和 -J 开关写出与每个小写对应物相同的数据
满足锥搜索的行。 此外，这些开关还从
不满足任何锥搜索的事件文件。 在这种情况下，该 CONE_KEY 列将
被赋予 -1 的值，并且中心和列表位置信息将被设置为零
对于给定的行。 因此，输入事件文件的所有行都保证被输出，
满足至少一个锥搜索的行具有额外的搜索信息。

-L 开关的作用类似于 -l 切换到它从列表文件中获取中心。
但是，它还隐式设置了 -j 开关，以便输出行是
输入事件行和中心位置行。 另外，这个开关还写出所有
没有事件满足该行的锥搜索标准的中心位置行。
CONE_KEY 列的值将为 -2 的中心行不接近任何
对于这些行，数据行和事件列将被清零。 这样，所有中心
行保证至少输出一次。

如果任何“所有行”切换（-X, -J或 -L) 被指定，然后一个名为 JSTAT 的新列
被添加到输出表中。 此列中的正值表示中心
此数据行成功的列表文件中的位置行号（从 1 开始）
在锥形搜索中匹配。 值为 -1 表示数据行不匹配任何中心
位置。 值为 -2 表示中心位置未与任何数据行匹配。

给定中心位置和半径，锥搜索算法计算极限参数
对于包围指定锥体的框，仅测试位置值位于的行
在这些范围内。 对于小文件，与此锥体限制相关的开销
与测试所有事件相比，过滤会导致程序运行得更慢。 你可以
使用 -n 切换以查看这是否会加快处理速度
（在处理大量职位列表时特别有用）。

例如，默认的锥形搜索使用以小时和度为单位的“RA”和“Dec”列
（分别）和以小时为单位的 RA 位置、以度为单位的 Dec 和半径：

funone 内.适合 外.适合 23.45 34.56 0.01

要以度数指定 RA 位置：

funcone 内.适合 外.适合 23.45d 34.56 0.01

要从列表中获取 RA 和 Dec 但对半径使用静态值（并且还写
列表中每一行的标识信息）：

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

用户以度为单位指定的列，以小时为单位的 RA 位置（十六进制表示法），XNUMX 月
以度为单位的位置（十六进制表示法）和以弧分为单位的半径：

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

使用 onworks.net 服务在线使用 funcone