tau measurement

Create and manage measurement configurations.

TAU Commander Measurements:
=============================================================================
Create a new measurement- enter:
`tau measurement create <profile_name> --profile` or
`tau measurement create <profile_name> --trace`

Edit TAU Commander Measurements. The following measurement data arguments
may be edited `--callpath [depth]` and `--metrics [PAPI metrics]`
e.g. `tau measurement edit <measurement_name> --callpath 3`

The following measurement instrumentation settings may be defined with commands:
`--compiler-inst [mode]`   (valid  modes are: `always, fallback, never` )
`--source-inst [mode]` (valid modes are: `automatic, manual, never` )

The default is sampling, where TAU Commander will use the symbols in the binary
when built with -g to decipher code information.  Source instrumentation
relies on the Program Database Toolkit (PDT) to add information to track and
the last is utilization of the compiler to instrument the source code.
There are several TAU commands that can explicitly be added to the code which
is beyond the scope of this introductory manual.  Those interested can find
more information in the TAU User Guide
(https://www.cs.uoregon.edu/research/tau/docs/newguide/index.html).

The following measurement instrumentation arguments can be set to True or False
(T/F) `--keep-inst-files --reuse-inst-files --sample`

The following measurement arguments are set to True or False `--callsite
--comm-matrix --cuda --io --metadata-merge --mpi --opencl --shmem --throttle
The following measurement arguments may be set; --throttle-num-calls [count]
--throttle-per-calls [us] (us=microseconds)`

The following memory and output formats are set to True or False (T/F)
`--heap-usage --memory-alloc --profile --trace`
 A measurement can be renamed with:
`Tau measurement --new-name <measurement_name> <new_measurement_name>`
A measurement can be deleted with: `tau measurement --delete <measurement_name>`
Measurements are listed with: `tau measurement list` (optional `--l` or `--s`
(long or short descriptions)).

_____________________________________________________________________________

Usage

usage: tau measurement <subcommand> [arguments]

Create and manage measurement configurations.

Positional Arguments:
  <subcommand>  See 'subcommands' below.
  [arguments]   Arguments to be passed to <subcommand>.

Options:
  -h, --help    Show this help message and exit.

Subcommands:
  copy          Copy and modify measurement configurations.
  create        Create measurement configurations.
  delete        Delete measurement configurations.
  edit          Modify measurement configurations.
  list          Show measurement configuration data.

See `tau measurement <subcommand> --help` for more information on a subcommand.