command-line-options.md

Extra-P Command Line Options

The Extra-P command line interface has the following options.

Arguments
Positional
FILEPATH	Specify a file path for Extra-P to work with
Optional
-h, --help	Show help message and exit
--version	Show program's version number and exit
--log {debug, info, warning, error, critical}	Set program's log level (default: warning)
Input options
--cube	Load a set of CUBE files and generate a new experiment
--extra-p-3	Load data from Extra-P 3 (legacy) experiment
--json	Load data from JSON or JSON Lines input file
--talpas	Load data from Talpas data format
--text	Load data from text input file
--experiment	Load Extra-P experiment and generate new models
--scaling {weak, weak_threaded, strong}	Set scaling type when loading data from per-thread/per-rank files (CUBE files) (default: weak)
--keep-values	Keeps the original values after import
Modeling options
--median	Use median values for computation instead of mean values
--modeler {default, basic, refining, multi-parameter}	Selects the modeler for generating the performance models
--options KEY=VALUE [KEY=VALUE ...]	Options for the selected modeler
--help-modeler {default, basic, refining, multi-parameter}	Show help for modeler options and exit
Output options
--out OUTPUT_PATH	Specify the output path for Extra-P results
--print {all,all-python,all-latex, callpaths, metrics, parameters, functions,functions-python,functions-latex, FORMAT_STRING}	Set which information should be displayed after modeling. Use one of the presets or specify a formatting string using placeholders (see output-formatting.md). (default: all)
--save-experiment EXPERIMENT_PATH	Saves the experiment including all models as Extra-P experiment (if no extension is specified, “.extra-p” is appended)
--model-set-name NAME	Set the name of the generated set of models when outputting an experiment (default: “New model”)
--disable-progress	Disables the progress bar outputs of Extra-P to stdout and stderr