Inventory¶
The CORA Asset model for the operational core of 4-ID POLAR modelled today: the planned device tree and what still needs confirming.
This cut models the 4-ID-A optics spine and the per-station optics, diffractometers, sample environment, and detectors of 4-ID-B / G / H; the Raman station and the peripheral electronics are deferred (see Model). It is the cross-cutting reference view of the Source walk and the Sample and Detector pages. The shape is generated-honest: it is authored from the same beamline.yaml descriptor that the Source page renders from.
Devices bind to a catalog Family where one fits. POLAR's new device classes that recur but stay loose for gate-review (PhaseRetarder, PolarizationAnalyzer, Magnet, Laser, BeamPositionMonitor) bind loose Family strings; the Transfocator CRL now binds the graduated catalog Transfocator Family (a CRL focusing optic, earned across eight deployments), the TemperatureController controllers bind a catalog Family (graduated on the Diamond i22/i03/i11 rule-of-three, presenting the Regulator Role), and the diffractometer devices bind the catalog Goniometer Family (the graduation register is on Model). Unlike the design-phase scaffolds, the control handles are filled from the beamline config; no vendor Models are bound.
The Asset tree¶
Root Asset 4-ID POLAR (tier = Unit, facility_code = aps); sub-systems nest below by parent_id. The Raman station and the peripheral electronics are not in this tree (deferred).
| Asset | Tier | Family | Enclosure | Design spec / note |
|---|---|---|---|---|
4-ID POLAR |
Unit |
(root) | - | bound to the APS Site; four hutches |
Undulators |
Device |
InsertionDevice | 4-ID-A | undulator pair (S04ID:) |
PhaseRetarder_1/2/3 |
Device |
PhaseRetarder (loose) | 4-ID-A | diamond phase retarders, energy-tracking (POL-1) |
Monochromator |
Device |
Monochromator | 4-ID-A | vertical DCM (4idVDCM:) with crystal-select (MONO-1) |
WhiteBeamSlit / MonoSlit |
Device |
Slit | 4-ID-A | VDCM-crate slits |
DiamondWindow |
Device |
Window | 4-ID-B | 2-axis diamond window |
ToroidalMirror / HHLMirror |
Device |
Mirror | 4-ID-B | toroidal pre-focus and HHL bendable mirror (OPT-1) |
Transfocator |
Device |
Transfocator | 4-ID-G | CRL transfocator (OPT-2) |
KBMirror_B/G/H |
Device |
Mirror | 4-ID-B/G/H | per-station KB focusing mirrors (OPT-3) |
Filter_B/G/H |
Device |
Filter | 4-ID-B/G/H | per-station attenuator banks |
Diffractometer_Euler |
Device |
Goniometer | 4-ID-G | Huber Eulerian cradle; goniometer of the Diffractometer Assembly (DIFF-1) |
Diffractometer_HighPressure |
Device |
Goniometer | 4-ID-G | high-pressure diffractometer; goniometer of the Diffractometer Assembly (DIFF-1) |
PolarizationAnalyzer |
Device |
PolarizationAnalyzer (loose) | 4-ID-B | analyzer crystal stage (POL-2) |
Magnet_2T_B / Magnet_2T_E |
Device |
Magnet (loose) | 4-ID-B | 2 T sample magnets (MAG-1) |
Magnet_9T_H |
Device |
Magnet (loose) | 4-ID-H | high-field magnet (MAG-1) |
Magnet_Kepco_G |
Device |
Magnet (loose) | 4-ID-G | Kepco electromagnet; station a guess (TOPO-3, MAG-1) |
TemperatureController_336/340 |
Device |
TemperatureController | 4-ID-G | LakeShore controllers; catalog Family, presents Regulator (TEMP-1) |
SampleTable_B/H |
Device |
Table | 4-ID-B/H | sample positioning tables |
PumpProbeLaser |
Device |
Laser (loose) | 4-ID-H | Ventus laser (SAMPLE-1) |
SampleSlit_B/G/H |
Device |
Slit | 4-ID-B/G/H | per-station sample slits |
Eiger1M |
Device |
Camera | 4-ID-G | Eiger 1M area detector (DET-1) |
FlagCamera_HHL/Mono |
Device |
Camera | 4-ID-A | beam-view flag cameras |
VortexFluorescence |
Device |
BeamPositionMonitor (loose) | 4-ID-G | SGZ Vortex; classification a placeholder (DET-2, TOPO-3) |
XBPM_G/H, Sydor_G/H, TetrAMM_B |
Device |
BeamPositionMonitor (loose) | 4-ID-B/G/H | beam-position / intensity monitors (BPM-1) |
Scaler_1/2 |
Device |
GenericProbe | 4-ID-B | CTR8 scaler channels |
Families reused from the catalog: InsertionDevice, Monochromator, Slit, Window, Mirror, Filter, Table, Camera, GenericProbe, Transfocator (the CRL focusing optic), and Goniometer (the diffractometer sample circles). Bound to loose Family strings, held for gate-review: BeamPositionMonitor (recurs across beamlines but the abstraction is open), PhaseRetarder, PolarizationAnalyzer, Magnet, Laser (single beamline). Transfocator and TemperatureController recurred too and have since graduated to catalog Families (TemperatureController presents Regulator). The loose ones are earned into the catalog only when a confirmed device registers and a naming review accepts the name; the graduation plan is on Model.
Pending confirmations¶
Every value below is a config-read value or an inference awaiting the 4-ID team. Each is tracked by an open question; the answer lands in the descriptor and the row is removed.
| Value to confirm | Applies to | Status | Tracking |
|---|---|---|---|
| Beam topology (stations in series vs branched) | the root and optics spine | unknown-pending-confirmation |
(TOPO-1) |
| Raman station devices | a possible fifth enclosure | unknown-pending-confirmation |
(TOPO-2) |
| Vortex and Kepco station assignment | VortexFluorescence, Magnet_Kepco_G |
unknown-pending-confirmation |
(TOPO-3) |
| Control handles (EPICS PVs) | all devices | read-from-config-pending-confirmation |
(CTRL-1) |
| Hutch PSS permit signals | the four enclosures | unknown-pending-confirmation |
(PSS-1) |
| Undulator types and periods | Undulators |
unknown-pending-confirmation |
(SRC-1) (SRC-2) |
| Monochromator energy model | Monochromator |
unknown-pending-confirmation |
(MONO-1) |
| Mirror coatings and axis roles | ToroidalMirror, HHLMirror, KB mirrors |
unknown-pending-confirmation |
(OPT-1) (OPT-3) |
| Transfocator lens spec | Transfocator |
unknown-pending-confirmation |
(OPT-2) |
| Phase-retarder specs and state model | PhaseRetarder_1/2/3 |
unknown-pending-confirmation |
(POL-1) |
| Polarization analyzer spec | PolarizationAnalyzer |
unknown-pending-confirmation |
(POL-2) |
| Diffractometer circle geometry | the two diffractometers | unknown-pending-confirmation |
(DIFF-1) (DIFF-2) |
| Magnet fields and handles | the four magnets | unknown-pending-confirmation |
(MAG-1) |
| Temperature-controller channels | TemperatureController_336/340 |
unknown-pending-confirmation |
(TEMP-1) |
| Laser model or hazard treatment | PumpProbeLaser |
unknown-pending-confirmation |
(SAMPLE-1) |
| Detector camera model | Eiger1M |
unknown-pending-confirmation |
(DET-1) |
| Vortex classification | VortexFluorescence |
unknown-pending-confirmation |
(DET-2) |
| Beam-position vs intensity monitor split | the BPM Assets | unknown-pending-confirmation |
(BPM-1) |
| Cryogen and process-gas supplies | resources |
unknown-pending-confirmation |
(SUP-1) |