simtools-write-production-metadata

Write or check production-job metadata manifests.

Overview

The application writes job-level metadata manifests for an existing simulation production. It uses the authoritative ECSV job grid to reconstruct each job configuration and discovers output files below each job-* directory, including the standard sim_telarray/runNNNNNN and corsika/runNNNNNN subdirectories. When reduced-event data or sim_telarray logs are available, the generated manifest also records simulated and triggered event counts under statistics without reading the simtel event output.

Use --check to validate manifests that already exist. In write mode, use --overwrite to replace existing manifests.

Input and output

Role	Argument	Format	Description
Input	production_path	Directory	Directory containing job-* output directories.
Input	job_grid_file	ECSV	Job grid used to resolve the production configuration.
Output	simulate_prod_job_metadata.yml	YAML	One manifest per job directory.

Command line arguments

options

–help

show this help message and exit

–production_path

Directory containing production job output directories.

Required.

–job_grid_file

Authoritative job grid used to reconstruct resolved production configuration.

–check

Validate existing manifests without writing files.

–overwrite

Overwrite existing metadata manifests in write mode.

application

–show_options

Print available values for a supported option and exit.

Example

simtools-write-production-metadata \
    --production_path /data/production \
    --job_grid_file /data/production_grid.ecsv \
    --overwrite