Skip to content
Magellon

Demo Walkthrough

import { Aside, Steps } from ‘@astrojs/starlight/components’;

This walkthrough mirrors the original Magellon demo post — install Docker, fetch the demo data, start the stack, and import a session.

  1. Install Docker

    Section titled “Install Docker”

    On Linux without root, ask a system administrator to install Docker and add you to the docker group.

    Verify with:

    Terminal window
    docker --version

  2. Determine your CUDA version

    Section titled “Determine your CUDA version”

    Required for motion correction. On Linux:

    Terminal window
    nvidia-smi

    Note the CUDA version reported in the top-right corner — you’ll pass it to the start script.

  3. Download the demo data via Globus

    Section titled “Download the demo data via Globus”

    Open the Globus File Manager, sign in, and transfer the demo files to your machine.

  4. Get the Magellon source

    Section titled “Get the Magellon source”

    Clone the release branch:

    Terminal window
    git clone https://github.com/sstagg/Magellon.git
    cd Magellon

  5. Create a processing directory

    Section titled “Create a processing directory”

    Pick a location with enough disk space — this is where Magellon will read inputs, write outputs, and stage jobs.

    Terminal window
    mkdir -p /path/to/magellon

  6. Run the start script

    Section titled “Run the start script”

    From the Docker/ subdirectory, pass the processing directory and CUDA version:

    Terminal window
    cd Docker
    bash start.sh /path/to/magellon <cuda-version>

    The first run downloads every supporting container; this can take a while on slow networks. When it finishes, several services come up — the Magellon front-end, the FastAPI backend, the Swagger interface, and a few internal helpers.

  7. Move the demo data into GPFS

    Section titled “Move the demo data into GPFS”

    Copy or move the Globus download into the gpfs/ subdirectory of your processing directory:

    Terminal window
    mv ~/Downloads/24dec03a /path/to/magellon/gpfs/

  8. Import the session

    Section titled “Import the session”
    • Open the front-end at http://localhost:8080/en/panel/images.
    • Log in, then open the menu (top-left).
    • Choose Import, switch to the Magellon import tab, and double-click 24dec03a → session.json.
    • Click IMPORT DATA.

  9. Explore

    Section titled “Explore”

    Once the import finishes, browse the session in Images, run plugins from the Plugins page, and watch progress in the Jobs panel.

Cleaning up

Section titled “Cleaning up”

A teardown script ships alongside start.sh. It deletes every Magellon subdirectory under the processing path — only run it on a deployment you no longer need.

Terminal window
bash cleanup.sh /path/to/magellon