WORLDSAR Documentation

4-5. Input Product and Running

Learn how PRODUCT is interpreted and choose the right execution mode.

4. Input Product

Put your .SAFE product under ./phidown_data, or download with:

make down PRODUCT=<product_name>.SAFE

PRODUCT for make run and make run-vm can be:

  • A .SAFE directory name (resolved under mode-specific DATA_DIR)
  • An existing path (absolute or relative, if it contains /)

main.sh resolves name-only products under DATA_DIR (VM or HPC depending on WORLDSAR_MODE). Path inputs are used directly and must exist.

5. Running

Current Makefile default mode: WORLDSAR_MODE=hpc.

5.1 Local VM Run (No PBS)

WORLDSAR_MODE=vm make run PRODUCT=<product_name_or_full_path>.SAFE

Equivalent explicit target:

WORLDSAR_MODE=vm make run-vm PRODUCT=<product_name_or_full_path>.SAFE

5.2 Cluster Run (PBS/qsub)

make run PRODUCT=<product_name_or_full_path>.SAFE

Equivalent explicit mode selection:

WORLDSAR_MODE=hpc make run PRODUCT=<product_name_or_full_path>.SAFE

In HPC mode, Makefile defaults for paths and scheduler options are applied.

In PBS mode, PRODUCT is injected through qsub environment variables (-v PRODUCT=...), so qsub does not receive positional script arguments.

For your workflow, HPC hardcoded defaults are also defined near the top of main.sh (for example HPC_BASE_DIR and related paths).

To change persistent defaults, edit Makefile top-level mode/path variables (for example WORLDSAR_MODE, VM_PROJECT_ROOT, HPC_PROJECT_ROOT).

Execution Choice Guidance

Use WORLDSAR_MODE=vm make run ... (or run-vm) for local validation and troubleshooting.

Use make run ... in PBS-enabled environments where the default hpc mode is intended.