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/esm/beamline.yaml. Edit the descriptor, not this page. For the CORA Asset model, settings, vendor catalog, drawings, and wiring, see Inventory.

Property	Value
Facility	nsls2
Sector	Sector 21
Tier	Unit
Source	insertion-device (confirm: two elliptically-polarizing undulators on the SR:C21-ID straight (EPU57 on G1A, EPU105 on G1B); gap + phase (polarization) per device; the dual-EPU coordination and periods are SRC-1)

Enclosures¶

Enclosure	Role	Facility	Permit signal
`21-ID-A`	optics-hutch	`nsls2`	confirm: PSS permit leaf not in source; front-end / FOE shutters XF:21ID-PPS{Sh:FE} and XF:21IDA-PPS{PSh} (PSS-1)
`21-ID-B`	optics-hutch	`nsls2`	confirm: PSS permit leaf unknown; the PGM optics zone (ENC-1)
`21-ID-C`	optics-hutch	`nsls2`	confirm: PSS permit leaf unknown; the branch optics + exit slits; branch shutters XF:21IDC-PPS{PSh:1A/1B} (ENC-1)
`21-ID-D`	experiment-hutch	`nsls2`	confirm: PSS permit leaf unknown; the ARPES endstation (ENC-1)

Insertion devices¶

The two elliptically-polarizing undulators on the SR:C21-ID straight.

Enclosure: 21-ID-A.

Note

Two InsertionDevice Assets; each adds a polarization (phase) axis beyond gap, carried as a setting (SRC-1).

Name	Family	PV	Key specs	Replaceable	Status
`Undulator_1`	`InsertionDevice`	`SR:C21-ID:G1A{EPU:1`	EPU57 elliptically-polarizing undulator (gap + phase); period and polarization model are SRC-1		`new` `confirm`
`Undulator_2`	`InsertionDevice`	`SR:C21-ID:G1B{EPU:2`	EPU105 elliptically-polarizing undulator (gap + phase); coordinated with EPU57 (SRC-1)		`new` `confirm`

Optics¶

The front-end mirror, the polarization diagnostic, and the front-end / FOE shutters.

Enclosure: 21-ID-A.

Note

M1 is the first mirror; Diagon is the soft X-ray polarization diagnostic (DIAG-1).

Name	Family	PV	Key specs	Status
`Mirror_1`	`Mirror`	`XF:21IDA-OP{Mir:1-Ax:4_`	first mirror M1; coatings and axis roles are OPT-1	`new` `confirm`
`PolarizationDiagnostic`	`GenericProbe`	`XF:21IDA-OP{Diag:1`	ESM Diagon soft X-ray polarization diagnostic; classification a placeholder (DIAG-1)	`new` `confirm`
`FrontEndShutter`	`Shutter`	`XF:21ID-PPS{Sh:FE}`	front-end safety shutter, PPS-gated	`new` `confirm`
`FOEShutter`	`Shutter`	`XF:21IDA-PPS{PSh}`	first-optics-enclosure photon shutter	`new` `confirm`

Monochromator¶

The plane-grating monochromator that selects the soft X-ray energy, the M3 mirror, and the PGM slits.

Enclosure: 21-ID-B.

Note

PGM is the plane-grating monochromator: a premirror (Mirror_Pitch) plus an interchangeable grating (Grating_Pitch / Grating_Trans) at a fixed-focus c-value (Focus_Const) set the energy. It reuses the catalog GratingMonochromator Family (ESM is the 3rd soft X-ray PGM after SIX + CSX). M3 is a hexapod-mounted mirror.

Name	Family	PV	Key specs	Status
`Monochromator`	`GratingMonochromator`	energy: `XF:21IDB-OP{Mono:1-Ax:8_Eng}Mtr` focus_const: `XF:21IDB-OP{Mono:1-Ax:8_Cff}Mtr` grating_translation: `XF:21IDB-OP{Mono:1-Ax:8_GT}Mtr` mirror_pitch: `XF:21IDB-OP{Mono:1-Ax:8_MP}Mtr` grating_pitch: `XF:21IDB-OP{Mono:1-Ax:8_GP}Mtr`	plane-grating monochromator; grating line densities and energy range are MONO-1	`new` `confirm`
`Mirror_3`	`Mirror`	`XF:21IDB-OP{Mir:3-Ax:11`	hexapod-mounted mirror M3 (OPT-1)	`new` `confirm`
`MonoSlit_Upstream`	`Slit`	`XF:21IDB-OP{Mono:1-Slt:7_U_1`	upstream PGM slit (OPT-2)	`new` `confirm`
`MonoSlit_Downstream`	`Slit`	`XF:21IDB-OP{Mono:1-Slt:8_D_1`	downstream PGM slit (OPT-2)	`new` `confirm`
`MirrorSlit_3`	`Slit`	`XF:21IDB-OP{Mir:3-Slt:10_U_1`	M3 slit (OPT-2)	`new` `confirm`

Refocusing¶

The KB refocusing pair, the M4B mirror, the exit slits that set the energy resolution, and the branch shutters.

Enclosure: 21-ID-C.

Note

M4A is the KB focusing pair, M4B a hexapod mirror; the A/B exit slits are the PGM resolution-defining elements for the two endstation branches (OPT-1, OPT-2).

Name	Family	PV	Key specs	Status
`Mirror_4A`	`Mirror`	`XF:21IDC-OP{Mir:4A-`	Kirkpatrick-Baez refocusing pair M4A (OPT-1)	`new` `confirm`
`Mirror_4B`	`Mirror`	`XF:21IDC-OP{Mir:4B-Ax:B4`	hexapod-mounted mirror M4B (OPT-1)	`new` `confirm`
`ExitSlit_A`	`Slit`	`XF:21IDC-OP{Slt:1A-Ax:A1`	A-branch exit slit; sets the energy resolution (OPT-2)	`new` `confirm`
`ExitSlit_B`	`Slit`	`XF:21IDC-OP{Slt:1B-Ax:B1`	B-branch exit slit (OPT-2)	`new` `confirm`
`PhotonShutter_A`	`Shutter`	`XF:21IDC-PPS{PSh:1A}`	A-branch photon shutter	`new` `confirm`
`PhotonShutter_B`	`Shutter`	`XF:21IDC-PPS{PSh:1B}`	B-branch photon shutter	`new` `confirm`