EXtra - European XFEL Toolkit for Research and Analysis

This repository holds various bits of code to make data analysis simpler.

Development

During development in a custom environment it's often helpful to install the package in editable mode:

$ pip install -e '.[tests,docs]'

Tests are stored under tests/ and use pytest:

$ python -m pytest .

The documentation is written using mkdocs with mkdocstrings-python. To automatically rebuild the docs while editing, run:

$ mkdocs serve

Deployment

The package is automatically deployed from master every night into the current exfel-python environment using the install-extra.sh script (see the cron job with crontab -e as xsoft on max-exfl-display001.desy.de).

If you want to update it manually, you must follow these steps:

1. SSH to Maxwell as the xsoft user
2. Run ./install-extra.sh

Note: make sure to update the copy in xsoft's home directory if the script is updated:

rsync -a --progress docs/install-extra.sh [email protected]:/home/xsoft