README.md

PETRIC Backend

Internal support for SyneRBI/PETRIC.

The machine tomography.stfc.ac.uk runs two separate (technically independent) things I couldn't be bothered to put into different repos.

1. GitHub Actions CI self-hosted runner

This has runner/petric installed on its $PATH

• Runner: synerbi@stfc
  • Tags: docker, cuda
• Sources: runner, docker-compose.yml:petric, Dockerfile
• Usage: PETRIC:.github/workflows/run.yml:jobs.full

Tip

petric.py runs main.Submission with callbacks writing TensorBoard logs to /opt/runner/logs/TEAM/VERSION.

2. Webserver

Created by docker compose up -d.

Leaderboard

• Sources: docker-compose.yml:leaderboard
• Exposes: /opt/runner/logs
• Result: https://petric.tomography.stfc.ac.uk/leaderboard

Thresholds

A horizontal line in the leaderboard graphs.

• Sources: thresholds
• Exposes: /opt/runner/logs/0_THRESHOLDS

Files

• Sources: docker-compose.yml:leaderboard.labels.virtual.host.directives,data,data-wip
• Exposes: /mnt/share/petric, /mnt/share/petric-wip
• Result: https://petric.tomography.stfc.ac.uk/data, /data-wip

Tip

/data-wip needs authentication (username & password)

3. Utils

Ranking

Computes submission rankings based on TensorBoard logs.

• Sources: rank

Manual runner loop

Runs all submitted algorithms on all data.

• Sources: loop