# napari
### multi-dimensional image viewer for python
[](https://mybinder.org/v2/gh/napari/napari/main?urlpath=%2Fdesktop)
[](https://forum.image.sc/tag/napari)
[](https://github.com/napari/napari/raw/main/LICENSE)
[](https://cirrus-ci.com/napari/napari)
[](https://codecov.io/gh/napari/napari)
[](https://python.org)
[](https://pypi.org/project/napari)
[](https://pypistats.org/packages/napari)
[](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha)
[](https://github.com/python/black)
[](https://zenodo.org/badge/latestdoi/144513571)
[](https://numpy.org/neps/nep-0029-deprecation_policy.html)
**napari** is a fast, interactive, multi-dimensional image viewer for Python. It's designed for browsing, annotating, and analyzing large multi-dimensional images. It's built on top of Qt (for the GUI), vispy (for performant GPU-based rendering), and the scientific Python stack (numpy, scipy).
We're developing **napari** in the open! But the project is in an **alpha** stage, and there will still likely be **breaking changes** with each release. You can follow progress on [this repository](https://github.com/napari/napari), test out new versions as we release them, and contribute ideas and code.
We're working on [tutorials](https://napari.org/tutorials/), but you can also quickly get started by looking below.
## installation
It is recommended to install napari into a virtual environment, like this:
```sh
conda create -y -n napari-env -c conda-forge python=3.9
conda activate napari-env
python -m pip install "napari[all]"
```
If you prefer conda over pip, you can replace the last line with: `conda install -c conda-forge napari pyqt`
See here for the full [installation guide](https://napari.org/tutorials/fundamentals/installation.html).
## simple example
(The examples below require the `scikit-image` package to run. We just use data samples from this package for demonstration purposes. If you change the examples to use your own dataset, you may not need to install this package.)
From inside an IPython shell, you can open up an interactive viewer by calling
```python
from skimage import data
import napari
viewer = napari.view_image(data.cells3d(), channel_axis=1, ndisplay=3)
```
To use napari from inside a script, use `napari.run()`:
```python
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
```
## features
Check out the scripts in our [`examples` folder](examples) to see some of the functionality we're developing!
**napari** supports six main different layer types, `Image`, `Labels`, `Points`, `Vectors`, `Shapes`, and `Surface`, each corresponding to a different data type, visualization, and interactivity. You can add multiple layers of different types into the viewer and then start working with them, adjusting their properties.
All our layer types support n-dimensional data and the viewer provides the ability to quickly browse and visualize either 2D or 3D slices of the data.
**napari** also supports bidirectional communication between the viewer and the Python kernel, which is especially useful when launching from jupyter notebooks or when using our built-in console. Using the console allows you to interactively load and save data from the viewer and control all the features of the viewer programmatically.
You can extend **napari** using custom shortcuts, key bindings, and mouse functions.
## tutorials
For more details on how to use `napari` checkout our [tutorials](https://napari.org/tutorials/). These are still a work in progress, but we'll be updating them regularly.
## mission, values, and roadmap
For more information about our plans for `napari` you can read our [mission and values statement](https://napari.org/community/mission_and_values.html), which includes more details on our vision for supporting a plugin ecosystem around napari.
You can see details of [the project roadmap here](https://napari.org/roadmaps/index.html).
## contributing
Contributions are encouraged! Please read our [contributing guide](https://napari.org/developers/contributing.html) to get started. Given that we're in an early stage, you may want to reach out on our [Github Issues](https://github.com/napari/napari/issues) before jumping in.
## code of conduct
`napari` has a [Code of Conduct](https://napari.org/community/code_of_conduct.html) that should be honored by everyone who participates in the `napari` community.
## governance
You can learn more about how the `napari` project is organized and managed from our [governance model](https://napari.org/community/governance.html), which includes information about, and ways to contact the [@napari/steering-council and @napari/core-devs](https://napari.org/community/team.html#current-core-developers).
## citing napari
If you find `napari` useful please cite [this repository](https://github.com/napari/napari) using its DOI as follows:
> napari contributors (2019). napari: a multi-dimensional image viewer for python. [doi:10.5281/zenodo.3555620](https://zenodo.org/record/3555620)
Note this DOI will resolve to all versions of napari. To cite a specific version please find the
DOI of that version on our [zenodo page](https://zenodo.org/record/3555620). The DOI of the latest version is in the badge at the top of this page.
## help
We're a community partner on the [image.sc forum](https://forum.image.sc/tags/napari) and all help and support requests should be posted on the forum with the tag `napari`. We look forward to interacting with you there.
Bug reports should be made on our [github issues](https://github.com/napari/napari/issues/new?template=bug_report.md) using
the bug report template. If you think something isn't working, don't hesitate to reach out - it is probably us and not you!
## institutional and funding partners
Raw data
{
"_id": null,
"home_page": "https://napari.org",
"name": "napari",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "napari team",
"author_email": "napari-steering-council@googlegroups.com",
"download_url": "https://files.pythonhosted.org/packages/6c/e5/80d59b639af9acfd9eccb999c47a0b126848cfd957eb720fe535ebd15b6c/napari-0.4.19.post1.tar.gz",
"platform": null,
"description": "# napari\n\n### multi-dimensional image viewer for python\n\n[](https://mybinder.org/v2/gh/napari/napari/main?urlpath=%2Fdesktop)\n[](https://forum.image.sc/tag/napari)\n[](https://github.com/napari/napari/raw/main/LICENSE)\n[](https://cirrus-ci.com/napari/napari)\n[](https://codecov.io/gh/napari/napari)\n[](https://python.org)\n[](https://pypi.org/project/napari)\n[](https://pypistats.org/packages/napari)\n[](https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha)\n[](https://github.com/python/black)\n[](https://zenodo.org/badge/latestdoi/144513571)\n[](https://numpy.org/neps/nep-0029-deprecation_policy.html)\n\n**napari** is a fast, interactive, multi-dimensional image viewer for Python. It's designed for browsing, annotating, and analyzing large multi-dimensional images. It's built on top of Qt (for the GUI), vispy (for performant GPU-based rendering), and the scientific Python stack (numpy, scipy).\n\nWe're developing **napari** in the open! But the project is in an **alpha** stage, and there will still likely be **breaking changes** with each release. You can follow progress on [this repository](https://github.com/napari/napari), test out new versions as we release them, and contribute ideas and code.\n\nWe're working on [tutorials](https://napari.org/tutorials/), but you can also quickly get started by looking below.\n\n## installation\n\nIt is recommended to install napari into a virtual environment, like this:\n\n```sh\nconda create -y -n napari-env -c conda-forge python=3.9\nconda activate napari-env\npython -m pip install \"napari[all]\"\n```\n\nIf you prefer conda over pip, you can replace the last line with: `conda install -c conda-forge napari pyqt`\n\nSee here for the full [installation guide](https://napari.org/tutorials/fundamentals/installation.html).\n\n## simple example\n\n(The examples below require the `scikit-image` package to run. We just use data samples from this package for demonstration purposes. If you change the examples to use your own dataset, you may not need to install this package.)\n\nFrom inside an IPython shell, you can open up an interactive viewer by calling\n\n```python\nfrom skimage import data\nimport napari\n\nviewer = napari.view_image(data.cells3d(), channel_axis=1, ndisplay=3)\n```\n\n\n\n\nTo use napari from inside a script, use `napari.run()`:\n\n```python\nfrom skimage import data\nimport napari\n\nviewer = napari.view_image(data.cells3d(), channel_axis=1, ndisplay=3)\nnapari.run() # start the \"event loop\" and show the viewer\n```\n\n## features\n\nCheck out the scripts in our [`examples` folder](examples) to see some of the functionality we're developing!\n\n**napari** supports six main different layer types, `Image`, `Labels`, `Points`, `Vectors`, `Shapes`, and `Surface`, each corresponding to a different data type, visualization, and interactivity. You can add multiple layers of different types into the viewer and then start working with them, adjusting their properties.\n\nAll our layer types support n-dimensional data and the viewer provides the ability to quickly browse and visualize either 2D or 3D slices of the data.\n\n**napari** also supports bidirectional communication between the viewer and the Python kernel, which is especially useful when launching from jupyter notebooks or when using our built-in console. Using the console allows you to interactively load and save data from the viewer and control all the features of the viewer programmatically.\n\nYou can extend **napari** using custom shortcuts, key bindings, and mouse functions.\n\n## tutorials\n\nFor more details on how to use `napari` checkout our [tutorials](https://napari.org/tutorials/). These are still a work in progress, but we'll be updating them regularly.\n\n## mission, values, and roadmap\n\nFor more information about our plans for `napari` you can read our [mission and values statement](https://napari.org/community/mission_and_values.html), which includes more details on our vision for supporting a plugin ecosystem around napari.\nYou can see details of [the project roadmap here](https://napari.org/roadmaps/index.html).\n\n## contributing\n\nContributions are encouraged! Please read our [contributing guide](https://napari.org/developers/contributing.html) to get started. Given that we're in an early stage, you may want to reach out on our [Github Issues](https://github.com/napari/napari/issues) before jumping in.\n\n## code of conduct\n\n`napari` has a [Code of Conduct](https://napari.org/community/code_of_conduct.html) that should be honored by everyone who participates in the `napari` community.\n\n## governance\n\nYou can learn more about how the `napari` project is organized and managed from our [governance model](https://napari.org/community/governance.html), which includes information about, and ways to contact the [@napari/steering-council and @napari/core-devs](https://napari.org/community/team.html#current-core-developers).\n\n## citing napari\n\nIf you find `napari` useful please cite [this repository](https://github.com/napari/napari) using its DOI as follows:\n\n> napari contributors (2019). napari: a multi-dimensional image viewer for python. [doi:10.5281/zenodo.3555620](https://zenodo.org/record/3555620)\n\nNote this DOI will resolve to all versions of napari. To cite a specific version please find the\nDOI of that version on our [zenodo page](https://zenodo.org/record/3555620). The DOI of the latest version is in the badge at the top of this page.\n\n## help\n\nWe're a community partner on the [image.sc forum](https://forum.image.sc/tags/napari) and all help and support requests should be posted on the forum with the tag `napari`. We look forward to interacting with you there.\n\nBug reports should be made on our [github issues](https://github.com/napari/napari/issues/new?template=bug_report.md) using\nthe bug report template. If you think something isn't working, don't hesitate to reach out - it is probably us and not you!\n\n## institutional and funding partners\n\n\n",
"bugtrack_url": null,
"license": "BSD 3-Clause",
"summary": "n-dimensional array viewer in Python",
"version": "0.4.19.post1",
"project_urls": {
"Bug Tracker": "https://github.com/napari/napari/issues",
"Documentation": "https://napari.org",
"Download": "https://github.com/napari/napari",
"Homepage": "https://napari.org",
"Source Code": "https://github.com/napari/napari"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cee9a8726fbb90de91659a9e4437ed4784c3a73ccd52caabff8aa1f987fdab4b",
"md5": "6cfd0a1beaa3b27ac39e8c6c184a26dc",
"sha256": "bdc21ef350bb1f3bb88aca333baa8c233023e3d4d8bacb0b7413a19e2e58aaf1"
},
"downloads": -1,
"filename": "napari-0.4.19.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6cfd0a1beaa3b27ac39e8c6c184a26dc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 2676783,
"upload_time": "2024-02-28T16:49:42",
"upload_time_iso_8601": "2024-02-28T16:49:42.995299Z",
"url": "https://files.pythonhosted.org/packages/ce/e9/a8726fbb90de91659a9e4437ed4784c3a73ccd52caabff8aa1f987fdab4b/napari-0.4.19.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6ce580d59b639af9acfd9eccb999c47a0b126848cfd957eb720fe535ebd15b6c",
"md5": "7056b7599b5c31cf0f07c902ebb4a59a",
"sha256": "88e298697c38c9f842d7c26c8d51d2e0fbb90d0be05575fdd159d27eede11301"
},
"downloads": -1,
"filename": "napari-0.4.19.post1.tar.gz",
"has_sig": false,
"md5_digest": "7056b7599b5c31cf0f07c902ebb4a59a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 10631211,
"upload_time": "2024-02-28T16:49:47",
"upload_time_iso_8601": "2024-02-28T16:49:47.098425Z",
"url": "https://files.pythonhosted.org/packages/6c/e5/80d59b639af9acfd9eccb999c47a0b126848cfd957eb720fe535ebd15b6c/napari-0.4.19.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-28 16:49:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "napari",
"github_project": "napari",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"circle": true,
"tox": true,
"lcname": "napari"
}
JSON
