gige

GigE camera acquisition tool for EPICS-controlled cameras. Configures the camera via EPICS PVs and saves frames as TIFF files.

Project structure

src/gige/
    __init__.py   # exports Gige1Camera and load_config
    camera.py     # Gige1Camera class
    main.py       # CLI entry point
    utils.py      # load_config helper
config.yaml       # example configuration
example_script.py # template for writing your own acquisition scripts

Installation

Install the package into your Python environment (this also installs all dependencies):

pip install -e .

Or with uv:

uv sync

Running from the command line

After installation, run the acquisition script with:

uv run gige config.yaml
uv run gige --help
uv run gige -v config.yaml   # verbose/debug logging

Using the camera in a script (e.g. in Spyder)

Copy example_script.py from this project to wherever you keep your own scripts and rename it. It shows how to configure and create a camera instance, check PV values, and run conditional acquisitions. Edit the cfg dict at the top to match your camera and output settings.

Configuration

All parameters for the CLI are set in a YAML file. See config.yaml for an example with descriptions of each field.