Skip to main content

Imagin.

Imagin is fast interactive viewer and analyzer for streamed images and image files, built with Python, pyqtgraph, and SciPy.

Installation

Install the core application with file-based image support:

pip install imagin

Features

  • Input sources:

    • EPICS PVAccess and Channel Access
    • file system
    • HTTP image URLs
    • USB cameras
  • PNG is the default image format; other formats are also supported.

  • Fast, robust characterization of multiple objects using fitted ellipsoids.

  • Supports images with 16-bit or higher channel depth.

  • Image orientation control and arbitrary rotation.

  • Interactive zooming and panning.

  • Contrast and color-map control.

  • Region of interest (ROI) selection for image analysis.

  • ROI partitioning.

  • ROI projection plots.

  • Optional Gaussian fitting in 1D or 2D for improved precision.

  • De-speckling.

  • Automatic background elimination using prominence filtering (de-base).

  • Background subtraction using reference images.

  • Interactive calibration from pixels to millimeters.

  • Reference image slots for saving and restoring images.

  • Extensible through user-supplied add-ons.

  • Fast browsing and cleanup of image directories.

Imagin screenshot

Presentation

Examples

python -m imagin -b http https://cdn.esahubble.org/archives/images/large/heic1523b.jpg -t 100
python -m imagin -b file sample_images/*.jpg -t 100 -m 40
python -m imagin -b file ~/Pictures/*.png

Testing with EPICS PVAccess image simulator epicsdev.imagegen:

pip install epicsdev
python -m epicsdev.imagegen -c&
python -m imagin -t 100 image0:image -b pva -m9

Animate by changing image parameters from a python script:

import time, numpy as np
from p4p.client.thread import Context
iface = Context('pva')

oneTo0 = 1 - np.linspace(0,1,11)
scales = np.append(oneTo0[:-1], np.flip(oneTo0)[2:])
for scale in scales:
    iface.put('image0:gridScaleX',scale)
    time.sleep(.1)

Testing with EPICS Channel Access

The simulated EPICS camera can be run from Docker:

https://hub.docker.com/r/klauer/simioc-docker

python3 setup_SimDetector.py
python3 -m imagin -b epics sim:det -m 16 -t 80

Metadata

Release files for imagin 3.0.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 imagin 3.0.0
File Size Uploaded Provenance
imagin-3.0.0.tar.gz 1.3 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for imagin 3.0.0
File Interpreter ABI Platform
imagin-3.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.4 MB

Release files / imagin-3.0.0.tar.gz

Download URL imagin-3.0.0.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
b81f8ab96b669ea6dec4bd642eaed87cdf3f4db936c15bc6e2e8e7d3dca1117a
BLAKE2b-256 checksum
How to use checksums
a3a312aca5a714ec2cf8d923b7760bcfe8481cd36da58e2f389abf0d5a742b46
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Red Hat Enterprise Linux","version":"9.7","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / imagin-3.0.0-py3-none-any.whl

Download URL imagin-3.0.0-py3-none-any.whl
Size 48.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9c80355115a7c630c8fee22ea7c7cba158aa697097a9888d4c87622482dfa98c
BLAKE2b-256 checksum
How to use checksums
dc5b510197ed902ee9744817c28c820fc38829571ff541e2d082b73cda90d6a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Red Hat Enterprise Linux","version":"9.7","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for imagin 3.0.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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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

3.0.0 This release

2 release files No 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