在WorldWide Telescope中交互式可视化天文数据
项目描述
pywwt: 从Python/Jupyter的WorldWide Telescope
🚀🚀 点击此处尝试在云端运行pywwt! 🚀🚀
注意:云服务器通常启动迅速,但如果它们最近进行了更新,您可能需要等待几分钟,以便重新构建支持软件镜像。
关于
pywwt包是使用WorldWide Telescope(WWT)在Python中可视化天文数据的官方工具包,WWT是一个免费的开源天文学可视化系统。WWT包含一个复杂的4D WebGL渲染引擎,以及一个基于云的Web服务,用于共享和可视化数以TB计的天文数据。
使用pywwt,您可以
- 通过HTML小部件在Jupyter和JupyterLab环境中交互式地可视化并探索天文数据
- 使用Qt小部件在独立应用程序中执行相同的操作
- 将来自常见天文数据格式(例如AstroPy表)的数据加载到WWT
- 控制WWT Windows应用程序的运行实例
WorldWide Telescope项目采用开放治理模式,并由NumFOCUS资助。请考虑为该项目进行可抵扣税款捐赠,以帮助项目支付开发者时间、专业服务、旅行、研讨会和各种其他需求。
安装
包括安装说明在内的完整pywwt文档可以在https://pywwt.readthedocs.io/找到。
报告问题
如果您遇到任何问题,请在此处打开一个问题。
对于开发者:测试
要测试您的pywwt检查,请使用pytest
命令。
pywwt测试套件包括一组图像测试,这些测试使用WWT Qt小部件生成图像,并将结果与一组参考图像进行比较。即使一切正常工作,这个测试套件的这个组件也可能很棘手,因为渲染的细节取决于您的操作系统和OpenGL实现。如果您的设置产生视觉上正确的结果,但测试套件未通过,您可以按以下方式修复它。
为了获得更多背景信息,每个“图像测试”都会生成一个WWT视觉效果,并将其与多个参考图像进行比较。如果任何这些图像与WWT结果足够接近,则测试通过。因此,如果您在运行测试套件时比较失败,您需要向语料库添加适当的新图像。
对于类似image_layer_equ
的测试,参考图像存储在子目录pywwt/tests/data/refimg_image_layer_equ
中。该目录中参考图像的文件名无关紧要,并且故意不提供信息,因为相同的参考图像可能与广泛的渲染平台匹配。
如果您以设置环境变量$PYWWT_TEST_IMAGE_DIR
为非空值的方式运行测试套件,则测试运行期间生成的WWT视觉效果将保存到指定的目录。对于任何失败的图像,还将保存类似image_layer_equ_vs_a.png
名称的差异图像。因此,为了更新图像语料库,以便测试套件为您通过,请以这种方式运行测试套件,然后将失败的图像复制到适当的参考图像数据目录。不要忘记使用git add
添加新文件!您还应该验证您的新图像确实与测试中期望的相比“合理”。
您还可以运行 python -m pywwt.tests $imgdir1 $imgdir2 ...
,其中 $imgdirN
是包含一个或多个测试运行期间生成的图像的目录或 Zip 文件的路径。这将比较这些图像与当前参考图像库,并指出参考库中是否有图像可以被移除。然而,请注意,只有当您的 $imgdirN
集合涵盖了所有感兴趣的目标 pywwt 渲染平台时,这才是安全的。如果有开发者在 MacOS 10.10 上运行测试套件,而您的集合中不包括这些样本,那么如果您移除他们需要的参考文件,就有可能破坏该人的测试套件。话虽如此,由于渲染代码和测试套件的演变,参考图像可能会过时。另一方面,从 Git 仓库中删除文件实际上并不会使其变小,因此删除旧的参考图像只有助于稍微整理一下。
持续集成和部署
此仓库使用 Cranko 来自动化发布工作流程。这种自动化对于 WWT 网络服务的平稳和可重复部署至关重要。
参与其中
我们欢迎人们参与 WWT 社区!您可以通过 参与我们的用户论坛 或通过 注册我们的低流量通讯 来开始。如果您想帮助改进 WWT,我们的 贡献者中心 旨在成为您了解如何向项目做出贡献的一站式商店,其中 贡献者指南 是您应该首先阅读的内容。在这里,我们遵循标准的 分支和拉取 模型。
所有 WWT 社区的参与都应遵守 WWT 行为准则,基本上是您不应该表现得像个混蛋。
致谢
世界望远镜系统的工作得到了 美国天文学会 (AAS)、.NET 基金会 和其他合作伙伴的支持。有关详细信息,请参阅 WWT 用户网站。
法律问题
项目详情
pywwt-0.24.2.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 0c752630582835aad20a42402bdcf5f7fedf591b1b600a22eec205e6aba665c9 |
|
MD5 | 392c37432b70583ee64b36acf41eb7fb |
|
BLAKE2b-256 | b176721a46b550429ac891c35dcbbc4b2278803cbcc0e7e5080f68b682d43fa9 |