Source¶

The incident beam, produced, conditioned, and defined before the sample. The controllers that drive these devices are on the Controls page. Each device pairs its human name with its control 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.

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))

Insertion devices¶

The undulator source: a pair on the S04ID straight section feeding the 4-ID 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: 4-ID'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). They bind the catalog PhaseRetarder Family (graduated on the rule-of-three across 4-ID, P09, and P22).

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