ARTS工具

用于处理Apertif射电瞬态系统数据的脚本。

依赖关系

• python >= 3.6
• numpy >= 1.17
• astropy
• psrqpy
• python-irodsclient (可选)
• psrdada-python (仅用于将原始IQUV数据转换为PSRFITS)
• dadafits (仅用于将原始IQUV数据转换为PSRFITS)

安装

pip install arts_tools
或
pip install arts_tools[irods]
以包含从存档直接下载文件所需的iRODS工具（仅限ASTRON内部使用）。

用法

以下给出本软件包中包含的脚本的概述。每个脚本都具有-h选项，列出所有可用选项。

对于那些喜欢在Python中使用这些工具的人，所有函数及其用法概述可在https://loostrum.github.io/arts_tools找到。

在Apertif视场中寻找已知的脉冲星

要查找给定指向的视场中的脉冲星，请运行arts_find_pulsars_in_field --ra hh:mm:ss.s --dec dd:mm:ss.s。此工具还会打印出脉冲星应在哪个复合束中，因此您只需从存档下载这些CB，而不是整个观测。
要将具有频率和时间相关指向的关联数组束数据转换为跟踪天空中单一点的单点束，请使用arts_tracking_beams。

从Apertif长期存档（ALTA）下载文件

观测通过唯一的任务ID进行标识。要将单个复合束的所有关联阵列束下载到当前目录，请运行arts_download_from_alta --taskid <taskid> --cbs <cb_index>。默认数据发布为2019年科学验证活动(SVC)。要更改此设置，请使用--release选项。

要使用iRODS直接从ALTA下载数据，请使用--release internal。这要求用户已经设置了与ALTA通信的iRODS环境。

读取参数集

FITS头文件包含编码的观测参数集。要打印参数集，请使用arts_read_parameterset file.fits。它也可以在Python中以字典的形式加载

from arts_tools import read_parameterset
parset = read_parameterset('/path/to/file.fits')

注意，所有值都按字符串读取。

修复存档FITS文件

注意：存档中的FITS文件已经修复，无需在下载的数据上运行此脚本。

从2020年4月8日之前从ALTA检索的FITS文件可以使用arts_fix_fits_from_before_20200408 file.fits进行读取。这些修复已应用

1. 头部中的NAXIS2值从零更改为正确值
2. 数据大小以字节为单位表示，而不是比特
3. 数据频率和时间轴已交换
4. 数据和权重、标度、偏移和频率列的频率顺序已颠倒

默认情况下，脚本将_fixed附加到文件名。运行arts_fix_fits_from_before_20200408 -h以获取更多选项。

关于科学验证活动数据的说明

在SVC的数据中，某些情况下NAXIS2值是正确的。但是，其他修复仍需要应用。可以通过运行arts_fix_fits_from_before_20200408 --force file.fits来强制执行。

将原始IQUV数据转换为PSRFITS

IQUV数据最初以PSRDADA的dada_dbdisk的原始形式写入磁盘。要使用dadafits将这些转换为PSRFITS，请使用arts_psrdada_iquv_to_fits --sb <空格分隔的合成束列表> --output_dir <输出目录> <输入psrdada文件>。脚本也可以写入所有关联阵列束。为此，请指定--tab而不是--sb。如果--sb是psrdada文件路径之前的最后一个选项，请添加--，如下所示：arts_psrdada_iquv_to_fits --sb 35 36 -- input.dada，否则输入文件将被添加到SB列表中，脚本将崩溃。运行arts_psrdada_iquv_to_fits -h以获取更多选项。