Quick Start
This guide walks through running your first reconstruction end-to-end.
1. Load an Input File
Open the Setup tab (the first icon in the sidebar).
- Drag and drop an ISMRMRD (
.h5) or Siemens TWIX (.dat) file onto the drop zone, or - Click Browse to open a file picker.
Once loaded, the inspector panel on the right shows the file's metadata — protocol name, sequence, platform, FOV, base resolution, and channel count.
2. Select a Workflow
If FORGE Studio recognises the protocol, it will automatically suggest a matching workflow in the Workflow selector. You can also browse all available workflows from the dropdown.
Each workflow defines the reconstruction stages — for example:
- Sensitivity Calibration (Python/Julia)
- CS-SENSE Reconstruction (FORGE)
3. Set the Output Directory
In the Output field below the workflow selector, confirm or change the output directory. The default is set in Settings → General.
4. Review Parameters
Click any stage or step in the pipeline diagram to open its parameter inspector. Override values by editing the fields directly — changes persist for this job only.
Parameters are grouped into standard and Advanced (collapsed by default) sections.
5. Start the Job
Click Start Reconstruction. FORGE Studio will:
- Run pre-flight checks (backend availability, disk space).
- Execute each pipeline stage in sequence.
- Switch automatically to the Monitor tab.
6. Monitor Progress
The Monitor tab shows:
- A stage stepper with live status.
- Real-time convergence charts (error norm, penalty).
- CPU, RAM, and GPU utilisation bars.
- A streaming log console.
If a stage has an interactive gate (e.g. brain mask review), the pipeline pauses and you'll see an amber banner — click Open Mask Editor to review.
7. View the Result
When reconstruction completes, FORGE Studio switches to the Viewer tab automatically. The output NIfTI volume is loaded in the orthogonal slice viewer.
- Scroll through slices with the scrubber or arrow keys.
- Add overlays from the sidebar.
- Adjust colormap and display range with the controls on the right.
What's Next
- Workflows → — build and customise your own pipeline
- Batch Mode → — process a whole directory of files
- Python Backend → — write a custom reconstruction module