How-To Guides

How-to guides are directions that take the reader through the steps required to solve a real-world problem. How-to guides are goal-oriented. (Tutorials often involve more depth than HowTo guides.)

• Getting started
  • How to start a Bluesky session?
• Bluesky Cheat Sheet
  • Read
  • Move
  • Count
  • List, Describe, Summary
  • Bluesky Plans vs. Command-line Actions
  • Log files
• Scan Area Detector v. Motor
  • Start the instrument package
  • Setup & connect with EPICS
  • Diagnostics (optional)
  • Take image(s) with the bp.count plan
  • The (1-D) bp.scan() plan with one motor
  • The (1-D) bp.scan() plan with two motors
  • The (2-D) bp.grid_scan() (mesh) plan
  • SPEC data file
• Accessing data later, after the measurement
  • Skip the instrument package
  • Access the database
  • Read the primary data stream of the run
  • Compute the statistics
• APS Accelerator Information for Beamlines
• Minimal: Scan scaler vs motor
  • Connect the motor
  • Connect the scaler
  • Prepare to scan
  • First scan
  • Fix a few problems
  • Scan with a different counting time : staging
  • Custom plan with configurable count time
  • Challenges
• First steps with bluesky-queueserver
  • One-time setup
  • Start a monitor on a qserver
  • Run plans on the qserver
  • Shutdown the queue server
• Count the scaler
  • Start the instrument package
  • A closer look at the EPICS scaler
• Heater Simulation using synApps epid and transform records
  • Overview
  • Schematic
  • Implementation
  • PID Control Loops
  • ophyd interface
  • heater as positioner
  • ramp the temperature
  • Thermal profile
• Custom bluesky plan
  • Preparation
  • Select scaler channels
  • Count time
• Construct the plan
  • Run
  • Challenges
• Linux Command & Wait for Finish
  • 1. Example shell command
  • 2. Run from Python subprocess
  • 3. As ophyd.Signal
  • 4. As ophyd.Device
  • 5. Run with bluesky
• Dynamic Limits for Two Motors
  • Overview
  • Summary
  • EPICS setup
  • Bluesky setup
  • Custom Bluesky plan for \(\theta:2\theta\) scan
  • Try to provoke a permit denied
  • Create a suspender
  • Conclusion
• Trigger a Device with the EPICS record .PROC field
• Images, Darks, & whites with EPICS area detector, ophyd, and Bluesky
  • Setup
  • Acquire Images with Standard bp.count() Plan
  • Use Ophyd to Acquire Image Frames
  • Use Bluesky to Acquire Image Frames
• Lineup a 1-D peak : scan detector v motor
  • About the noisy peak
  • Start the instrument package
  • 2-pass scan
  • Multi-pass scan
• Locate peak on 2-D area detector image
  • Start the instrument package
  • View the image
  • Next Steps
• Plot x, y data from a databroker run
  • 1. Show what data catalogs are available
  • 2. Choose a specific run from a catalog
  • 3. Show the (primary) data
  • 4. Get data for the \(x\) and \(y\) axes
  • 5. Use MatPlotLib
  • 6. Plot \((x,y)\) using matplotlib
  • 7. Plotting function
• synApps busy record
  • arbitrary operation
  • positioner movement
• synApps sscan as 1D Flyer
  • Overview
  • References
  • Bluesky step scan
  • sscan as Bluesky Flyer
  • References
• Simulate a temperature controller with an EPICS swait record
  • Connect with a swait record
  • Create a function to setup the controller
  • Setup our controller
  • temperature as a positioner
  • Use the temperature positioner with a bluesky plan
  • SimulatedTransformControllerPositioner device
• Time Series
  • Start the instrument package
  • Time Series: scaler1
  • Time Series: Temperature
  • Time Series: multiple detectors