LSMTool: LOFAR天球模型工具

LSMTool允许操作LOFAR天球模型（在makesourcedb格式中）。

作者

• David Rafferty

基于以下贡献的脚本：

• Bjoern Adebahr
• Francesco de Gasperin
• Reinout van Weeren

内容

• docs/: 文档
• tests/: 包含测试天球模型和用于验证的有用脚本
• bin/: 包含lsmtool可执行文件
• lsmtool/: 包含主要的LSMTool脚本
• lsmtool/operations/: 包含操作模块
• parsets/: 一些示例parsets

以下操作可用

• SELECT: 通过源或补丁属性选择源
• REMOVE: 通过源或补丁属性删除源
• TRANSFER: 将补丁方案从一个天球模型转移到另一个天球模型
• GROUP: 将源分组到补丁中
• UNGROUP: 删除补丁
• MOVE: 移动源或补丁位置
• MERGE: 将两个或更多补丁合并为一个
• CONCATENATE: 连接两个天球模型
• ADD: 添加源
• 设置补丁位置：计算并设置补丁位置
• 绘图：绘制天空模型
• 比较：比较两个天空模型的光源通量和位置

有关详细信息，请参阅完整文档。

安装

LSMTool 已安装在 LOFAR CEP3 集群上。CEP3 上的用户在使用 LSMTool 之前应运行以下命令：

source ~rafferty/init_lsmtool

如果您想自己安装 LSMTool，请按照以下说明操作。

依赖关系

• Numpy
• Scipy
• Matplotlib
• Astropy
• EveryBeam
• PyVO（可选，用于 VO 访问）

下载和安装

• 从 PyPI 安装最新版本

  pip install lsmtool

• 或从 git 仓库安装最新开发版本

  pip install git+https://git.astron.nl/RD/LSMTool.git

如果您有符合 C++11 规范的编译器，您可以通过自行编译来构建更快的平均移位分组算法版本

git clone https://git.astron.nl/RD/LSMTool.git
cd LSMTool
python setup.py install --build_c_extentions

请注意，与 Python 版本相比，C++ 版本的结果可能会有所不同，但在实际应用中这种差异预计不会很重要。

测试

您可以使用以下命令来测试安装是否成功：

python setup.py test

如果没有错误发生，则表示 LSMTool 安装正确。

用法

LSMTool 可执行文件可以从命令行使用定义要执行步骤的 parset 运行。例如：

$ lsmtool model.sky lsmtool.parset

parset 遵循常规 DP3 格式。例如：

# Select individual sources with Stokes I fluxes above 1 Jy
LSMTool.Steps.select.Operation = SELECT
LSMTool.Steps.select.FilterExpression = I > 1.0 Jy
LSMTool.Steps.select.OutFile = out_model.sky

LSMTool 还可以通过导入 lsmtool 模块在 Python 脚本中使用。例如：

>>> import lsmtool
>>> skymod = lsmtool.load('model.sky')
>>> skymod.select('I > 1.0 Jy')
>>> skymod.write('out_model.sky')

有关更多信息，请参阅完整文档。