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 RIXS Endstation Macros
Sample Stage (SS)
The sample stage on the RIXS Endstation is a 4-axis stage; ssx, ssy, ssz and ssth for X, Y, Z and Theta, respectively. These native axes are rarely interacted with directly (only ssx is used to move the sample along the beam path, thereby focusing the sample but not moving the footprint of the beam on the sample) as they are orthogonal the beam, but not the sample geometry. As such, a referenced coordinate system includes: ssh, ssd, ssv and ssa for horizontal, depth, vertical and angle, respectively. This coordinate system is advantageous to move the sample plate in the focus of the beam and the various detectors. There are many macros to recall and save sample positions that can be added to larger macros to assist with automation. Additionally, the sample name is saved the datafile and can be used in automated logbook generation.
Commands
-
statSS - displays the current position and current sample selected as well as a list of all available sample positions
-
setSS - appends the sample position and sample name to the list of available preset positions
-
moveSS - moves the sample stage to an available preset position, including system presets such as transfer (tran) and measure (meas)
Endstation Lamp (LAMP)
The endstation light, to which we refer to as a “Lamp” is remotely controlled. The lamp has a few side effects: (1) It will actually heat the sample above ambient temperature if left on long enough and during cryogenic cooling will significantly heat the sample, (2) the SDDs and optical spectrometer (XEOL) are also light sensitive and the lamp needs to be turned off during measurements. Conveniently, there is a macro that will automatically turn off the lamp during counting, so even if you forget to turn off the lamp, the software will ensure useful data is always collected.
Commands
-
statLAMP - Displays the status of the lamp including brightness and temperature
-
setLAMP - Controls the state of the lamp, turning it off and on primarily
Current Amplifiers (AMP)
The RIXS endstation uses two current amplifiers to measure the drain currents from a gold mesh, upstream of the sample, and the sample stage. In order to measure picoamp currents we use a system where there current is measured as follows:
-
The current is converted to a voltage with a the SR570 current amplifiers. The range is 0-5 V and the sensitivity is set by user as a conversion using the setAMP macros.
-
The voltage is then converted to a frequency in real-time and counted on the master counter.
It is important to keep the voltage of the amplifiers between 0-5 V otherwise the signal will be clipped. This translates to keeping the frequency between 0-1 MHz by the user. See the Collecting XAS Spectra for further instructions.
Commands
-
statAMP - Displays the current gain of the installed current amplifiers
Note: The gain is only the last setting. If it was manually changed at the device, it may be inaccurate. -
setAMP - Sets the gain of the amplifiers, either relative or absolute
X-ray Emission Spectrometer (XES)
The main x-ray emission spectrometer, i.e. the grating spectrometer, needs to configured by the user. This requires such tasks as setting the grating one would like to use and the central energy. In addition, alignment requires inserting a mask/pinhole that is accessed with this class.
Commands
-
statXES - Displays the current status of the spectrometer including: grating, energy, shift file, order, etc.
-
setXES - Allows the user to select the grating to be used and the aperture: mask or pinhole
-
moveXES - Moves the spectrometer to the central energy selected; detector tilt and higher order diffraction can also be selected.
Optical Spectrometer (XEOL)
The optical spectrometer used is a commercially available device that is coupled to the endstation via a collecting lens system and fibre optic cable. This spectrometer is not a “detector” in the strict sense and requires that the user select the frame rate in order to optimize the quality of the spectra collected. The frame number and total time will be automatically adjusted to match the data acquisition command.
Commands
-
setXEOL - Allows the user to set frame rate of the spectrometer