NOTICE 2023-04-24: DO NOT USE. This material is out of date and will not be updated here. This repository will be archived by 2023-09-01. It should not be used for new work. All content of this repository (environment files, training documents, reference material) is migrating to https://bcda-aps.github.io/bluesky_training/
This directory contains lessons, tutorials, examples, other - all in Jupyter notebooks
LESSONS
- lesson1 - EPICS : scaler and count
- lesson2 - EPICS : motor and scan
- lesson3 - EPICS : show data as it is acquired
- lesson3: final - EPICS : final project
- lesson4 - simulator : scan scaler v. motor
- lesson5 - simulator : find a peak and lineup on it
- lesson5: advanced - simulator : advanced assignment
- lesson6 - EPICS : area detector
- lesson7 - simulator : four-circle diffractometer
DOCUMENTATION
- Command Review a.k.a. The Cheat Sheet
- Overview of the
instrumentpackage - Recommended way to configure your instrument to work with Bluesky. - The
apsdevice - EPICS : Basic information for beam lines from the APS accelerator
DEMONSTRATIONS
- Analyze data from a run (accessing the data from databroker)
- Area Detector Image Types - EPICS : Images, Darks, & Flats with EPICS area detector, ophyd, and Bluesky
- Copy data to another workstation using
databroker-pack - Count the scaler using ophyd, bluesky, and the instrument package
- Custom bluesky plan using bluesky and the instrument package
- Databroker: Pack - Export a few runs to give to a user (accessing the data from databroker)
- Databroker: Unpack - Import a package of runs. using databroker-pack
- Databroker: Analyze a 2-D image using databroker
- Databroker: Plot (x,y) data from a run using databroker
- Diffractometer examples using hklpy
- dynamic limits with 2 motors - EPICS : Demo of dynamic limit signal to avoid two motor collision
- Lineup a 1-D peak using ophyd, bluesky, and the instrument package
- Locate peak on 2-D area detector image using ophyd, bluesky, and the instrument package
- ophyd: Interface with XY positioner written with pure Python (no EPICS) support using
ophyd.SoftPositioner - ophyd: run a Linux command as a Device using ophyd
- Watch a temperature using ophyd, bluesky, and the instrument package
- Windows - Installing ophyd, Bluesky, et al. on Windows 10
- Known supported browsers - Firefox, Chrome, Safari, KDE's Konqueror did not work
This session was started from the linux command line:
jemian@otz ~/Documents $ source /APSshare/anaconda3/Bluesky/bin/activate
(base) jemian@otz ~/Documents $ jupyter-notebook
This command produced the following console output and then started my default web browser with a one-time-token-authenticated connection to the Jupyter Notebook server (still running in the console):
[I 15:16:57.546 NotebookApp] Serving notebooks from local directory: /home/oxygen18/JEMIAN/Documents
[I 15:16:57.546 NotebookApp] 0 active kernels
[I 15:16:57.546 NotebookApp] The Jupyter Notebook is running at:
[I 15:16:57.546 NotebookApp] http://localhost:8888/?token=e6a7584762c731a7c64f8f71246b3e616d779f7b4852c9d9
[I 15:16:57.546 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 15:16:57.547 NotebookApp]
Copy/paste this URL into your browser when you connect for the first time,
to login with a token:
http://localhost:8888/?token=e6a7584762c731a7c64f8f71246b3e616d779f7b4852c9d9
[I 15:17:00.863 NotebookApp] Accepting one-time-token-authenticated connection from ::1
Next, found the New drop-down menu button (top right, below the Lougout button) and selected Python 3 to start a new notebook page using a Python 3 shell (the only kind available here).
Finally, from the File menu in the jupyter notebook (in the browser), selected Rename ... to save the Untitled notebook with the name lesson1 (default extension is .ipynb).