Skip to main content

Select regions of interest (ROIs) using napari

Project description

napari-roi

napari hub PyPI License Python Version Issues Pull requests

Select regions of interest (ROIs) using napari

Installation

You can install napari-roi via pip:

pip install napari-roi

Alternatively, you can install napari-roi via conda:

conda install -c conda-forge napari-roi

Usage

The napari-roi plugin can be opened from within napari (napari -> napari-roi: regions of interest) and operates on napari Shapes layers.

ROIs can be added to any napari Shapes layer, either by drawing a standard napari shape (e.g. rectangle), or by adding a rectangular ROI of specified size using the Add ROI functionality in the napari-roi widget. Each ROI is associated with a name, a position (X/Y origin), and a size (width/height). The location of the X/Y origin of all ROIs can be chosen in the napari-roi widget. Note that any shape supported by napari (e.g. ellipse, rectangle, polygon, line, path) can serve as an ROI; for non-rectangular shapes, napari-roi computes rectangular bounding boxes aligned with the napari coordinate system to determine their positions and sizes. ROIs can be edited or deleted by modifying the corresponding shapes in napari, or by editing the corresponding row in the napari-roi widget.

All ROIs in the current Shapes layer can be saved to a comma-separated values (CSV) file using the Save functionality in the napari-roi widget. When the Autosave option is checked, the file is automatically updated on every ROI change. Note that the selected file is specific to the current Shapes layer; ROIs from different Shapes layers cannot be saved to the same file. ROIs can be loaded from a previously saved file and added to the current Shapes layer by opening the file in the napari-roi widget.

CSV files saved using napari-roi adhere to the following format:

Columns Description
Name ROI name
X, Y Position (X/Y origin)
W, H Size (width/height)

Authors

Created and maintained by Jonas Windhager jonas.windhager@uzh.ch

Contributing

Contributing

Changelog

Changelog

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

napari-roi-0.1.7.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

napari_roi-0.1.7-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file napari-roi-0.1.7.tar.gz.

File metadata

  • Download URL: napari-roi-0.1.7.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for napari-roi-0.1.7.tar.gz
Algorithm Hash digest
SHA256 e5b916cfcb2c378733e8632ba669d91381e2cc4568fd3e4296e8ffe055f3a5d9
MD5 194003b65de4661b591eb5e534e31b71
BLAKE2b-256 e8ce3624c8509e9158abdd2262c14d3ae8b43ee705caea27e9305a5602448a56

See more details on using hashes here.

File details

Details for the file napari_roi-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: napari_roi-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for napari_roi-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 2cc15257bb10acb862ce47dcdd469a91761ac86894aa7b25bd228dbdfd08c6de
MD5 d9350adafebe05d617ec8ce7683d8e92
BLAKE2b-256 f8e9c72fc0a3cb47b9a453ea07cbe284823d39eb8daa860d8f7cccb65ce815b0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page