svtk metrics

Command Tree

Command Details

Usage

svtk metrics [-h] {plan,run,run-batch,merge-batches,outputs,slurm} ...

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

svtk metrics merge-batches

Usage

svtk metrics merge-batches [-h] --manifest MANIFEST --output OUTPUT
                               [--allow-missing]

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

--manifest

Yes

Value: manifest. Metric workflow manifest JSON.

--output

Yes

Value: output. Merged output CSV/parquet path.

--allow-missing

No

Flag

Allow missing batch outputs.

svtk metrics outputs

Usage

svtk metrics outputs [-h] --metrics METRICS --output-dir OUTPUT_DIR
                         [--events EVENTS] [--stations STATIONS]
                         [--residual-column RESIDUAL_COLUMN]
                         [--score-column SCORE_COLUMN]
                         [--format {parquet,csv}] [--dashboard-partitioned]

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

--metrics

Yes

Value: metrics. Metric workflow rows CSV/parquet path.

--output-dir

Yes

Value: output_dir. Output directory.

--events

No

Value: events. Optional event metadata CSV/parquet path.

--stations

No

Value: stations. Optional station metadata CSV/parquet path.

--residual-column

No

Value: residual_column. Column exposed as canonical residual.

--score-column

No

Value: score_column. Column exposed as canonical score.

--format

No

Default: parquet; Choices: parquet, csv

Value: format. Table output format.

--dashboard-partitioned

No

Flag

Partition dashboard metric rows.

svtk metrics plan

Usage

svtk metrics plan [-h] [--observed-inventory OBSERVED_INVENTORY]
                      [--synthetic-inventory SYNTHETIC_INVENTORY]
                      [--config CONFIG] [--run-scenario RUN_SCENARIO]
                      [--metric METRICS] [--metric-group METRIC_GROUPS]
                      [--component COMPONENTS] [--passband PASSBANDS]
                      [--model MODELS] [--transform TRANSFORMS]
                      [--output-mode OUTPUT_MODE] --output OUTPUT
                      [--manifest] [--batch-output-dir BATCH_OUTPUT_DIR]
                      [--batch-size BATCH_SIZE] [--qc-table QC_TABLE]
                      [--no-qc]

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

--observed-inventory

No

Value: observed_inventory. Observed metric waveform inventory.

--synthetic-inventory

No

Value: synthetic_inventory. Synthetic metric waveform inventory.

--config

No

Value: config. Spatial-VTK config file.

--run-scenario

No

Value: run_scenario. Apply one named run_scenarios overlay.

--metric

No

Repeatable

Value: metrics. Metric override. Repeat or use ‘all’.

--metric-group

No

Repeatable

Value: metric_groups. Metric-group override. Repeat or use ‘all’.

--component

No

Repeatable

Value: components. Component override. Repeat for multiple components.

--passband

No

Repeatable

Value: passbands. Period passband override, such as 1-2. Repeat for multiple bands.

--model

No

Repeatable

Value: models. Synthetic model override. Repeat for multiple models.

--transform

No

Repeatable

Value: transforms. Metric transform override. Repeat for multiple transforms.

--output-mode

No

Value: output_mode. Metric output mode override.

--output

Yes

Value: output. Output task table or manifest path.

--manifest

No

Flag

Write a JSON manifest instead of a task table.

--batch-output-dir

No

Value: batch_output_dir. Batch output directory when writing a manifest.

--batch-size

No

Default: 100

Value: batch_size. Tasks per batch when writing a manifest.

--qc-table

No

Value: qc_table. Optional QC inventory recorded in a manifest.

--no-qc

No

Flag

Do not mark planned tasks as QC-filtered by default.

svtk metrics run

Usage

svtk metrics run [-h] --tasks TASKS --output OUTPUT
                     [--qc-table QC_TABLE]

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

--tasks

Yes

Value: tasks. Task CSV/parquet path.

--output

Yes

Value: output. Output metric CSV/parquet path.

--qc-table

No

Value: qc_table. Optional QC inventory.

svtk metrics run-batch

Usage

svtk metrics run-batch [-h] --manifest MANIFEST --batch-index
                           BATCH_INDEX [--overwrite]

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

--manifest

Yes

Value: manifest. Metric workflow manifest JSON.

--batch-index

Yes

Value: batch_index. Batch index to run.

--overwrite

No

Flag

Replace an existing batch output.

svtk metrics slurm

Usage

svtk metrics slurm [-h] --manifest MANIFEST --output OUTPUT --config
                       CONFIG [--run-scenario RUN_SCENARIO]

Parameters

Name

Required

Default / choices

Description

-h, --help

No

show this help message and exit

--manifest

Yes

Value: manifest. Metric workflow manifest JSON.

--output

Yes

Value: output. Output SLURM script path.

--config

Yes

Value: config. Config file containing metrics.slurm settings.

--run-scenario

No

Value: run_scenario. Apply one named run_scenarios overlay.