跳转到主要内容

利用Jupyter平台进行天文学数据分析的开发

项目描述

Jdaviz logo Zenodo DOI GitHub Actions CI Status https://codecov.io/gh/spacetelescope/jdaviz/branch/main/graph/badge.svg Documentation Status Powered by Astropy

jdaviz 是一个基于Jupyter平台的天文学数据分析可视化工具包。它是STScI更大 数据分析工具生态系统 的一部分。这些基于GUI的工具将数据可视化和交互式分析联系起来。它们设计用于在Jupyter笔记本单元格内、作为独立的桌面应用程序或作为网站内的嵌入式窗口工作——所有这些都有几乎相同的外观。 jdaviz 正在积极开发中,遇到现有功能中bug的用户被鼓励在此存储库中打开问题。

jdaviz 提供数据查看器和分析插件,可以根据需要灵活组合,创建适合您工作流程的交互式应用程序。提供了三个常用的预设配置。 Specviz 是用于可视化和分析一维天文光谱的工具。 Mosviz 是用于许多天文光谱的可视化工具,通常是多目标光谱仪(如 JWST NIRSpec)的输出,包括一维和二维光谱查看器以及光谱仪狭缝的天空视图等上下文信息。 Cubeviz 提供了对光谱数据立方体(如 JWST MIRI 将产生的)的视图,以及从立方体中提取的一维光谱。 Imviz 提供了对二维天文图像的可视化和快速查看分析。

此工具的设计考虑了詹姆斯·韦伯空间望远镜(JWST)的仪器模式,但该工具足够灵活,可以读取来自许多天文望远镜的数据。 文档提供了一个完整的 所有支持模式的表格

安装

您可能希望在一个新的虚拟或 conda 环境中安装 jdaviz,以避免与其他您可能已安装的包版本冲突,例如

conda create -n jdaviz-env python=3.12
conda activate jdaviz-env

可以使用 pip 安装发行版

pip install jdaviz --upgrade

有关安装和使用 Jdaviz 的详细信息,请参阅 Jdaviz 安装

快速入门

安装完成后,jdaviz 可以作为独立的 Web 应用程序或 Jupyter Notebook 运行。

作为 Web 应用程序

jdaviz 提供了一个命令行工具来启动 Web 应用程序。 要查看语法和用法,请在终端中输入

jdaviz --help
jdaviz --layout=specviz /path/to/data/spectral_file

有关每个工具的命令行界面的更多信息,请参阅 Jdaviz 文档

在 Jupyter Notebook 中

jdaviz 的强大之处在于它可以集成到您的 Jupyter Notebook 工作流程中

from jdaviz import Specviz

specviz = Specviz()
specviz.show()

有关 jdaviz 不同的应用程序配置和加载数据的更多信息,请参阅 SpecvizCubevizMosvizImvizSpecviz2D 工具。

jdaviz 还提供了一个 示例笔记本目录,位于 git 仓库的 notebooks 子目录中,以测试应用程序。 CubevizExample.ipynb 是一个示例,它使用 Cubeviz 配置加载 JWST 数据立方体。 要运行提供的示例,使用笔记本路径启动 Jupyter 内核

jupyter notebook /path/to/jdaviz/notebooks/CubevizExample.ipynb

帮助

如果您发现任何问题或错误,如果尚未报告,您可以 在 GitHub 上创建一个问题。 但是,为了获得更快的响应,我们鼓励您提交 JWST 帮助台工单

实时 Jdaviz 教程(作为 JWebbinars 系列的一部分)的录音和教学笔记本可在 JWebbinar 网站 的“材料和视频”可展开部分找到。 滚动到该部分的底部,以找到最近会议(JWebbinar 24,2023 年 3 月)的材料。

许可 & 署名

此项目版权所有 (c) JDADF 开发者,并按 BSD 3 条款许可协议许可。 此软件包基于 Astropy 软件包模板,该模板按 BSD 3 条款许可协议许可。 有关更多信息,请参阅 许可 文件夹。

通过我们的Zenodo记录引用 jdavizhttps://doi.org/10.5281/zenodo.5513927

贡献

我们欢迎贡献!jdaviz 是开源项目,建立在开源之上,我们非常希望您加入我们的社区。

冒名顶替综合症免责声明:我们需要您的帮助。不,真的。

您内心可能有一个小声音在告诉您,您还没有准备好成为开源贡献者;您的技能还不够好,不足以做出贡献。您能为这样的项目提供什么价值呢?

我们向您保证——您内心的小声音是错误的。如果您能编写代码,您就可以为开源项目贡献代码。为开源项目做出贡献是提升编程技能的绝佳方式。编写完美的代码并不是衡量优秀开发者的标准(这将排除我们所有人!);尝试创造东西,犯错误,并从错误中学习,这是我们所有人进步的方式。我们很高兴帮助他人学习。

成为开源贡献者并不意味着仅仅编写代码。您可以通过编写文档、测试或甚至对项目提供反馈(包括对贡献过程的反馈)来提供帮助。这些贡献中的一些可能对整个项目最有价值,因为您带着新的视角来到项目,可以看到经验丰富的贡献者忽略的错误和假设。

注意:此免责声明最初由 Adrienne LowePyCon 演讲 编写,并由 jdaviz 根据其在 MetPy 项目 的 README 文件中的使用进行改编。

项目详情


下载文件

下载适合您平台的应用程序。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源代码分发

jdaviz-3.10.3.tar.gz (1.5 MB 查看哈希值)

上传时间 源代码

构建分发

jdaviz-3.10.3-py3-none-any.whl (1.7 MB 查看散列值)

上传时间 Python 3

支持者