Macros at XRF

[UniqueIdentifier] 

# Scan Type
ScanType = EXAFS | XSW

MomentumTransfer = 0.1
XSWmode = Theta | Phi
ThetaZero = 0.05
PhiZero = -90

• Normal EXAFS or XANES acquisition require the "EXAFS" tag and nothing else (move to the following section).

• For energy scans to be collected at constant MomentumTransfer (q), "XSW" should be used instead. For XSW scans, you have to specify the value of q (MomentumTransfer), of the angular geometry (XSWmode) and the offset angle (ThetaZero or PhiZero).

# Manipulator
AxisX = 0.0
AxisY = 0.0
AxisZ = 5.0
AxisDetector = 50.0
AxisTheta = 0
AxisTheta2 = -89
AxisPhi = -90

AxisX moves the manipulator motor X to the specified position. The names for the other motors are:

AxisTheta2 : 2Theta -> angle for diode detection
AxisDiode : Diode_selector

When writing this part keep in mind that:

• the movements are executed line by line;

• the detectors moves away from the samples (safe movement!) going to higher values;

• if the detector is close to your sample (< 50 mm), use the correct order of movements so to keep the detector as far as possible until the end of the movements. Particular care is needed when moving from one sample to another (there might be screws taller than your samples!).

Moving from point A to point B? Consider this: high values of Z mean the sample is close to the detector.

If theta = 0: and Z_B < Z_A, this should be your first move as it is the safest! 
In this case the order can be:

AxisZ = Z_B
AxisX = X_B
AxisY = Y_B

# HOS
HosHor = -10.   
HosPitch = 5.0     
HosVer = 1.0  

# EXIT_SLITS
GapHOR = 0.2
GapVER = 0.5
CenterHOR = 0
CenterVER = 0

The values should be entered in mm.

# Detectors
AcquireDetector = True | False
AcquireKeithley = True | False
AcquireXPI =      True | False
DarkCurrent =     True | False
BMSChannel = 3 
AcquisitionTime =  5 

Here are the details for the acquisition. One can activate one or more detectors, choose the BMS channel to be read, and set the acquisition time.
To activate a detector, set its value to True. The available detectors are Keithley (diode) or Bruker (fluorescence detector). 
Syntax:

AcquireKeithely = True | False
AcquireBruker = True | False

The AcquisitionTime must be set in seconds.
If you are not sure on which BMS channel you must use, ask the beamline staff.

# Energy
ElementEdge  = Cu_K
ScanConfFile = my_ini_file.ini

# Storage
Investigation = 20240605 
Experiment = # subfolder name
Dataset =    # sub-sub-folder 
RootFileName = filename 
NumberOfScans = 3

Here one can set the folders and subfolders where the data is saved. Your data are available in the path: scratch4xrf/Investigation/Experiment/Dataset 

Investigation must be filled with the proposal number (and nothing else).
Experiment and dataset are sub-folders names that have to be used. Do not use blank spaces.
For the rootfilename, enter your string of choice. A timestamp will be added automatically to the string to avoid overwriting.

The file for each scan will be saved as RootFileName_yyyy-mm-dd_hh-mm.h5 and as a smaller .txt. The txt version contains the crucial information for each scan, while many more details are enclosed in the h5 files.

In this section you can also set the NumberOfScan, i.e. the repetitions of each energy scan.

[Energy]
Energy1 = 9500.0 
Energy2 = 9560.0
Energy3 = 9630.0
Energy4 = 9680.0
Energy5 = 9846.0
DeltaEn1 = 3.0
DeltaEn3 = 0.3
DeltaK = 0.04
K_Max = 7.0
DetectorROI = [898,936]

Here the details about the energy points are specified.
This file carries the information about the start/stop energies. If you have already run a scan, you will find an output_file.ini saved in the same folder as your files: you can use this one as a template.
For details on the meaning of Energy-ith, please check here.