Source¶

The incident beam, produced, conditioned, and defined before the sample. A walk along the source-stage devices; the sample and detection stages are documented as their own composed-fixture pages, the controllers that drive these devices are on the Controls page, and the supplies they draw on are in Operations. Each device pairs its human name with the EPICS handle, its key specs, and whether it is field replaceable. new marks a device not yet modeled in CORA; confirm marks a value taken from the docs that staff have not yet verified.

Generated from the descriptor

This page is generated from the descriptor at deployments/4-id/beamline.yaml. Edit the descriptor, not this page. For the CORA Asset model, settings, vendor catalog, drawings, and wiring, see Inventory.

Property	Value
Facility	aps
Sector	Sector 4
Tier	Unit
Source	insertion-device (confirm: undulator pair on the S04ID straight section (PolarUndulatorPair, prefix S04ID:); periods and gaps unconfirmed (SRC-1))

Enclosures¶

Enclosure	Role	Facility	Permit signal
`4-ID-A`	optics-hutch	`aps`	confirm: APS PSS search-and-secure signal TBD (PSS-1)
`4-ID-B`	experiment-hutch	`aps`	confirm: APS PSS search-and-secure signal TBD (PSS-1)
`4-ID-G`	experiment-hutch	`aps`	confirm: APS PSS search-and-secure signal TBD (PSS-1)
`4-ID-H`	experiment-hutch	`aps`	confirm: APS PSS search-and-secure signal TBD (PSS-1)

Insertion devices¶

The undulator source: a pair on the S04ID straight section feeding the POLAR optics.

Enclosure: 4-ID-A.

Note

Modelled as one InsertionDevice Asset for the pair (PolarUndulatorPair); the period and gap detail is SRC-1, and whether to split it into two Assets is SRC-2.

Name	Family	PV	Key specs	Replaceable	Status
`Undulators`	`InsertionDevice`	`S04ID:`	undulator pair (PolarUndulatorPair); energy-tracking source (SRC-1)		`new` `confirm`

Polarization optics¶

The phase retarders that set the X-ray polarization state: POLAR's defining capability. Three diamond phase-retarder stages, energy-tracking, on the 4idam motor crate.

Enclosure: 4-ID-A.

Note

pr1, pr2, pr3 are PRDevice / PRDeviceBase stages (each th/x/y). PhaseRetarder is a loose Family: the polarization-control device class is genuinely new to CORA and not yet earned into the catalog (POL-1, FAM-1).

Name	Family	PV	Key specs	Status
`PhaseRetarder_1`	`PhaseRetarder`	th: `4idam4` x: `4idam1` y: `4idam2`	diamond phase retarder, energy-tracking (PRDevice); polarization control (POL-1)	`new` `confirm`
`PhaseRetarder_2`	`PhaseRetarder`	th: `4idam9` x: `4idam6` y: `4idam7`	second phase retarder (PRDevice); polarization control (POL-1)	`new` `confirm`
`PhaseRetarder_3`	`PhaseRetarder`	th: `4idam12` x: `4idam10` y: `4idam11`	third phase retarder (PRDeviceBase); polarization control (POL-1)	`new` `confirm`

Monochromator¶

The vertical double-crystal monochromator (4idVDCM) and its white-beam and mono slits.

Enclosure: 4-ID-A.

Note

mono is the VDCM with a crystal-select axis; mono_feedback is a beam-stabilization loop folded into the Monochromator note (MONO-1).

Name	Family	PV	Key specs	Status
`Monochromator`	`Monochromator`	th: `4idVDCM:m1` crystal_select: `4idVDCM:m2` y2: `4idVDCM:m3` thf2: `4idVDCM:m4` chi2: `4idVDCM:m5`	vertical DCM with crystal-select; energy range and saved positions unconfirmed (MONO-1)	`new` `confirm`
`WhiteBeamSlit`	`Slit`	hor: `4idVDCM:m9` diag: `4idVDCM:m10` pitch: `4idVDCM:m11` yaw: `4idVDCM:m12`	white-beam slit upstream of the mono (4idVDCM crate)	`new` `confirm`
`MonoSlit`	`Slit`	top: `4idVDCM:m14` bot: `4idVDCM:m13` inb: `4idVDCM:m15` out: `4idVDCM:m16`	post-mono slit (4idVDCM crate)	`new` `confirm`

Front end optics¶

The diamond window, toroidal pre-focusing mirror, and HHL (high-heat-load) mirror that condition the beam into the experimental stations.

Enclosure: 4-ID-B.

Note

hhl_mirror is a multi-axis HHL mirror (bend, pitch, ellipticity); t_mirror is a toroidal mirror. Window/Mirror are catalog Families.

Name	Family	PV	Key specs	Status
`DiamondWindow`	`Window`	x: `4idbSoft:m1` y: `4idbSoft:m2`	diamond window on a 2-axis stage	`new` `confirm`
`ToroidalMirror`	`Mirror`	`4idbToro:`	toroidal pre-focusing mirror (OPT-1)	`new` `confirm`
`HHLMirror`	`Mirror`	y: `4idHHLM:m1` x: `4idHHLM:pm1` pitch: `4idHHLM:pm2` curvature: `4idHHLM:pm3` ellipticity: `4idHHLM:pm4` us_bend: `4idHHLM:m4` ds_bend: `4idHHLM:m5`	high-heat-load bendable mirror; piezo fine axes plus benders (OPT-1)	`new` `confirm`

Beam conditioning¶

The compound refractive lens transfocator and the per-station filters and KB mirrors shared across the experimental branches.

Enclosure: 4-ID-G.

Note

crl is a CRL transfocator: it reuses the graduated catalog Transfocator Family, a CRL focusing optic; its lens spec is OPT-2. The KB mirrors (bkb/gkb/hkb) are per-station Kirkpatrick-Baez focusing pairs bound to the Mirror Family; their internal axis maps are OPT-3.

Name	Family	PV	Key specs	Status
`Transfocator`	`Transfocator`	`4idPyCRL:CRL4ID:`	compound refractive lens transfocator, energy-tracking; serves 4-ID-G and 4-ID-H (OPT-2)	`new` `confirm`
`KBMirror_B`	`Mirror`	rot: `4idbSoft:m15` x: `4idbSoft:m16`	4-ID-B KB focusing mirror (bkb); full axis map is OPT-3	`new` `confirm`
`KBMirror_G`	`Mirror`	`4idgKB:`	4-ID-G KB focusing mirror (gkb, GKBDevice); axis map is OPT-3	`new` `confirm`
`KBMirror_H`	`Mirror`	`4idhKB:`	4-ID-H KB focusing mirror (hkb, HKBDevice); axis map is OPT-3	`new` `confirm`

Filters¶

The per-station attenuator filter banks.

Enclosure: 4-ID-B.

Note

APSFilter / AVSfilters banks; bound to the Filter catalog Family.

Name	Family	PV	Key specs	Status
`Filter_B`	`Filter`	`4idbSoft:filter:`	4-ID-B filter bank	`new` `confirm`
`Filter_G`	`Filter`	`4idPyFilter:FL1:`	4-ID-G filter bank	`new` `confirm`
`Filter_H`	`Filter`	`4idPyFilter:FL2:`	4-ID-H filter bank	`new` `confirm`