FMB User Cheat Sheet

FMB beamline status page

http://new-status.chess.cornell.edu/id3b

CESR status page

https://cesrwww.lepp.cornell.edu/docs/statpanel/fullscore_auto.html

Useful spec commands

Moving motors and querying motor positions

wm motorname returns motor positions for given motor, e.g.: "wm samx"

we returns motor positions for all configured motors

umv motorname # moves motor to absolute position, e.g.: “umv samx 1” will move motor samx to position 1

umvr motorname # moves motor relative to current position, e.g.: “umvr samx 1” will move motor samx +1 from its current position

tw motorname # tweak motor position in steps of size #, e.g.: “tw samx 1” will open a dialog where you are asked to enter the sign (direction) of steps, and then pressing enter/return will allow you to take multiple steps of that size in a row. Type any letters to exit the dialog.

• When using tw command, specify the step size as magnitude (i.e. absolute value) without any sign, even if you want to tweak in the negative direciton. You will be asked to enter the sign afterward. (i.e. it is recommended you do not run tw samx -1. Run tw samx 1, and when prmpted to indicate the direction, type -)

Which direction is lab x, y and z? Which direction is positive for each?

+x: transverse to the beam, away from the hutch doors

+y: direction of the beam

+z: upward

Upstream optics

opens - open upstream shutter

closes - close upstream shutter

umv att 0 - move attenuator completely out of the beam.

att -1 = fluorescent screen. att 12 = significant attenuation

wg s1 - print positions for upstream hutch slits (define beam size with s1h and s1v)

wg s2- print positions for downstream hutch slits (guard slits)

• Can move s1h, s1v, s2h, and s2v, with umv commands; units are mm

Organizing data (making folders, changing directories)

