NSLS-II¶
NSLS-II is the synchrotron site its beamlines run at. This page is the home for the facility-level facts an experiment inherits but does not own: the techniques adapted here, the resources a run draws on, the safety envelope it clears, and the people and agents who act in it. The beamline links up to these rather than restating them.
Generated from the site descriptor
This page is generated from deployments/nsls2/site.yaml. Edit the descriptor, not this page.
| Property | Value |
|---|---|
| Facility code | nsls2 |
| Kind | Site |
| Institution | Brookhaven National Laboratory |
| Beamlines | AMX, BMM, CHX, CMS, CSX, ESM, FMX, FXI, HEX, HXN, IOS, ISR, ISS, IXS, LIX, SIX, SMI, SRX, SST, XFM, XFP, XPD |
The techniques adapted here¶
A Practice is NSLS-II'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 |
|---|---|
Planned: FXI_tomography_practice, FXI_fly_tomography_practice, FXI_energy_change_practice, HXN_nano_tomography_practice, HXN_energy_change_practice, SRX_xrf_tomography_practice, SIX_rixs_practice, IXS_inelastic_scattering_practice, CSX_rsxs_practice, CSX_diffraction_practice, ESM_arpes_practice, ISS_xas_spectroscopy_practice, FMX_mx_data_collection_practice, FMX_grid_scan_practice, FMX_sample_exchange_practice, CMS_small_angle_scattering_practice, CMS_wide_angle_scattering_practice, CMS_grazing_incidence_scattering_practice, CMS_reflectivity_practice, XFM_scanning_fluorescence_microscopy_practice, LIX_solution_scattering_practice, LIX_sec_saxs_practice, LIX_microbeam_scanning_practice, HEX_tomography_practice, HEX_radiography_practice, HEX_energy_dispersive_diffraction_practice, HEX_powder_diffraction_practice, AMX_mx_data_collection_practice, AMX_grid_scan_practice, AMX_sample_exchange_practice, XFP_footprinting_practice, XFP_high_throughput_footprinting_practice, ISR_resonant_scattering_practice, ISR_surface_diffraction_practice.
The resources you draw on¶
Supplies are the continuously-available facility resources a run needs present before it can start: beam, cooling, vacuum. The facility tracks their availability; a run's required supplies are checked at the pre-flight gate.
| Supply | Kind |
|---|---|
Planned: Storage-ring beam current, Cooling water, Beamline vacuum, DCM liquid nitrogen.
The safety envelope¶
Before an experiment runs, it clears the facility's safety forms (Clearances), and operators carry forward hazards and quirks as Cautions. Both gate or advise the work without being part of the measurement itself.
| Clearance | Kind | Binds |
|---|---|---|
Planned: NSLS-II personal safety system.
Who acts here¶
Every action CORA records is attributed to a principal. At NSLS-II those are the people registered facility-wide (the operator on shift, safety reviewers, proposal PIs) and the autonomous agents. Human display names live in actor_profile (the editable, forgettable layer), not in the event-sourced Actor record, which carries only id and kind.
| Person or service | Kind |
|---|---|
Planned: NSLS-II beamline staff, NSLS-II safety review.
Agents are principals too. Each one's id is shared with an Access Actor (kind=agent) through a single cross-BC atomic write, so an agent's writes attribute the same way a person's do. The agents active here today are advisory: they observe and write Decisions, and never gate Run state. The planned agents are deterministic and rule-based; when enabled they act only by issuing a command the spine already exposes, through the same authorized path a person uses.
| Agent | Version | Model |
|---|---|---|
How NSLS-II is modeled¶
NSLS-II itself is not an Asset: it is a Federation Facility with FacilityKind = Site (facility_code = "nsls2"). The beamlines it hosts are the root Assets (tier = Unit, parent_id = None), each bound to the Site directly by facility_code. See the CORA model for the aggregate shapes.
| Asset | Tier | facility_code | Hosts |
|---|---|---|---|
AMX |
Unit |
nsls2 |
AMX |
BMM |
Unit |
nsls2 |
BMM |
CHX |
Unit |
nsls2 |
CHX |
CMS |
Unit |
nsls2 |
CMS |
CSX |
Unit |
nsls2 |
CSX |
ESM |
Unit |
nsls2 |
ESM |
FMX |
Unit |
nsls2 |
FMX |
FXI |
Unit |
nsls2 |
FXI |
HEX |
Unit |
nsls2 |
HEX |
HXN |
Unit |
nsls2 |
HXN |
IOS |
Unit |
nsls2 |
IOS |
ISR |
Unit |
nsls2 |
ISR |
ISS |
Unit |
nsls2 |
ISS |
IXS |
Unit |
nsls2 |
IXS |
LIX |
Unit |
nsls2 |
LIX |
SIX |
Unit |
nsls2 |
SIX |
SMI |
Unit |
nsls2 |
SMI |
SRX |
Unit |
nsls2 |
SRX |
SST |
Unit |
nsls2 |
SST |
XFM |
Unit |
nsls2 |
XFM |
XFP |
Unit |
nsls2 |
XFP |
XPD |
Unit |
nsls2 |
XPD |
Sub-systems and devices nested under a beamline are Assets with tier = Component or tier = Device, linked via parent_id. Being non-root, they do not carry facility_code; they inherit facility scope through the parent_id tree.