How hz-b/seq-quince works
seq-quince is an asynchronous, YAML-configured scheduler for EPICS beamline devices. The main workflow loads and merges beamline configuration and presets, constructs devices, converts a selected preset into grouped move steps, then executes them with timeout and optional rollback handling. Snapshot capture and the varied built-in device types are distinct product capabilities. Source excerpts and the index support the principal orchestration; several device implementations and optional integrations are represented from README or index evidence rather than inspected in full.
Main entry points: factory.py Device Factory · runner.py Run Operations · config_manager.py Config Manager · device_abs.py Device Contract
Components 25
Configuration
- Config Manager
src/seq_quince/config_manager.py - Template YAML Loader
src/seq_quince/loader.py - Preset Snapshots
src/seq_quince/snapshot.py - Config Utilities
src/seq_quince/tools.py
Sequence Execution
- Scheduler CLI
src/seq_quince/scheduler_runner.py - Device CLI
src/seq_quince/device_runner.py - Run Operations
src/seq_quince/runner.py - Sequence Builder
src/seq_quince/sequence.py - Async Scheduler
src/seq_quince/scheduler.py
Device Runtime
- Device Factory
src/seq_quince/device/factory.py - Device Contract
src/seq_quince/device/device_abs.py - Resource Lifecycle
src/seq_quince/device/lifecycle.py
Hardware Integrations
- Actuator Device
src/seq_quince/device_concrete/actuator.py - Hexapod Device
src/seq_quince/device_concrete/hexapod.py - Zero Order Mono
src/seq_quince/device_concrete/mono_zero_order.py - Ophyd Motor
src/seq_quince/device_concrete/ophyd_motor.py - Scan Device
src/seq_quince/device_concrete/scan.py - PV Sequence
src/seq_quince/device_concrete/sequence.py - Simulation Device
src/seq_quince/device_concrete/sim.py - Toggle Device
src/seq_quince/device_concrete/toggle.py - Wait Condition
src/seq_quince/device_concrete/wait_condition.py - Option Lookup
src/seq_quince/device_concrete/_option_lookup.py
Other components
- Operator
- EPICS PVs
- kiwi-scan
Connections 31
- Operator → Scheduler CLI: runs preset
README.md - Operator → Device CLI: runs device
README.md - Scheduler CLI → Run Operations: dispatches to
src/seq_quince/scheduler_runner.py - Device CLI → Run Operations: dispatches to
src/seq_quince/device_runner.py - Run Operations → Config Manager: loads config
src/seq_quince/runner.py - Config Manager → Template YAML Loader: renders and parses
src/seq_quince/config_manager.py - Config Manager → Preset Snapshots: merges presets
src/seq_quince/config_manager.py - Config Manager → Config Utilities: resolves config path
src/seq_quince/config_manager.py - Run Operations → Device Factory: constructs devices
src/seq_quince/runner.py - Config Manager → Sequence Builder: builds preset steps
src/seq_quince/config_manager.py - Run Operations → Sequence Builder: builds single-device step
src/seq_quince/runner.py - Sequence Builder → Device Contract: targets devices
src/seq_quince/sequence.py - Run Operations → Async Scheduler: executes steps
src/seq_quince/runner.py - Async Scheduler → Device Contract: runs device steps
src/seq_quince/scheduler.py - Device Factory → Device Contract: creates implementations
src/seq_quince/device/factory.py - Device Contract → Resource Lifecycle: closes resources
src/seq_quince/device/device_abs.py - Device Factory → Actuator Device: instantiates type
src/seq_quince/device/factory.py - Device Factory → Hexapod Device: instantiates type
src/seq_quince/device/factory.py - Device Factory → Zero Order Mono: instantiates type
src/seq_quince/device/factory.py - Device Factory → Ophyd Motor: instantiates type
src/seq_quince/device/factory.py - Device Factory → Scan Device: instantiates type
src/seq_quince/device/factory.py - Device Factory → PV Sequence: instantiates type
src/seq_quince/device/factory.py - Device Factory → Simulation Device: instantiates type
src/seq_quince/device/factory.py - Device Factory → Toggle Device: instantiates type
src/seq_quince/device/factory.py - Device Factory → Wait Condition: instantiates type
src/seq_quince/device/factory.py - Zero Order Mono → Option Lookup: uses options
src/seq_quince/device_concrete/mono_zero_order.py - Wait Condition → Option Lookup: uses options
src/seq_quince/device_concrete/wait_condition.py - PV Sequence → EPICS PVs: reads and writes PVs
src/seq_quince/device_concrete/sequence.py - Scan Device → kiwi-scan: runs scans
src/seq_quince/device_concrete/scan.py - Actuator Device → kiwi-scan: uses actuators
README.md - Hexapod Device → kiwi-scan: uses actuators
README.md