tart2ms

将来自TART射电望远镜的数据转换为测量集格式。此模块依赖于优秀的dask-ms模块作为辅助工具来创建测量集。此软件包要求您的系统上安装python-casacore

安装

sudo aptitude install python3-casacore
sudo pip3 install tart2ms

示例

通过RESTful API实时下载TART的数据（默认使用https://tart.elec.ac.nz/signal）

tart2ms --ms data.ms

将之前下载的JSON文件转换为测量集（MS）

tart2ms --json data.json --ms data.ms

基于JSON的数据集目前可能只包含单个时间戳。这在更通用的成像方面限制了它们的有用性。可以通过将多个单次导出的json数据库连接起来来制作一个连接数据库，例如。

tart2ms --json ../tart_data/NZ_2022_10_19_json/*.json

HDF5格式存档文件可能包含多个时间戳，也可以像JSON存档文件一样连接成更长的观测时间。

tart2ms --hdf ../tart_data/NZ_2022_10_19/*.hdf

可以使用以下方式从HDF5存档中导出JSON数据库

tart_vis2json --vis ../NZ_2022_10_19/*.hdf 

目前，每个此类导出的JSON数据库将包含一个单独的时间戳（因此，单个HDF5存档可能产生多个JSON数据库）。

您的望远镜名称可能不在JPL认可的观测站列表中，这目前在casacore中引发错误，因此即使天线表中包含天线有效的ITRF坐标，某些casa任务（如listobs或plotants）也会出现错误。我们建议，如果在操作中遇到问题，请将望远镜名称更改为现有的观测站，如kat-7或MeerKAT。

tart2ms --json ../tart_data/NZ_2022_10_19_json/*.json -c --telescope_name 'kat-7'

标准CASA任务可以使用由tart2ms编写的符合CASA备忘录229规范（MSv2.0）的数据库执行。这可能包括（已测试）

• listobs
• plotms
• fixvis
• plotants
• clean

使用wsclean从测量集中合成图像

wsclean -name test -size 1280 1280 -scale 0.0275 -niter 0 data.ms

这将创建一个名为test-image.fits的图像。您需要在您的系统上安装wsclean。

用法

usage: tart2ms [-h] [--json JSON] [--ms MS] [--api API] [--catalog CATALOG]
            [--vis VIS] [--pol2]

Generate measurement set from a JSON file from the TART radio telescope.

optional arguments:
-h, --help         show this help message and exit
--json JSON        Snapshot observation JSON file (visiblities, positions
                    and more). (default: None)
--hdf HDF          Visibility hdf5 file (One minutes worth of visibility data). (default: None)
--ms MS            Output MS table name. (default: tart.ms)
--api API          Telescope API server URL. (default:
                    https://tart.elec.ac.nz/signal)
--catalog CATALOG  Catalog API URL. (default:
                    https://tart.elec.ac.nz/catalog)
--vis VIS          Use a local JSON file containing the visibilities for
                    visibility data (default: None)
--pol2             Fake a second polarization. Some pipelines choke if there
                    is only one. (default: False)

致谢

感谢Simon Perkins和Oleg Smirnov在解释测量集文档方面的帮助。

待办事项

变更日志

• 0.6.0b4 在read_ms中正确调试计算雷利极限。
• 0.6.0b3 如果没有WEIGHT_SPECTRUM，则用ones替代
• 0.6.0b2 清理日志代码。添加--debug标志。取消casa表的讨厌的打印
• 0.6.0b1 新增类似于read_ms的casa_read_ms函数，但使用casacore - 极快。使read_ms()和casa_read_ms()的功能签名相同。
• 0.5.0b3 移除嘈杂的警告。添加venv makefile。以12球格式输出快照方向，以便更容易重相位。
• 0.5.0b2 将预测作为可选依赖项，以从要求中删除codex-africanus。
• 0.5.0b1 添加模型预测，添加自动目录下载
• 0.4.0b3 使用tart_tools中的新目录url函数
• 0.4.0b2 添加辅助函数get_array_location
• 0.4.0b1 添加 tart2ms.read_ms 函数（来自disko），添加用于分辨率计算的实用程序。
• 0.3.0b3 在长时间测量集中保持相位中心不变的新功能（边缘相位）。修复进度条。
• 0.3.0b1 修复许多CASA兼容性问题。天线位置已完成。感谢SARAO的Ben Hugo。
• 0.2.0b5 修复MAIN表中TIME_CENTROID列维度错误。问题8。
• 0.2.0b3 修复MAIN表中TIME列维度错误。问题7。
• 0.2.0b3 将github上的组织转移到tart-telescope。
• 0.2.0b2 将来自HDF5文件的所有可见性放入单个测量集中。
• 0.2.0b1 添加从网络应用程序保存的HDF5文件的导入。
• 0.1.4b4 清理dask-ms中的某些位损坏（处理分块对象）
• 0.1.4b3 将SIGMA、FLAG、FLAG_CATEGORY添加到主表（:/）
• 0.1.4b1 将RESOLUTION和EFFECTIVE_BW添加到SPECTRAL_WINDOW
• 0.1.3b1 正确排序时间戳，添加了一个方便的将时间转换为纪元时间的函数。
• 0.1.2 修正阵列（在J2000）的指向方向。
• 0.1.1 添加-pol2开关以生成第二个偏振。
• 0.1.0 首次功能版本。