跳转到主要内容

Python中的n维数组查看器

项目描述

napari

Python的多维图像查看器

napari on Binder image.sc forum License Build Status Code coverage Supported Python versions Python package index Python package index download statistics Development Status Code style: black DOI NEP29

napari 是一个快速、交互式的Python多维图像查看器。它专为浏览、注释和分析大型多维图像而设计。它基于Qt(用于GUI)、vispy(用于基于GPU的高性能渲染)和科学Python堆栈(numpy、scipy)构建。

我们在公开开发 napari!但项目处于 alpha 阶段,每个版本都可能进行 破坏性更改。您可以通过此存储库跟踪进度,在我们发布新版本时测试它们,并提供想法和代码。

如果您想参考我们的文档,请访问napari.org。如果您想为其做出贡献,请参阅下面的 贡献 部分。

我们正在开发教程,但您也可以通过以下内容快速入门。

安装

建议将 napari 安装到虚拟环境中,例如

conda create -y -n napari-env -c conda-forge python=3.9
conda activate napari-env
python -m pip install "napari[all]"

如果您更喜欢 conda 而不是 pip,可以将最后一行替换为: conda install -c conda-forge napari pyqt

有关完整的安装指南,请参阅此处。

简单示例

(以下示例需要 scikit-image 包才能运行。我们仅使用此包的数据样本进行演示。如果您将示例更改为使用自己的数据集,您可能不需要安装此包。)

在 IPython 壳内部,您可以通过调用以下命令打开交互式查看器

from skimage import data
import napari

viewer = napari.view_image(data.cells3d(), channel_axis=1, ndisplay=3)

napari viewer with a multichannel image of cells displayed as two image layers: nuclei and membrane.

要从脚本中使用 napari,请使用 napari.run()

from skimage import data
import napari

viewer = napari.view_image(data.cells3d(), channel_axis=1, ndisplay=3)
napari.run()  # start the "event loop" and show the viewer

功能

请查看我们的examples 文件夹中的脚本,以了解我们正在开发的某些功能!

napari 支持 six 种主要不同的图层类型,即 ImageLabelsPointsVectorsShapesSurface,每种类型对应不同的数据类型、可视化和交互性。您可以将不同类型的多个图层添加到查看器中,然后开始使用它们,调整它们的属性。

我们所有的图层类型都支持 n 维数据,查看器还提供了快速浏览和可视化数据 2D 或 3D 切片的能力。

napari 还支持查看器和 Python 内核之间的双向通信,这在从 jupyter 笔记本启动或使用我们内置的控制台时特别有用。使用控制台允许您与查看器交互式地加载和保存数据,并通过程序方式控制查看器的所有功能。

您可以通过自定义快捷键、键绑定和鼠标功能来扩展 napari

教程

有关如何使用 napari 的更多详细信息,请查看我们的 教程。这些教程仍在不断完善中,但我们会定期更新。

使命、价值观和路线图

有关我们对 napari 的计划,您可以阅读我们的 使命和价值观声明,其中包含关于我们支持 napari 插件生态系统的愿景的更多详细信息。您可以在项目路线图中查看详细信息。

贡献

欢迎贡献!请阅读我们的 贡献指南 以开始。由于我们处于早期阶段,您可能希望在加入之前先在 GitHub Issues 上联系。

如果您想对我们的文档进行贡献或编辑,请访问 napari/docs

行为准则

napari 有一个 行为准则,所有参与 napari 社区的人都应遵守。

治理

您可以通过我们的 治理模式 了解更多关于 napari 项目的组织和管理的相关信息,其中包括有关 @napari/steering-council 和 @napari/core-devs 的信息以及联系方式。

引用 napari

如果您觉得 napari 有用,请使用以下 DOI 引用 此存储库

napari 贡献者(2019)。napari:一个用于 Python 的多维图像查看器。 doi:10.5281/zenodo.3555620

注意,此 DOI 将解析到 napari 的所有版本。要引用特定版本,请在我们zenodo 页面上找到该版本的 DOI。最新版本的 DOI 在此页面的顶部徽章中。

帮助

我们是 image.sc 论坛 的社区合作伙伴,所有帮助和支持请求都应使用 napari 标签发布在论坛上。我们期待在那里与您互动。

错误报告应在我们的 GitHub issues 上使用错误报告模板进行。如果您认为某些功能不起作用,请不要犹豫,联系我们 - 很可能是我们而不是您的问题!

机构和资金合作伙伴

CZI logo

项目详情


发行历史 发布通知 | RSS 源

下载文件

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

源代码分发

napari-0.5.4.tar.gz (2.8 MB 查看哈希值)

上传时间 源代码

构建分发

napari-0.5.4-py3-none-any.whl (3.1 MB 查看哈希值)

上传时间 Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面