APS¶

APS is a Federation Facility (FacilityKind = Site): the home for the facility-level facts an experiment inherits but does not own. The beamlines it hosts link up to this page rather than restating it.

Generated from the site descriptor

This page is generated from deployments/aps/site.yaml. Edit the descriptor, not this page.

Property	Value
Facility code	`aps`
Institution	Argonne
Control plane	EPICS / ophyd
Fleet role	Operational pilot
Beamlines	10
Sectors	`Sector 2`, `Sector 4`, `Sector 7`, `Sector 8`, `Sector 9`, `Sector 12`, `Sector 13`, `Sector 32`, `Sector 19`

The beamlines¶

What CORA models at APS. Each row's badges and one-line summary are read from the beamline's own descriptor; follow the link for the full model.

Beamline	Maturity	Evidence	Coverage	What it is
2-BM	Pilot	Live	Full	bending-magnet micro-CT, the operational pilot
2-ID	Design	Narrative	Full	scanning fluorescence microprobe (2-ID-D hutch), mined from the EAA toolkit
7-BM	Design	Narrative	Full	multi-technique flow and combustion imaging, recommissioned for APS-U
32-ID	Design	Narrative	Partial	canted multi-instrument: optics spine and transmission X-ray microscope
19-BM	Design	Design report	Full	bending-magnet autonomous high-throughput tomography (formerly branded FACT)
4-ID	Model	Controls config	Full	polarization and magnetic scattering across four stations (formerly branded POLAR); introduces the POLAR polarization / magnetism vocabulary (the graduated `PhaseRetarder`, `PolarizationAnalyzer`, and `Magnet` catalog Families)
8-ID	Model	Controls config	Full	X-ray photon correlation spectroscopy (XPCS) across four stations; the fleet's first coherent XPCS beamline, earns the xpcs Method
9-ID	Model	Controls config	Full	the Coherent Surface Scattering Instrument (CSSI) across two stations
12-ID	Model	Controls config	Full	Bonse-Hart ultra-small-angle X-ray scattering (USAXS) plus pinhole SAXS / WAXS, Sector 12; CORA's first USAXS deployment
13-ID	Model	Controls config	Full	GSECARS high-pressure X-ray diffraction on a diamond anvil cell, Sector 13; the fleet's first extreme-conditions sample environment

The pilot 2-BM runs live; 7-BM, 19-BM, and 32-ID are in design; the Sector 4/8/9/12/13 beamlines are reverse-engineered models. All share the APS storage-ring envelope.

The techniques adapted here¶

A Practice is APS's facility-tuned form of a cross-facility Method: the ISA-88 Site Recipe layer. The Method names a technique abstractly in the Catalog; the Practice is how the beamline runs it here. Each row links up to the Method it adapts.

Practice	Method
`APS_standard_dark_field_practice`	`dark_field`
`APS_motor_homing_practice`	`motor_homing`
`2BM_resolution_practice`	`resolution_alignment`
`2BM_focus_practice`	`focus_alignment`
`2BM_alignment_practice`	`center_alignment`
`2BM_roll_practice`	`roll_alignment`
`2BM_pitch_practice`	`pitch_alignment`
`2BM_dark_field_practice`	`dark_field`
`2BM_flat_field_practice`	`flat_field`
`2BM_sensitivity_characterization_practice`	`sensitivity_characterization`
`2BM_hexapod_reboot_practice`	`hexapod_reboot`
`2BM_tomography_practice`	`tomography`
`2BM_streaming_tomography_practice`	`streaming_tomography`
`2BM_mosaic_practice`	`mosaic_tomography`
`2BM_continuous_rotation_practice`	`continuous_rotation_tomography`
`2BM_multi_energy_practice`	`tomography`
`2BM_energy_characterization_practice`	`energy_characterization`
`8ID_xpcs_practice`	`xpcs`
`9ID_xpcs_practice`	`xpcs`

Planned: 29 further Practices.

What this Site provides¶

Beyond the shared beam, cooling, and vacuum every Site provides, CORA's model tracks these facility resources:

APS liquid helium (LiquidHelium)
Liquid nitrogen (LiquidNitrogen) (pending)
Gas mixtures (ProcessGas) (pending): sample environments
7-BM compressed air (CompressedAir) (pending): high-volume plant for 7-BM flow and combustion experiments

Safety and governance¶

Before an experiment runs it clears the facility's safety forms (Clearances).

Clearance	Kind	Binds
`Facility umbrella`	`ESAF`	APS Site Asset

Planned clearances: Per-experiment ESAFs, Synchrotron access, Door interlocks, 7-BM flammable-gas experiment ESAF.

Every action CORA records is attributed to a principal registered facility-wide; human display names live in actor_profile, not the event-sourced Actor record.

Person or service	Kind
APS Operator	`human`
Run Debrief	`agent`
APS Experiment Safety Review Board	`human`
2-BM Beamline Scientist	`human`
Proposal 2026-1234 PI	`human`
Proposal 2026-1235 PI	`human`
Proposal 2026-1236 PI	`human`
Proposal 2026-1237 PI	`human`
Sample-of-opportunity PI	`human`

Agents are principals too: each shares its id with an Access Actor (kind=agent) so its writes attribute like a person's. Active agents are advisory (they observe and write Decisions, never gate Run state).

Agent	Version	Model
`RunDebriefer`	`1.0.0`	`anthropic / claude-haiku-4-5`
`CautionDrafter`	`1.0.0`	`anthropic / claude-sonnet-4-6`

Planned agents: RunSupervisor, CautionPromoter, ClearanceExpirer, ClearanceWatcher, RunInitiator (deterministic, rule-based; when enabled they act only through a command the spine already exposes).

Active cautions¶

Hazards and quirks operators carry forward; they advise or gate work without being part of the measurement.

Notice (APS Site Asset): Top-up injections cause brief beam-flux transients (~0.5s) every few minutes

Planned: 5 further cautions under confirmation.

How this maps to CORA's model¶

APS is a Federation Facility (FacilityKind = Site, facility_code = "aps"); the beamlines above are its root Assets (tier = Unit), and their sub-systems nest below by parent_id. See the CORA model for the aggregate shapes.