Skip to main content

A plugin to read Dioptic ARGOS archive files

Project description


License MIT PyPI Python Version tests codecov napari hub

A plugin to read Dioptic ARGOS archive files

This repo contains a reader plugin for DIOPTIC ARGOS Archive files, which have .zip file extension. Individual ARGOS layers are grouped into napari layer with stacks according to their illumination, stage XY position and Z-stack information.

The plugin implements delayed reading using dask.delayed so that one can quickly see the contents even for large archives with many layers. Note!: switching to volume rendering or swapping axes can trigger the loading of all ARGOS layers, which can take a long time for large archives.

ARGOS is an automated system for surface inspection according to ISO 10110-7.

This plugin is still experimental and does not support all features of ARGOS archives.

Currently, the plugin

  • can read Argos matrix archives containing regular image layers including:
    • ✅ segmentation masks
    • ✅ Z-stack metadata
    • ✅ Illumination metadata
    • ✅ proper scaling and affine transformation of layers
  • can read ❔✅ Argos line scan (polar) archives with minimal support (no metadata parsing) This has not been tested on many archives.

Not supported are:

  • ❌ annotated archives
  • ❌ pyramid image structures
  • ❌ Line segmentation metadata
  • ❌ color metadata
  • ❌ ...


Opening files

Simply drag and drop an ARGOS Archive .zip file onto the napari canvas or use File->Open to open it.

Synchronizing contrast limits

By default, after reading an archive, each napari layer will have their own contrast limits, so you can adjust these contrast limits individually.

The reader plugin registers a custom key binding after reading an ARGOS archive. Pressing the s key will allow you to synchronize the contrast limits for a set of layers:

  • If you select a single napari layer corresponding to an image/stack from an ARGOS archive, all napari image layers that were loaded from this archive now have their contrast limits synchronized, i.e. changing the contrast limits of any of them will adjust the contrast limits of all of the layers belonging to the same archive.
  • If you select multiple napari layers and press s all of these and only these napari layers will have their contrast limits synchronized, regardless of whether they belong to the same ARGOS archive or not.


If you have napari installed you can install the plugin from the napari hub through the Plugins -> Plugin Manger menu entry. After waiting a short while for napari to retrieve the plugins available from the hub, simply enter "argos" in the filter line entry field at the top to narrow down the plugin list and click install.

You can install napari-argos-archive-reader via pip:

pip install napari-argos-archive-reader

To install latest development version :

pip install git+


Distributed under the terms of the MIT license, "napari-argos-archive-reader" is free and open source software

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-argos-archive-reader-0.0.7.tar.gz (12.3 kB view hashes)

Uploaded Source

Built Distribution

napari_argos_archive_reader-0.0.7-py3-none-any.whl (11.6 kB view hashes)

Uploaded Python 3

Supported by

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