BMM Users Manual

BMM is NIST’s Beamline for Materials Measurement.

Fig. 1 BMM at a glance!

Contents:

Running the beamline

• 1. Introduction to BMM
  • 1.1. TL;DR
  • 1.2. Essential links
  • 1.3. The user experience
  • 1.4. BMM and Building 743
  • 1.5. A Bit about BMM
  • 1.6. Acknowledgements
  • 1.7. A note about copyright
• 2. Before your Beamtime
  • 2.1. Register for BNL Site Access
  • 2.2. BNL Domain Account
  • 2.3. Safety Approval Form
  • 2.4. Support Laboratories
  • 2.5. Training
  • 2.6. Electrical Equipment
  • 2.7. Research Equipment Pool
  • 2.8. Shipping things to the beamline
  • 2.9. The Day of your Experiment
• 3. Beamline instrumentation
  • 3.1. Fluorescence detectors
  • 3.2. Area detector
  • 3.3. Sample wheel
  • 3.4. Electrochemistry
  • 3.5. Temperature control
  • 3.6. Glancing angle and thin film stage
• 4. Moving and querying motors
  • 4.1. Sample stages
  • 4.2. Sample wheel
  • 4.3. Glancing angle stage
  • 4.4. Table motors
  • 4.5. Examine Motor Axes
• 5. Photon Delivery System
  • 5.1. Configure the Photon Delivery System
  • 5.2. Shutters
  • 5.3. Monochromator
  • 5.4. Post-mono slits
  • 5.5. Mirrors
  • 5.6. End station slits
  • 5.7. Configurations
• 6. Sample position scans
  • 6.1. General line scans
  • 6.2. Specific line scans
  • 6.3. Area scans
• 7. XAFS scans
  • 7.1. The INI file
  • 7.2. Scan run time
  • 7.3. Safe filenames for USB sticks
  • 7.4. Run an XAFS scan
  • 7.5. Revisit an XAFS scan
  • 7.6. Scan sequence macro
  • 7.7. XAFS data file
  • 7.8. Telemetry
  • 7.9. Data evaluation
  • 7.10. Extract XRF spectra from fluorescence XAS
  • 7.11. Reference spectra
• 8. Beamline automation
  • 8.1. Common features
  • 8.2. Sample wheel automation
  • 8.3. Linkam stage automation
  • 8.4. LakeShore/Displex automation
  • 8.5. Glancing angle stage automation
  • 8.6. Motor grid automation
• 9. Experimental Log
  • 9.1. Log file
  • 9.2. Snapshots
  • 9.3. Recording videos
  • 9.4. Scan dossier
• 10. Managing the beamline
  • 10.1. Starting and ending an experiment
  • 10.2. Change energy
  • 10.3. Change crystals
  • 10.4. Change XAS ↔ XRD
  • 10.5. XAFS with Si(333)
  • 10.6. Motor controller kill switches
  • 10.7. Windows VM and BioLogic
  • 10.8. Calibrate the mono
  • 10.9. Provision a new beamline computer
• 11. Common chores
  • 11.1. Search the Hutch
  • 11.2. Change energy and prepare for fluorescence measurements
  • 11.3. Align the ex situ sample wheel
  • 11.4. Restart the Linkam stage
  • 11.5. Filling the 25 liter LN2 dewar
• 12. Command cheatsheet
  • 12.1. The most essential information
  • 12.2. Full list of commands
  • 12.3. Photon delivery system modes
  • 12.4. Slits3 coordinated motions
  • 12.5. Motor positions and limits
  • 12.6. Line scans
  • 12.7. Energy scans
• 13. Troubleshooting
  • 13.1. Pausing BlueSky
  • 13.2. Exiting or crashing bsui
  • 13.3. Amplifier fault
  • 13.4. Failed hutch search

Developer documentation

• A. BMM’s Desktop
  • A.1. Monitoring
  • A.2. Data collection and visualization
  • A.3. All the rest
• B. An overview of BMM’s profile
  • B.1. The startup folder
  • B.2. The IPython namespace
  • B.3. Managing bsui and queueserver
  • B.4. Profile start-up as a narrative
  • B.5. Profile start-up as acceptance testing
  • B.6. Core Bluesky functionality
  • B.7. Everything in the BMM folder
• C. Plotting via Kafka at BMM
  • C.1. Starting the Kafka consumer
  • C.2. Various types of plots
  • C.3. Cleaning up the screen
• D. Managing ion chamber signal chains
  • D.1. The old system
  • D.2. The new system
  • D.3. Configuration in bsui profile
• E. Instrumentation Details
  • E.1. xf06bm-ws5, in-hutch Zoom calls
  • E.2. BNC Cable Map
  • E.3. Inert Gas Plumbing
  • E.4. Analog Video Capture
  • E.5. Pilatus 100K
  • E.6. DI Water Flow
  • E.7. Disabling an MCS8 axis after a move
  • E.8. Vortex pressure
  • E.9. DM3 CAT6 Patch Panel
  • E.10. Logitech controller
  • E.11. Motor controllers
  • E.12. Encoder loss second crystal roll
• F. Restore beamline after a power outage
  • F.1. Channel Access
  • F.2. Redis
  • F.3. Xspress3
  • F.4. Other IOCs
  • F.5. Motor controllers
• G. To Do List
  • G.1. How to add a scan.ini parameter