Jobs File¶

The jobs file defines which analyses to run, their timeouts, and upload limits.

Format¶

One analysis per line. Comments start with #.

# directory          analysis_min  upload_min
opsmp_analysis       120           30
another_model        180           45
quick_test           30            10

Column	Description	Default
`directory`	Path to analysis folder	(required)
`analysis_min`	Analysis timeout in minutes	120
`upload_min`	Upload timeout in minutes	30

Analysis directory requirements¶

Each directory must contain:

main.tcl — entry point for OpenSees
*.mpco.cdata — partition files (count determines MPI rank count)

Optional:

*.tcl — additional Tcl scripts (sourced by main.tcl)
*.pltbg — plot data files

Paths¶

Paths can be relative (to where you run the command) or absolute:

# Relative
opsmp_analysis                          120    30

# Absolute
C:\Users\Deniz\models\bridge_model      180    45
D:\FEM\wall_test                         60    15

Batch execution¶

When multiple jobs are listed, they run sequentially on the same VM:

model_A    120    30      # runs first
model_B    180    45      # runs second (while model_A uploads in background)
model_C     60    15      # runs third

Each job gets its own analysis deadline
Upload runs in background while the next job starts
VM is deleted only after all jobs and uploads complete
max_run_duration safety cap = sum of all timeouts + last upload + 1 min

GUI integration¶

The GUI can load and save jobs files:

Load Jobs button — populates the queue from a file
Save Jobs button — exports the current queue to a file
Per-job timeouts are editable in the queue