Imagin

Imagin is a 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.
• Despeckling.
• Automatic background elimination using prominence filtering (de-basing).
• 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.

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 the EPICS PVAccess image simulator (epicsdev.imagegen)

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

Animate by changing image parameters from a Python script:

import time
import numpy as np
from p4p.client.thread import Context

iface = Context("pva")

one_to_zero = 1 - np.linspace(0, 1, 11)
scales = np.append(one_to_zero[:-1], np.flip(one_to_zero)[2:])

for scale in scales:
    iface.put("image0:gridScaleX", scale)
    time.sleep(0.1)