Batch Mode
Batch mode lets you run the same workflow over a queue of input files — useful for processing a study directory or reprocessing a cohort.
Enabling Batch Mode
On the Setup tab, toggle the Batch switch in the top-right of the input section. The single-file drop zone is replaced by the batch queue panel.
Building the Queue
Scan Directory
Click Scan Directory to populate the queue from a folder:
- Choose a directory with the directory picker.
- Optionally enter a glob pattern (default:
*.dat,*.h5) to filter files. - Click Scan — matching files are added to the queue.
Manual Add
Drag and drop individual files onto the queue panel. Duplicate paths are ignored.
Removing Items
Click the × on any queued item to remove it before starting.
Queue Panel
Each item in the queue shows:
| Column | Description |
|---|---|
| Filename | Short file name; hover for full path |
| Status | Queued / Running / Done / Failed |
| Retry count | Number of times this item has been retried |
| Actions | Retry button (for failed items) |
Starting a Batch
Select a workflow from the workflow selector (same as single-file mode), then click Start Batch. FORGE Studio:
- Locks the queue (no changes while running).
- Processes items one at a time in queue order.
- Updates each item's status in real time.
The Monitor tab shows progress for the currently running item.
Pausing and Resuming
Click Pause to pause the batch after the current item finishes. Click Resume to continue.
Pausing mid-item is not supported — the current reconstruction runs to completion (or failure) before the batch pauses.
Retrying Failed Items
If an item fails, its row shows a Retry button. Clicking it:
- Resets the item status to
queued. - Increments the retry count.
- Re-queues the item at the end of the queue (if the batch is still running) or at the front (if the batch has completed).
Batch Results
When the batch finishes, a summary toast shows how many items succeeded, failed, and were skipped. All processed items appear in the History tab with individual job details.
Auto-Approve Gates
Workflows with interactive stages normally pause for user review. In batch mode, if the stage has auto_approve: true set in the YAML, the gate is skipped automatically. If auto_approve: false, the batch pauses at that item waiting for manual approval — not recommended for large batches.
Set auto_approve: true on interactive stages intended for unattended batch processing.