{
"cells": [
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"# Area Detector with default HDF5 File Name"
]
},
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"**Objective**\n",
"\n",
"Demonstrate and explain the setup of an [EPICS area detector](https://areadetector.github.io/master/index.html) to acquire an image with [bluesky](https://blueskyproject.io/) and write it to an [HDF5](https://www.hdfgroup.org/solutions/hdf5) file. Use the standard [ophyd conventions](https://blueskyproject.io/ophyd) for file naming and other setup. Show how to retrieve the image using the [databroker](https://blueskyproject.io/databroker).\n",
"\n",
"**Contents**\n",
"\n",
"- [EPICS Area Detector IOC](#EPICS-Area-Detector-IOC) is pre-built\n",
"- [File Directories](#File-Directories) are different on IOC and bluesky workstation\n",
"- [ophyd](#ophyd) to describe the hardware\n",
"- [bluesky](#bluesky) for the measurement\n",
"- [databroker](#databroker) to view the image\n",
"- [punx](#punx) (not part of Bluesky) to look at the HDF5 file\n",
"- [Recapitulation](#Recapitulation) - rendition with no explanations"
]
},
{
"attachments": {},
"cell_type": "markdown",
"metadata": {},
"source": [
"## EPICS Area Detector IOC\n",
"\n",
"This notebook uses an EPICS server (IOC), with prefix `\"ad:\"`. The IOC provides a simulated EPICS area detector.\n",
"\n",
"IOC details
\n",
"\n",
"The IOC is a prebuilt [ADSimDetector](https://areadetector.github.io/master/ADSimDetector/simDetector.html) driver, packaged in a [docker](https://www.docker.com/) image\n",
"([prjemian/synapps](https://hub.docker.com/r/prjemian/synapps/tags)). The [EPICS IOC](https://docs.epics-controls.org/projects/how-tos/en/latest/getting-started/creating-ioc.html) is configured with prefix `ad:` using the [bash shell script](https://raw.githubusercontent.com/prjemian/epics-docker/main/resources/iocmgr.sh):\n",
"\n",
"\n",
"$ iocmgr.sh start ADSIM ad\n",
"
\n",
"\n",
"