# napari-roi
[](https://napari-hub.org/plugins/napari-roi)
[](https://pypi.org/project/napari-roi)
[](https://github.com/BodenmillerGroup/napari-roi/raw/main/LICENSE)
[](https://python.org)
[](https://github.com/BodenmillerGroup/napari-roi/issues)
[](https://github.com/BodenmillerGroup/napari-roi/pulls)
Select regions of interest (ROIs) using napari
## Installation
You can install napari-roi via [pip](https://pypi.org/project/pip/):
pip install napari-roi
Alternatively, you can install napari-roi via [conda](https://conda.io/):
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](mailto:jonas.windhager@uzh.ch)
## Contributing
[Contributing](https://github.com/BodenmillerGroup/napari-roi/blob/main/CONTRIBUTING.md)
## Changelog
[Changelog](https://github.com/BodenmillerGroup/napari-roi/blob/main/CHANGELOG.md)
## License
[MIT](https://github.com/BodenmillerGroup/napari-roi/blob/main/LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/BodenmillerGroup/napari-roi",
"name": "napari-roi",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Jonas Windhager",
"author_email": "jonas.windhager@uzh.ch",
"download_url": "https://files.pythonhosted.org/packages/e8/ce/3624c8509e9158abdd2262c14d3ae8b43ee705caea27e9305a5602448a56/napari-roi-0.1.7.tar.gz",
"platform": null,
"description": "# napari-roi\n\n[](https://napari-hub.org/plugins/napari-roi)\n[](https://pypi.org/project/napari-roi)\n[](https://github.com/BodenmillerGroup/napari-roi/raw/main/LICENSE)\n[](https://python.org)\n[](https://github.com/BodenmillerGroup/napari-roi/issues)\n[](https://github.com/BodenmillerGroup/napari-roi/pulls)\n\nSelect regions of interest (ROIs) using napari\n\n## Installation\n\nYou can install napari-roi via [pip](https://pypi.org/project/pip/):\n\n pip install napari-roi\n\nAlternatively, you can install napari-roi via [conda](https://conda.io/):\n\n conda install -c conda-forge napari-roi\n\n## Usage\n\nThe *napari-roi* plugin can be opened from within napari (`napari -> napari-roi: regions of interest`) and operates on napari *Shapes* layers.\n\nROIs 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.\n\nAll 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.\n\nCSV files saved using *napari-roi* adhere to the following format:\n\n| Columns | Description |\n| --- | --- |\n| `Name` | ROI name |\n| `X`, `Y` | Position (X/Y origin) |\n| `W`, `H` | Size (width/height) |\n\n## Authors\n\nCreated and maintained by Jonas Windhager [jonas.windhager@uzh.ch](mailto:jonas.windhager@uzh.ch)\n\n## Contributing\n\n[Contributing](https://github.com/BodenmillerGroup/napari-roi/blob/main/CONTRIBUTING.md)\n\n## Changelog\n\n[Changelog](https://github.com/BodenmillerGroup/napari-roi/blob/main/CHANGELOG.md)\n\n## License\n\n[MIT](https://github.com/BodenmillerGroup/napari-roi/blob/main/LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Select regions of interest (ROIs) using napari",
"version": "0.1.7",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "d9350adafebe05d617ec8ce7683d8e92",
"sha256": "2cc15257bb10acb862ce47dcdd469a91761ac86894aa7b25bd228dbdfd08c6de"
},
"downloads": -1,
"filename": "napari_roi-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d9350adafebe05d617ec8ce7683d8e92",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 14206,
"upload_time": "2022-08-10T14:46:04",
"upload_time_iso_8601": "2022-08-10T14:46:04.023324Z",
"url": "https://files.pythonhosted.org/packages/f8/e9/c72fc0a3cb47b9a453ea07cbe284823d39eb8daa860d8f7cccb65ce815b0/napari_roi-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "194003b65de4661b591eb5e534e31b71",
"sha256": "e5b916cfcb2c378733e8632ba669d91381e2cc4568fd3e4296e8ffe055f3a5d9"
},
"downloads": -1,
"filename": "napari-roi-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "194003b65de4661b591eb5e534e31b71",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 15436,
"upload_time": "2022-08-10T14:46:05",
"upload_time_iso_8601": "2022-08-10T14:46:05.262793Z",
"url": "https://files.pythonhosted.org/packages/e8/ce/3624c8509e9158abdd2262c14d3ae8b43ee705caea27e9305a5602448a56/napari-roi-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-08-10 14:46:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "BodenmillerGroup",
"github_project": "napari-roi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": null,
"specs": []
},
{
"name": "black",
"specs": []
},
{
"name": "flake8",
"specs": []
},
{
"name": "isort",
"specs": []
},
{
"name": "napari",
"specs": []
}
],
"lcname": "napari-roi"
}
JSON
