BioMAX beamline sample location and experiment planner

Web application to locate available positions in the BioMAX sample changer and prepare the session in ISPyB for MXCuBE3.

Uses RpiMotorLib for Servo motor functions Uses ISPyB for beamline database information

It is designed to run from a Raspberry Pi 3

• Read information from BioMAX ISARA tango device
• Checks user proposals from ISPyB and shipment contents
• Assign position in ISARA and saves the information back in ISPyB
• Provide staff access for remote data collection preparation

The ISARA_loader consists of 3 major components:

• Web Application
• ISPyB API
• Servo motor functions

The Web Application component implements the UI part of the ISARA_loader. It is build on top of Django framework, and serves the web-requests.

The ISPyB API component handles database read/write. User access is grated by MAXIV's Digital User Office

The Servo motor functions are used to control PWM cycles of two orthogonal servo SG90 motors.

The required python package are listed in both environment.yml.

Follow steps below to set-up an environments for running ISARA_loader using conda.

• use you prefered method for installing conda

• clone this repository

  git clone

• create conda environment 'ISARAloader'

  conda env create -f /environment.yml

The conda environment 'ISARAloader' will contain all required package for ISARAloader webapp.

To run ISARAloader application the Web Application component must be started.

To start Web Application activate 'ISARAloader' environment and run:

./manage.py runserver 0.0.0.0:<port>

Access it from any device connected to the same network. The intented access is from a touchscreen device, such as a Tablet.

Open the terminal and SSH to the Raspberry Pi:

python3 /home/pi/ISARA_loader/laser/views/calibration.py

Your terminal will capture keyboard inputs and move the laser in pan-tilt

Shortcuts

One or more positions can be updated at any time.

After the definitions are updated, go the iPad, click Settings -> Update Definitions. This will load new values from previously save definition files.

If you need to reset all angular definitions at once, delete the file:

/home/pi/baskets.pickle

Start the calibration again and proceed as described before.