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. Proposal Writing for BMM
  • 2.1. XAS Experiments
  • 2.2. XRD Experiments
  • 2.3. Multi-modal Experiments
  • 2.4. NIST Partner User Proposals
• 3. Before your Beamtime
  • 3.1. Register for BNL Site Access
  • 3.2. BNL Domain Account
  • 3.3. Safety Approval Form
  • 3.4. Support Laboratories
  • 3.5. Training
  • 3.6. Electrical Equipment
  • 3.7. Research Equipment Pool
  • 3.8. Shipping things to the beamline
  • 3.9. The Day of your Experiment
• 4. Data access
  • 4.1. Downloading data
  • 4.2. Accessing data with Globus
  • 4.3. Accessing data from the beamline computers
  • 4.4. Using the VDI virtual Desktop
  • 4.5. Accessing data via Tiled
  • 4.6. Accessing data via Jupyter
  • 4.7. Why is data security important?
• 5. Beamline instrumentation
  • 5.1. Fluorescence detectors
  • 5.2. Electron yield detector
  • 5.3. Area detector
  • 5.4. Sample wheel
  • 5.5. Electrochemistry
  • 5.6. Temperature control
  • 5.7. Glancing angle and thin film stage
  • 5.8. Tilt and rotation stages
• 6. Moving and querying motors
  • 6.1. Sample stages
  • 6.2. Sample wheel
  • 6.3. Glancing angle stage
  • 6.4. Table motors
  • 6.5. Examine Motor Axes
• 7. Photon Delivery System
  • 7.1. Configure the Photon Delivery System
  • 7.2. Shutters
  • 7.3. Monochromator
  • 7.4. Post-mono slits
  • 7.5. Mirrors
  • 7.6. End station slits
  • 7.7. Configurations
• 8. Sample position scans
  • 8.1. General line scans
  • 8.2. Specific line scans
  • 8.3. Area scans
• 9. XAFS scans
  • 9.1. The INI file
  • 9.2. Scan run time
  • 9.3. Safe filenames for USB sticks
  • 9.4. Run an XAFS scan
  • 9.5. Revisit an XAFS scan
  • 9.6. Scan sequence macro
  • 9.7. XAFS data file
  • 9.8. Telemetry
  • 9.9. Data evaluation
  • 9.10. Extract XRF spectra from fluorescence XAS
  • 9.11. Reference spectra
• 10. Other measurements
  • 10.1. SEAD
  • 10.2. Raster
• 11. Beamline automation
  • 11.1. Common features
  • 11.2. Selecting a spreadsheet
  • 11.3. Sample wheel automation
  • 11.4. Linkam stage automation
  • 11.5. LakeShore/Displex automation
  • 11.6. Glancing angle stage automation
  • 11.7. Motor grid automation
• 12. Experimental Log
  • 12.1. Log file
  • 12.2. Snapshots
  • 12.3. Recording videos
  • 12.4. Scan dossier
• 13. Managing the beamline
  • 13.1. Starting and ending an experiment
  • 13.2. Change energy
  • 13.3. Change crystals
  • 13.4. Change XAS → XRD
  • 13.5. XAFS with Si(333)
  • 13.6. Motor controller kill switches
  • 13.7. Windows VM and BioLogic
  • 13.8. Calibrate the mono
  • 13.9. Provision a new beamline computer
  • 13.10. Manage Silicon Drift Detectors
• 14. Common chores
  • 14.1. Search the Hutch
  • 14.2. Change energy and prepare for fluorescence measurements
  • 14.3. Align the ex situ sample wheel
  • 14.4. Restart the Linkam stage
  • 14.5. Filling the 25 liter LN2 dewar
• 15. Command cheatsheet
  • 15.1. The most essential information
  • 15.2. Full list of commands
  • 15.3. Photon delivery system modes
  • 15.4. Slits3 coordinated motions
  • 15.5. Motor positions and limits
  • 15.6. Line scans
  • 15.7. Energy scans
• 16. Troubleshooting
  • 16.1. Pausing BlueSky
  • 16.2. Exiting or crashing bsui
  • 16.3. Amplifier fault
  • 16.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. Kafka workers at BMM
  • C.1. Starting the Kafka consumer
  • C.2. A few words about Kafka
  • C.3. Plot types
  • C.4. Headless and visualization workers
  • C.5. File management
  • C.6. 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. Network configuration
  • E.2. xf06bm-ws5, in-hutch Zoom calls
  • E.3. BNC Cable Map
  • E.4. Inert Gas Plumbing
  • E.5. Analog Video Capture
  • E.6. Pilatus 100K
  • E.7. DI Water Flow
  • E.8. Disabling an MCS8 axis after a move
  • E.9. Vortex pressure
  • E.10. DM3 CAT6 Patch Panel
  • E.11. Logitech controller
  • E.12. Motor controllers
  • E.13. 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