There are dozens of commands in SPEC/FOURC available through the command line interface. All user commands are fully documented in the code-base. In general, the custom code for SPEC/FOURC follows the syntax where the base name (MONO, XES, AMP, etc.) is uppercase and the action prefix (set, move, stat, etc.) is lowercase with all arguments space delimited in lowercase except for movement of optics (which are uppercase to minimize accidental moving).
Syntax and code instructions are available by simply running any command listed below without any arguments.
!!!Users should be careful not the execute any command or macro that does not appear in the beamline documentation or has not been provided by beamline staff as customs instructions; this could cause interruption to your experiment.!!!
Custom REIXS Specific Macros
Elliptically Polarizaing Undulator (EPU)
The EPU on REIXS is fully controlled by users. There are many options for configuration including: polarization, harmonic, gap offset, and linear inclined angle. There is also the option to have the offset and harmonic automatically changed based on the requested energy and polarization.
Commands
-
statEPU - shows the current status of the EPU and associated macros
-
setEPU - changes the configuration of the EPU
-
chkEPU - toggles on/off the EPU checking macros, including harmonic and offset
Monochromator (MONO)
The monochromator is generally only interacted with by changing the energy and selecting the optics. It should be that optics are changed as infrequently as possible, unless the the experiment requirements justify changing more than once during your beamtime (staff approval required). As such, optic moves can not be used in a macro and if so data collection will not proceed as user confirmation is required. Refer to the endstation specific manuals on instructions for selecting optics for specific energy ranges.
Commands
-
statMONO - displays the current status of all relevant monochromator parameters
-
moveE - used to move the energy in an intelligent fashion with backlash correction
-
moveM - moves the mirror to select the desired coating stripe
-
moveG - moves the grating tray to select the desired grating
Flux Attenuation (FLUX)
Many of the detectors on the REIXS beamline are count rate limited, in that it is common to reduce the incident beam intensity to ensure the detectors are operating in the required dynamic range. The flux can be attenuated by a set of horizontal jaws after the monochromator, but before the exit slit. This should ensure minimal impact the beam characteristics with only a slight reduction in the horizontal size. In addition, the entire beam can easily be attenuated completely without closing a valve of shutter, which could change the ambient lighting conditions in the experimental chamber. This function is useful for determining the dark counts on light sensitive detectors.
Commands
-
statFLUX - displays the current beam attenuation status and fast-shutter state
-
setFLUX - used to reduce the incoming beam intensity or shutter the beam completely
Exit Slit (ES)
The exit slit is the single most important aperture on the REIXS beamline. It is responsible for providing a nearly monochromatic beam. As such, changing the exit slit from the nominal size of 25um will affect the overall energy resolution as well as both the beam size and beam intensity. The increase in the beam size and the energy resolution has significant impact on the overall resolution for RIXS experiments. While users are welcome to change the exit slit size to suit the experiment, we stress that it should not be used an beam attenuator as this should be accomplished using the setFLUX macro. Changing the exit slit size may be required to improve the energy resolution or increase the experiment throughput above detection limits.
Commands
-
statES - displays the current width of the exit slit in microns
-
setES - changes the exit slit to the desired width in microns
Beam Status (BEAM)
There are many valves and shutters along the beamline that can block the beam. These components are monitored to ensure the user does not collect data without incident photons. There are some components that are closed and opened normally, which will open automatically if data collection is attempted or the user toggles the beam. These components are closed due to sample changes or possible ring trips. There are also components that should not be closed, but can close in the event of equipment failure; these are reported and data acquisition is halted. Intervention by beamline staff is required.
Commands
-
statBEAM - displays the current status of beam related equipment such as valves and shutters as well as status macro states
-
setBEAM - toggles the incident beam, checking to ensure there is no valve or shutter attenuating the beam (fast shutter is excluded)
-
chkBEAM - toggles the beam checking macros that ensure all shutters and valves are open and not attenuating the beam (fast shutter is excluded)
REIXS Specific Scanning Macros
There are two basic scans that can be performed by the beamline: scanning the incident energy while collecting detector data or “scanning time” while collecting detector data. The energy scan is used typically for collecting x-ray absorption spectra, while the time scan be used for many functions and allows one to set the exposure rate and to collect data at a specific incident energy.
Commands
-
Escan - Performs an energy scan with multiple regions with various intervals for a fixed time interval
-
Tscan - Collects data for the specified time, time interval and energy
Datafile Information (DIR)
The data on the REIXS beamline is written largely to HDF5 and ASCII to a lesser extent; ASCII data is used for log files and legacy SPEC/FOURC data files. The location and current selection of these files can be displayed with a custom macro.
Commands
-
statDIR - displays the current selection for both local/network datafiles as well as log and error files
Native SPEC/FOURC Scanning Macros
There many macros in SPEC/FOURC that can be used to scan motors or time. There are some very common macros available on both endstations, those are listed here. The geometry dependent macros that are only available on the RSXS Endstation are listed elsewhere.
File Selection
The selection of the filename in SPEC/FOURC is accomplished by simply selecting the file. If it does not exist, it will create it in the appropriate directory. Generally, we write data to HDF5, but we have retained the native SPEC/FOURC basic ASCII file that can be used to plot 1-D data or for easy error and parameter checking.
Commands
-
newfile - selects a filename to write data, existing filenames can be used and will be appended
Comments
Comments are character strings that can be saved in the native SPEC/FOURC ASCII datafile as well as the HDF5 files. The comments will live forever with data and therefore it is a good idea to make comments attached to the data rather than in a logbook. The are many options that allow one to make a comment before or after the data is collected as well as retroactively later in the experiment. Please ensure the file pertaining the comments is set to the active datafile.
Commands
-
com - makes a comment on the proceeding scan
-
bcom - makes a comment on the preceding scan
-
scom - makes a comment on the SCAN# that is specified
Single Motor Step Scans
In principle, any motor listed can be scanned, which is the definition of a motor. However, please ensure you been instructed by beamline staff that this motor can be scanned. Some particulars provided may include: incremental motion, preferred direction and frequency of scans. If you haven’t been instructed to scan a motor, check with beamline staff.
Commands
-
ascan - scans a single motor with a constant step size
-
rscan - scans a single motor with variable step size
-
dscan - a relative scan of a single motor with a constant step size
-
lup - performs the same scan as a relative scan, but moves back to the start at the end
-
mesh - performs a mesh scan of multiple motors with a constant step size
-
dmesh - performs a relative mesh scan of multiple motors with a constant step size