Skip to main content

napari-point-proofread

https://github.com/LaboratoryOpticsBiosciences/napari-point-proofread

License MIT PyPI Python Version tests codecov napari hub npe2 Copier

Proofreading point annotations on images with napari


This napari plugin was generated with copier using the napari-plugin-template.

Installation

You can install napari-point-proofread via pip:

pip install napari-point-proofread

If napari is not already installed, you can install napari-point-proofread with napari and Qt via:

pip install "napari-point-proofread[all]"

Beginner Quick Guide (Step-by-Step)

This plugin provides two panels in napari:

  • Plugins > Point Proofread > Manual Proofread
  • Plugins > Point Proofread > Proofread Predictions (from csv)

1. Open napari and load your data

  1. Start napari:

    napari
    
  2. Drag and drop your image into the viewer (or use File > Open File(s)...).

  3. If you have prediction points, also load the CSV file.

Screenshot placeholder: napari with raw image and optional CSV loaded

2. Open the plugin widgets

  1. Open Plugins > Point Proofread > Manual Proofread.
  2. (Optional) Open Plugins > Point Proofread > Proofread Predictions (from csv) if you want to review model predictions.

Screenshot placeholder: plugin menu showing both widgets

3. Prepare the image for proofreading

In Manual Proofread:

  1. Select your image in Image layer.
  2. Click Convert to RGB (for 4D channel-first/channel-middle data).
  3. Click Normalize (perc=99) to improve visibility.
  4. Use Contrast max and ZYX scale sliders as needed.
  5. (Optional) Click Make grid to create a labeled grid overlay for systematic review.

Tip: In napari layer list, right-click an RGB layer and use Split RGB when needed (often helpful for 3D inspection).

Screenshot placeholder: Manual Proofread panel and adjusted image view

4. Add or edit proofreading points

  1. Create or select a Points layer.
  2. In Point Layer Tools, set Point size for better visibility.
  3. (Optional) Enable Enable class annotation.
  4. Choose a class number and use Assign class to selected to label points.

Screenshot placeholder: points editing and class annotation controls

5. Review prediction CSV points by confidence (optional)

In Proofread Predictions (from csv):

  1. Select the loaded prediction points layer.
  2. Adjust Min probability.
  3. Click Threshold probability (csv) to create/update a filtered layer (threshold_prob).

Screenshot placeholder: thresholded prediction points layer

6. Save your corrected points

  1. Select your final points layer.
  2. Save as CSV from napari.
  3. In the save dialog, set Files of type to Point Proofread (*.csv) (as shown in the image). Otherwise, values that should remain integers (for example, class labels) may not be saved correctly.

Screenshot placeholder: saving points layer to CSV

Developer Setup

After cloning the repository, you can set up a development environment with conda:

pip

Step 1: Create and activate the corresponding conda environment

conda create -n napari-point-proofread -c conda-forge python=3.11 pip -y
conda activate napari-point-proofread

Step 2: Install requirements with pip

cd napari-point-proofread
pip install -e . --group dev

--group requires pip >= 25.1.

Step 3: Test the plugin by running napari

napari

The plugin should appear under Plugins > Point Proofread

With uv

uv sync
uv run napari

Run the tests with uv run pytest (current environment) or uv run tox (full matrix).

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-point-proofread" is free and open source software

Issues

If you encounter any problems, please [file an issue] along with a detailed description.

Metadata

Release files for napari-point-proofread 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for napari-point-proofread 0.4.0
File Size Uploaded Provenance Actions
napari_point_proofread-0.4.0.tar.gz 3.7 MB With provenance Details for napari_point_proofread-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for napari-point-proofread 0.4.0
File Interpreter ABI Platform Actions
napari_point_proofread-0.4.0-py3-none-any.whl Python 3 none any Details for napari_point_proofread-0.4.0-py3-none-any.whl

Total release size: 3.7 MB

Release files / napari_point_proofread-0.4.0.tar.gz

Download URL napari_point_proofread-0.4.0.tar.gz
Size 3.7 MB
Tags Source
SHA-256 checksum
How to use checksums
5614211f5bd1dd36272e4314dae8b8987cd0a0b96e30eba287a89add67f96b59
BLAKE2b-256 checksum
How to use checksums
2e31951c0e1a2fdd530e7ebf1d9c3e5ae3b1f65b085fb60b52df888946b6c2d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Release files / napari_point_proofread-0.4.0-py3-none-any.whl

Download URL napari_point_proofread-0.4.0-py3-none-any.whl
Size 18.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3f653d6080a837a91491f0ed5356f69ea92ff342555d289b6232fa4b9da8255b
BLAKE2b-256 checksum
How to use checksums
7e0f781334392cdaa390af4662a421c38ee0963f50c1c7eee95ea260bbc4652d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Security for napari-point-proofread 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for napari_point_proofread-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page