Load in SMLM data and annotate within napari
Project description
napari-locpix
Load in SMLM data and annotate within napari
This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.
Installation
Install napari via pip:
pip install "napari[all]"
You can install napari-locpix via pip:
pip install napari-locpix
To install latest development version :
pip install git+https://github.com/oubino/napari-locpix.git
Usage
First launch napari
napari
Then can find the plugin in napari, in the plugins menu, titled 'Annotate (napari-locpix)'
This plugin allows a user to
- Read in SMLM data
- Visualise SMLM data in a histogram
- Add segmentations to the data
- Extract the underlying localisations from the segmentations
IO
The input data can be in the form of a .csv or .parquet.
We expect there to be 4 columns at least, which should he identified inthe file column selection:
- X coordinate
- Y coordinate
- Frame
- Channel
If the data has been annotated with this software we can also load this in. Note however we currently only support loading in annotated data saved as a .parquet folder. Therefore, we recommend always keeping a .parquet copy until loading in an annotated .csv is supported.
The data can be outputted to a .parquet or a .csv
Drop localisations with zero label, gives you the option to only save the localisations which have been annotated i.e. labels 1 and above.
Channels labels allows you to give a real name label to each of the channels e.g. Chan 0 label: 'Alexa 647'
Visualisation
Using the render button you can render the loaded in data according to the histogram settings
X/Y bins defines the number of bins for the histogram. Use the X/Y bins ratio to retain the original aspect ratio of the FOV (or close) in the visualisation, if desired. The aspect ratio in this rendering does not affect the underlying localisation position data.
Vis interpolation defines how to interpolate the image before viewing
Annotations
Annotations can be added using Napari's viewer.
Click on the Napari button to create a new labels layer.
Rename the new labels layer to "Labels", otherwise the annotations will not be saved.
Contributing
Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.
License
Distributed under the terms of the MIT license, "napari-locpix" is free and open source software
Issues
If you encounter any problems, please file an issue along with a detailed description.
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file napari_locpix-0.0.7.tar.gz.
File metadata
- Download URL: napari_locpix-0.0.7.tar.gz
- Upload date:
- Size: 19.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
764ca2f1f80cccbe2344c1f2fea1ab3f2de21b71cc9232a1eeb2c6be56496b16
|
|
| MD5 |
d6fb970e4681a5512efa405d5d8d7256
|
|
| BLAKE2b-256 |
f263076fb19390d7331a8dd1a790684ad8a88e56deb6322a0c99ccad105d2eaa
|
File details
Details for the file napari_locpix-0.0.7-py3-none-any.whl.
File metadata
- Download URL: napari_locpix-0.0.7-py3-none-any.whl
- Upload date:
- Size: 18.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04b20df181a32c1a6c76790c3b9769f1fda4b2b9e4a1bdf55d37d10dfcc11706
|
|
| MD5 |
cff74f752209d80c04b5bc922d2a89bb
|
|
| BLAKE2b-256 |
6155d9af1e53e2d302f141c8ed44666d00faa0ee017ac9a383925d7eec3152f3
|