Difference between revisions of "Controls Software Documentation"
Jump to navigation
Jump to search
| (35 intermediate revisions by the same user not shown) | |||
| Line 40: | Line 40: | ||
==Bluesky== | ==Bluesky== | ||
===Bluesky Framework=== | |||
** | * Documentation: | ||
** | ** General documentation: https://blueskyproject.io/ | ||
* | ** General repository: https://github.com/bluesky | ||
** | ** bluesky-specific documentation: https://blueskyproject.io/bluesky/ | ||
** | * Python packages: | ||
** | ** bluesky source: https://github.com/bluesky/bluesky | ||
** [https://blueskyproject.io/hklpy/ | ** ophyd source: https://github.com/bluesky/ophyd | ||
** databroker source: https://github.com/bluesky/databroker | |||
* Trainings: | |||
** NSLS-II Sandbox for tutorials: https://try.nsls2.bnl.gov | |||
*** Try Bluesky in your internet browser (no local python required for this) | |||
*** Sandbox is publicly accessible | |||
** Also: https://blueskyproject.io/tutorials/ | |||
* hklpy: | |||
** [https://blueskyproject.io/hklpy/ Bluesky's diffractometer support] | |||
** [https://blueskyproject.io/hklpy/examples/index.html Diffractometer examples] | ** [https://blueskyproject.io/hklpy/examples/index.html Diffractometer examples] | ||
* [https:// | * Queue server: | ||
* [https:// | ** [https://blueskyproject.io/bluesky-queueserver/ queueserver - Server for queueing plans] | ||
* [https://github.com/BCDA-APS/ | ** [https://blueskyproject.io/bluesky-queueserver-api/ API documentation] | ||
* [https:// | * Tiled: | ||
* [https:// | ** [https://blueskyproject.io/tiled/ Data server for databroker and directories with data files] | ||
* [https://slaclab.github.io/pydm/ PyDM | ** [https://github.com/BCDA-APS/tiled-template Template for creating a local tiled data server at APS] | ||
* [https://github.com/BCDA-APS/adl2pydm adl2pydm - Convert MEDM's .adl files to PyDM's .ui format | |||
===Bluesky at APS=== | |||
* Documentation: | |||
** Status of Bluesky at the APS: [https://anl.box.com/s/yh6yp0dihz5xz89hphxc4qlit2d8ngs7 P. Jemian Talk 2022-09-19] | |||
** [https://bcda-aps.github.io/bluesky_training/instrument/_install_new_instrument.html Installation Steps] | |||
** apstools: [https://bcda-aps.github.io/apstools/latest/index.html Guides, How-Tos, and other examples] | |||
** bluesky training: [https://bcda-aps.github.io/bluesky_training/index.html Getting started with Bluesky] | |||
* Source code: | |||
** apstools: [https://github.com/BCDA-APS/apstools https://github.com/BCDA-APS/apstools] | |||
** bluesky training: [https://github.com/BCDA-APS/bluesky_training https://github.com/BCDA-APS/bluesky_training] | |||
===Python Display Manager PyDM=== | |||
* [https://slaclab.github.io/pydm/ PyDM Documentation] | |||
* [https://github.com/BCDA-APS/adl2pydm adl2pydm - Convert MEDM's .adl files to PyDM's .ui format] | |||
==Python support== | ==Python support== | ||
Latest revision as of 19:31, 22 May 2023
This page exists to collect links to documentation about the instrument control system EPICS, its modules and related libraries (synApps, areaDetector), as used at the Advanced Photon Source.
Documentation referenced should be appropriate for beamline scientists, as opposed to only EPICS developers. New deployments should prefer EPICSv7, the latest release series.
See also the extensive resources from past EPICS Collaboration meetings.
EPICS Base
- Intro to EPICS
- EPICS Database Concepts
- EPICS Base Getting Started (official)
- Installing EPICS on RaspberryPi
synApps (aka EPICS Support)
areaDetector
Deploying, troubleshooting, and maintaining IOCs
- Troubleshooting EPICS IOCs
- simDetector Install directions (2BM)
- The Basics of an IOC (XXX documentation)
- Creation of an IOC using mkioc
- BCDA Tutorials (APS Internal)
Pre-built IOCs
Docker images
- EPICS Base 7.0.5, synApps 6.2: standard xxx, customized
- EPICS Base 7.0.5, synApps 6.2, area detector 3.10: standard, custom
Virtual Machines
Maintaining Documentation
APS ESAF & Proposal - Read-only interface
Bluesky
Bluesky Framework
- Documentation:
- General documentation: https://blueskyproject.io/
- General repository: https://github.com/bluesky
- bluesky-specific documentation: https://blueskyproject.io/bluesky/
- Python packages:
- bluesky source: https://github.com/bluesky/bluesky
- ophyd source: https://github.com/bluesky/ophyd
- databroker source: https://github.com/bluesky/databroker
- Trainings:
- NSLS-II Sandbox for tutorials: https://try.nsls2.bnl.gov
- Try Bluesky in your internet browser (no local python required for this)
- Sandbox is publicly accessible
- Also: https://blueskyproject.io/tutorials/
- NSLS-II Sandbox for tutorials: https://try.nsls2.bnl.gov
- hklpy:
- Queue server:
- Tiled:
Bluesky at APS
- Documentation:
- Status of Bluesky at the APS: P. Jemian Talk 2022-09-19
- Installation Steps
- apstools: Guides, How-Tos, and other examples
- bluesky training: Getting started with Bluesky
- Source code:
- apstools: https://github.com/BCDA-APS/apstools
- bluesky training: https://github.com/BCDA-APS/bluesky_training
Python Display Manager PyDM
Python support
Channel Access
- PyEpics - Python interface for Channel Access based on libca and libCom.
- caproto - Python interface for Channel Access in pure Python.
PV Access
- p4p - Python interface for PV Access
- pvapy - Python interface for PV Access, also provides CA interface
General
- bcdamenu - GUI menu to beam line software, such as synoptic display.
- mdaPythonUtils - Read .mda data files into Python.
- PvMail - Watch an EPICS PV. Send email when it changes from 0 to 1.
- pvView - Display one or more EPICS PVs in a PyDM GUI window as a table.
- pvWebMonitor - Post EPICS PVs to read-only (static) web site.
- punx - Python Utilities for NeXus HDF5 files: validation, structure, hierarchy.
- pyRestTable - Format a nice table in reST (reStructuredText) from Python.
- pysumreg - Statistics of list of (x,y) pairs from calculator-style summation registers.
- spec2nexus - Read SPEC data files into Python, write NeXus data file.