Skip to main content

Load in SMLM data and annotate within napari

Project description

napari-locpix

License MIT PyPI Python Version tests codecov napari hub

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

  1. Read in SMLM data
  2. Visualise SMLM data in a histogram
  3. Add segmentations to the data
  4. 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

napari_locpix-0.0.7.tar.gz (19.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

napari_locpix-0.0.7-py3-none-any.whl (18.9 kB view details)

Uploaded Python 3

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

Hashes for napari_locpix-0.0.7.tar.gz
Algorithm Hash digest
SHA256 764ca2f1f80cccbe2344c1f2fea1ab3f2de21b71cc9232a1eeb2c6be56496b16
MD5 d6fb970e4681a5512efa405d5d8d7256
BLAKE2b-256 f263076fb19390d7331a8dd1a790684ad8a88e56deb6322a0c99ccad105d2eaa

See more details on using hashes here.

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

Hashes for napari_locpix-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 04b20df181a32c1a6c76790c3b9769f1fda4b2b9e4a1bdf55d37d10dfcc11706
MD5 cff74f752209d80c04b5bc922d2a89bb
BLAKE2b-256 6155d9af1e53e2d302f141c8ed44666d00faa0ee017ac9a383925d7eec3152f3

See more details on using hashes here.

Supported by

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