An open API service indexing awesome lists of open source software.

https://github.com/diamondlightsource/bookshelf-i11-integration

A bookshelf repository for i18 azimuthal integration data processing
https://github.com/diamondlightsource/bookshelf-i11-integration

analysis python xray-diffraction

Last synced: about 1 month ago
JSON representation

A bookshelf repository for i18 azimuthal integration data processing

Awesome Lists containing this project

README

          

# i11 Integration Notebook

This notebook is used to perform azimutal integration of i11 data. This repo follows the bookshelf structure, meaning it will be automatically deployed in two varieties:

1. An interactive - jupyterlab - environment, for running both locally and hosted on the hosted JupyterLab instance
2. A headless processing image, for running both locally and as a cluster job

## Releasing a version

Simply "create a release" on github, this will run a set of continious integration (CI) jobs defined in `.github/workflows` to generate the nessacary containers.

To update the versions available via the diamond module system, run the Project General installation jenkins job for the "bookshelf" package;
This will query the GitHub API and catalogue all containers in the DiamondLightSource repository with the nessacary metadata.

## Running the Containers

### Interactive (local)

```
podman run --publish 8888:8888 ghcr.io/diamondlightsource/bookshelf-template/interactive:latest
```
or
```
module load bookshelf/bookshelf-i11-integration/latest
bookshelf-i11-integration-interactive
```

### Interactive (hosted)

1. Go to https://jupyterhub.diamond.ac.uk/hub/home
2. 'Start My Server' with `CONTAINER_IMAGE=ghcr.io/diamondlightsource/bookshelf-i11-integration/interactive:latest`

### Processing

```
podman run --volume .:/outputs --volume .:/inputs --security-opt=label=type:container_runtime_t ghcr.io/diamondlightsource/bookshelf-template/processing:latest
```
or
```
module load bookshelf/bookshelf-i11-integration/latest
bookshelf-i11-integration-processing
```