1. newdir dir_name make a new directory in the working directory (example would make a folder called dir_name in the current user's BTR directory in DAQ and make it the working directory)
   • This replaces what used to be a two-step process of u mkdir dir_name, followed by cd dir_name.
   • Running newdir without any argument will prompt for the name of the directory you wish to create.
   • newdir can be run regardless of what the current working directory is. It will create the directory in the current user's BTR directory in DAQ and make it the working directory.
2. Update detector path to the current directory - need to run this every time directories are changed.
   1. For SAXS/WAXS, pil_setdir updates the Pilatus detector(s)
   2. For radiography/tomography, andor_setdir updates the Andor detector
   3. For XRF, xps_setdir updates the xpress3 paths
   4. For the Eiger, eig_setdir updates the detector paths
3. newfile opens dialog to enter new filename and path for savingE data, applied to next scan

(move back up a level: cd ..)

Spec scans

tseries- series of snapshots

• Usage: tseries number_of_snapshots exposure_time(s)
• e.g. tseries 10 1
  • will take 10 snapshots with 1 second exposures

loopscan- series of snapshots with a wait in between

• Usage: loopscan number_of_snapshots exposure_time(s) sleep_time(s)
• e.g. loopscan 10 1 5
  • will take 10 snapshots with 1 second exposures and wait 5 seconds between each exposure

dscan- snapshots while moving a motor step-wise (not flyscanning)- relative positions

• Usage: motorname start end intervals exposure_time(s)
• Positions are relative to current position
• At the end of the scan, the motor will return to the position it was at when the scan command was executed.
• e.g. dscan bedx -10 10 20 1
  • Will scan the motor "bedx" from -10 to +10 mm relative to the current position, with 1 mm steps and 1 second exposure times
    • If the current position of motor "bedx" is 30, it will be scanned from 20 to 40. At the end of the scan, motor "bedx" will return to 30.

ascan- snapshots while moving a motor step-wise (not flyscanning)- absolute positions

• Usage: motorname start end intervals exposure_time(s)
• Positions are absolute, not relative to current position when the command is issued
• e.g. ascan bedx 200 220 20 1
  • Will scan bedx from motor positions 200 to 220, with 1 mm steps and 1 second exposure times, regardless of where motors are when the command is issued
  • The motor does not reutrn. It will remain at the final position (in this example, at 220) at the end of the scan.

plotselect choose what variable to show in the yellow spec plot

Pilatus area detector macros

List of important commands

• pil_setup PILX # - sets up the detector with prefix (e.g. pil_setup PIL5 0)
  • Typical for simultaneous SAXS/WAXS: PIL5 = 0, PIL9 = 1, PIL11 = 2
• pil_on/off- turns all configured detectors on/off
  • pil_on # - turn on just one configured detector (e.g. pil_on 0 turns on the 0th configured detector)
• pil_von/voff - turns live view (video mode) on/off
  • ImageJ plugin can only handle this for one detector at a time, so if you have multiples configured, make sure only one is on before running pil_von
  • video mode must be off before starting captures or any scans.
• pil_setdir- sets all the pilatus paths to the current working directory
• pil_settrig- choose trigger mode for configured detectors
  • use "Internal" for single snapshots (e.g. tseries, dscans)
  • user "Mult. Trigger" for external trigger (e.g. flyscans)

Examples of usage with multiple detectors

See: PilatusExamples

Andor area detector macros

List of important commands

• andor_setup ANDOR# - sets up the detector with prefix (
  • Typical e.g. andor_setup ANDOR2
• andor_on/off- turns andor detector capture on/off
• andor_von/voff - turns live view (video mode) on/off
  • video mode must be off before starting captures or any scans
• andor_setdir- sets the andor save paths to the current working directory
• andor_settrig- choose trigger mode
  • use "Internal" for tseries, loopscans, etc.
  • use "External Start" for tomography movies with the air bearing rotation stage
• andor_setformat- save as .tiff or .hdf5
  • either: andor_setformat "TIFF1" or andor_setformat "HDF1"
  • saving to hdf5 is necessary for fast framing rates

Querying/setting motor parameters

To query motor velocity (pulses/sec):

p motor_par(motorname, “velocity”)

To query pulses/mm

p motor_par(motorname, “step_size”)

To change velocity:

motor_par(motorname, “velocity”, newvalue)

e.g.: p motor_par(bedx, “velocity”, 40000)

Station computer links/procedures

Camera views and ion chamber medms

In-hutch microscope view. Run vimba from terminal, then select 192.168.181.97 : If starting from scratch, you will need to click on the "All" tab and modify two fields under the "GigE section: "GevSCPSPacketSize": 1500; "StreamBytesPerSecond": 50000000

In-hutch PTZ camera by hutch door/on south wall (original StanCam): http://192.168.182.44/ (requires login)

In-hutch PTZ camera (upstream wall): http://192.168.182.81/ (requires login)

3B 4-channel Video encoder: http://192.168.182.43 (requires login)

Cave cameras: from terminal, run “vimba”

To restart preamp gui: show_amps

Defining macros

edit a file, “my_macros.mac” (or other filname) in specuser/Macros directory

in SPEC:

SPEC> udo my_macros.mac

check that it was read:

SPEC> prdef

Open ion chamber viewer

cd bin

./counter_display

Open beam position and station status viewers

To start a viewer for beam positions, CESR correction, CESR and CHESS enables, beam current and time to next topoff: beam_positions

To start a viewer for status lines stops and station stops: station_status

Data analysis- useful information

File paths

Raw data: /nfs/chess/raw/current/id3b/YOUR-PROJECT-ID

Analysis area: /nfs/chess/auxiliary/cycles/current/id3b/YOUR-PROJECT-ID

Note, instead of "current" you can also use the run cycle, e.g. "2020-3" (this is necessary for returning to data after a run is over)

Analysis area always stays accessible. Raw data is archived after two cycles. To request raw data be restored to disk, submit a service request: https://wiki.classe.cornell.edu/Computing/ServiceRequest

Calibrating SAXS/WAXS detectors with pyFAI GUI (generating .poni files)

Open a terminal window.

Run 'source /nfs/chess/sw/miniconda3_msnc/envs/saxswaxs-viewer/bin/activate'

Start the GUI:

> pyFAI-calib2

Official documention for the GUI is here: pyFAI-calib2

More detailed, CHESS-specific documentation here: pyFAI calibration tools

Use the pyFAI-calib2 GUI to generate a .poni file for each of the area detectors used in your experiment. Save the .poni files in your aux area.

Remote access

Station computer (NoMachine) and lnx201

See: Remote access with NoMachine

CLASSE IT documentation for NoMachine can be found here.

Transferring files

See SFTP-SCP access or Globus

Other useful links

Virtual tour

A 3D Virtual tour of the MSN-C user area, including inside FMB and SMB (screenshot shown above) is located at: https://my.matterport.com/show/?m=9aGsG7sCg26&brand=0

InstantPlot Documentation

• InstantPlot

Rough flyscan time estimator

• Online estimation tool
• ScanTimeEstimator.xlsx

CHESS ion chamber flux calculator

• https://www.chess.cornell.edu/userstechnical-resourcescalculators/ion-chamber-flux-calculator

X-ray attenuation calculators

• https://henke.lbl.gov/optical_constants/atten2.html

Running Jupyter notebooks on the CLASSE cluster

• https://wiki.classe.cornell.edu/CHESS/Private/RemoteJupyterNotebooks

CLASSE Git area

• https://gitlab01.classe.cornell.edu

If you are a contributor to InstantPlot, please use gitlabs for issue reporting.

-- LouisaSmieska - 11 May 2022