tau measurement create

Create measurement configurations.

Usage

usage: tau measurement create <measurement_name> [arguments]

Create measurement configurations.

Options:
  -@ <level>                  Create the measurement at the specified storage level.
                                - <level>: project, user, system
  -h, --help                  Show this help message and exit.

Data Arguments:
  --callpath [depth]          Maximum depth for callpath recording.
  --metrics <metric> [<metric> ...]
                              A space or comma separated list of performance metrics to gather, e.g.
                              TIME PAPI_FP_INS.
  --system-load [T/F]         Measure system load.
  --unwind-depth [depth]      Record callstack to specified depth.

Instrumentation Arguments:
  --baseline [T/F]            Completely disable all instrumentation and measure wall clock time via
                              the OS.
  --compiler-inst [mode]      Use compiler-generated callbacks to gather performance data.
                                - mode: always, fallback, never
  --keep-inst-files [T/F]     Don't remove instrumented files after compilation.
  --reuse-inst-files [T/F]    Reuse and preserve instrumented files after compilation.
  --sample [T/F]              Use event-based sampling to gather performance data.
  --source-inst [mode]        Use hooks inserted into the application source code to gather
                              performance data.
                                - mode: automatic, manual, never

Measurement Arguments:
  <measurement_name>          Measurement configuration name.
  --callsite [T/F]            Record event callsites.
  --comm-matrix [T/F]         Record the point-to-point communication matrix.
  --cuda [T/F]                Measure cuda events via the CUPTI interface.
  --extra-tau-options <option> [<option> ...]
                              Append extra options to TAU_OPTIONS environment variable (not
                              recommended).
  --force-tau-options <option> [<option> ...]
                              Forcibly set the TAU_OPTIONS environment variable (not recommended).
  --io [T/F]                  Measure time spent in POSIX I/O calls.
  --level_zero [T/F]          Level zero .
  --metadata-merge [T/F]      Merge metadata of TAU profiles.
  --mpi [T/F]                 Use MPI library wrapper to measure time spent in MPI methods.
  --mpit [T/F]                MPI-T profiling interface.
  --openacc [T/F]             Use OpeACC library wrapper to measure time spent in OpenACC methods.
  --opencl [T/F]              Measure OpenCL events.
  --openmp [library]          Use specified library to measure time spent in OpenMP directives.
                                - library: ignore, opari, ompt
  --ptts [T/F]                Enable support for PTTS.
  --ptts-post [T/F]           Skip application sampling and post-process existing PTTS sample files.
  --ptts-report-flags PTTS_REPORT_FLAGS
                              Flags to pass to PTTS report_ts command.
  --ptts-restart [T/F]        Enable restart support within PTTS, allowing application to
                              continuerunning and be reinstrumented after stop.
  --ptts-sample-flags sample_flags
                              Flags to pass to PTTS sample_ts command.
  --ptts-start PTTS_START     Address at which to start a PTTS sampling region.
  --ptts-stop PTTS_STOP       Address at which to stop a PTTS sampling region.
  --sample-resolution [file/function/line]
                              Sample resolution.
                                - file/function/line: file, function, line
  --sampling-period [us]      Default sampling period in microseconds.
  --select-file path          Specify selective instrumentation file.
  --shmem [T/F]               Use SHMEM library wrapper to measure time spent in SHMEM methods.
  --tag <tags> [<tags> ...]   Narrow search for tags.
  --throttle [T/F]            Throttle lightweight events to reduce overhead.
  --throttle-num-calls [count]
                              Lightweight event call count threshold.
  --throttle-per-call [us]    Lightweight event duration threshold in microseconds.
  --update-nightly [T/F]      Download newest TAU nightly.

Memory Arguments:
  --heap-usage [T/F]          Measure heap memory usage.
  --memory-alloc [T/F]        Record memory allocation/deallocation events and detect leaks.
  --track-memory-footprint [T/F]
                              Track memory footprint.

Output Format Arguments:
  --profile [<format>]        Generate application profiles.
                                - <format>: tau, merged, cubex, sqlite, none
  --trace [<format>]          Generate application traces.
                                - <format>: slog2, otf2, none