jwst_coronagraph_visibility: James Webb Space Telescope Coronagraph Visibility Tool

SIAF版本： PRDOPSSOC-027

詹姆斯·韦伯空间望远镜冠图可见性工具（CVT）是一个基于图形用户界面的目标可见性工具，用于评估与MIRI^[1]和NIRCam^[2]冠图遮光罩相对的时间位置角的目标可见性。CVT可以作为独立的基于Python的图形工具（AstroConda包）或macOS应用程序包提供。

JWST允许的指向导致目标可见性取决于黄道纬度，允许的滚动角度范围取决于太阳距离。因此，目标的允许位置角可以是一个复杂的时间函数。因此，以下事情可能很困难：(1)理解给定目标在探测器上的可能方向，尤其是在与任何仪器遮挡有关的情况下；(2)确定多滚动观测的理想滚动角度偏移；(3)确定一组同时可见的目标。CVT被创建来解决这些问题，并协助在将目标和观测输入APT^[3]之前规划MIRI和NIRCam程序。

我们强调，CVT旨在提供给定目标的可能可观测方向的快速说明。因此，CVT迅速近似JWST的指向限制，不查询官方JWST提案约束生成器（PCG），也不包含详细的指向限制，如地球和月球的规避等。因此，CVT结果应被视为有用的近似值，可能比官方APT约束低一或两个度。

文档可在JWST冠图可见性工具帮助在线找到。

作者：Christopher Stark，Joseph Long，J. Brendan Hagan，Mees Fix和Bryony Nickson

用户安装

安装Python包

使用pip安装

CVT可以从Python包索引以Python包的常规方式安装。

$ pip install jwst_coronagraph_visibility 

安装macOS应用程序

如果您正在运行macOS并且想要一个可双击的应用程序，请单击以下链接
macOS下载（86.4 MB）.

只需将下载的zip文件解压以获取.app捆绑包，然后双击即可运行JWST冠图可见性工具。

贡献者安装

对于那些希望为代码库做出贡献的人，您可以通过克隆和安装存储库来安装jwst_coronagraph_visibility。这仅建议那些想要帮助开发的人。通常，那些只想使用jwst_coronagraph_visibility工具的人应通过Astroconda安装最新稳定版本，如上面的说明中所述。

先决条件

强烈建议贡献者安装一个可工作的 Miniconda 或 Anaconda 环境，以便使用 Python 3.6。为贡献 jwst_coronagraph_visibility 项目，所需软件包将通过存储库中的 setup.py 脚本提供。

克隆存储库

按照以下步骤克隆 jwst_coronagraph_visibility GitHub 存储库：

$ git clone https://github.com/brynickson/jwst_coronagraph_visibility.git
$ cd jwst_coronagraph_visibility

环境安装

下载 jwst_coronagraph_visibility 存储库后，创建并激活一个新的 jwst_coronagraph_visibility 环境。

$ conda create -n jwst_coronagraph_visibility-3.7 python=3.7
$ conda activate jwst_coronagraph_visibility-3.7

软件包安装

接下来，您需要安装 jwst_coronagraph_visibility 软件包。这可以通过运行 setup.py 脚本实现。

(jwst_coronagraph_visibility-3.7)$ python setup.py develop

运行 conda list jwst_coronagraph_visibility 命令后，软件包应该会显示出来。

引用

如果您在出版物（无论是直接使用还是作为其他软件包的依赖项）中使用 CVT，请考虑引用上述 DOI 页面上的 Zenodo 记录。请在 CITATION 中查找更多说明。

软件贡献

贡献者应使用 “分叉工作流程” 向项目贡献。

行为准则

jwst_coronagraph_visibility 存储库的用户和贡献者应遵守 行为准则。有关行为准则的问题或违规行为应通知 jwst_coronagraph_visibility 团队成员或 conduct@stsci.edu。

问题

有关 jwst_coronagraph_visibility 项目、其软件或文档的任何问题，请 打开一个问题。

已知问题

• CVT 不会（也不会）查询 JWST 投标约束生成器。场视域的唯一约束是太阳和反太阳避角。
• 目标名称解析取决于 SIMBAD 服务的可用性。如果无法访问该服务，您将必须自己输入坐标。
• CVT 目前无法将绘制的点导出为文本。可以通过在绘图面板下方使用保存图标将图表保存到 GUI 中。
• CVT 仅在 Mac 和 Linux 上进行了测试。欢迎 Windows 用户提交问题报告，我们将尽力解决它们，但我们不会在 Windows 上测试此工具。

请参阅以下问题跟踪器 https://github.com/spacetelescope/jwst_coronagraph_visibility/issues.

当前开发团队

• Mees Fix @mfixstsci
• Bryony Nickson @brynickson

缩写

[1] - 中红外仪器（参见 文档) ↩
[2] - 近红外仪器（参见 文档) ↩
[3] - 天文学家提案工具（参见 文档) ↩