tau trial

Create and manage experiment trials.

TAU Commander trials
=========================================================================

A trial is created by running the binary: `tau trial create ./a.out <args>`
more commonly though it is simply created by using the tau prefix and
execution command - that is: `tau ./a.out` or `tau mpirun -np # ./a.out <args>`.
The binary a.out will be executed and the TAU Commander specified data
will be collected.  This completes data collection to form a trial.

Delete a trial: `tau trial delete <trial_number>`

Edit a trial: `tau trial edit <trial_number> --description <free form text>`

Export a trial: `tau trial export <trial_number> [optional arg]`
Optional argument is:  `--destination <path>`

Viewing data for a trial: Enter `tau trial show` or `tau show` and
TAU Commander will open up the appropriate display window to
graphically show the data of the trial.  This will be the last trial
collected with the active or selected experiment.  To see data for
a different trial for this experiment just enter the trial number
after show (e.g. `tau trial show 0`).  Please note that trial numbers
begin with 0.  The first trial is trial number 0.   If tau dashboard
shows 3 trials those 3 trials are numbered 0, 1, 2

Alternatively, you may enter: `tau show <trial #>` This will have the
same affect as: `tau trial show #`

You may also specify files instead of trial numbers, in this case enter:
`tau show <data_file>` or `tau trial show <data_file>`

_______________________________________________________________________

Usage

usage: tau trial <subcommand> [arguments]

Create and manage experiment trials.

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

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

Subcommands:
  create        Create new trial of the selected experiment.
  delete        Delete experiment trials.
  edit          Edit experiment trials.
  export        Export trial data.
  list          Show trial data.
  renumber      Renumber trial numbers.
  show          Display trial data from a file path or trial number.

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