DCMDTERM(1)

NAME
dcmdterm - graph dives on the terminal

SYNOPSIS
dcmdterm [-alntv] [files...]

DESCRIPTION
The dcmdterm utility accepts XML files generated by dcmd(1) and graphs depths and/or temperatures on the terminal. Multiple dives are stacked atop each other. Its arguments are as follows:

-a  Accumulate dives instead of showing them stacked. This is useful for free-diving where multiple dives are done in sequence.

-l  Show the legend.

-n  Don't show UTF-8 or ANSI colours.

-t  Show temperatures if the dive profile contains them.

-v  Parse files in verbose mode.

files...
    XML input files with one or more dives.

dcmdterm uses ANSI/VT100 terminal escapes for console manipulation and colours. If files is empty or “-”, standard input is used.

By default, dcmdterm graphs depth. Each dive is associated with a colour that is the same for both graphs. In practise, more than three dives is a little much. A title is printed above the graphs, along with the associated line colour, identifying the dive.

Multiple graphs are stacked atop each other with the x-axis being the relative time into the dive. In -a accumulation mode, however, graphs are shown as starting at the first date and time. (Dives must have been parsed with a date and time). This is useful, for example, with a sequence of free-dives.

EXIT STATUS

EXAMPLES
To pipe the output of the day's free-dives from on a Suunto D6i:

    dcmd -r "" "suunto d6i" | dcmdterm -a

This will extract only the current day's dives, then format them alongside (instead of stacked) using UTF-8 characters.

To compare two dive profiles previously downloaded into dive1.xml and dive2.xml, run:

    dcmdterm dive1.xml dive2.xml

SEE ALSO
dcmd(1)

AUTHORS
The dcmdterm utility was written by Kristaps Dzonsons, kristaps@bsd.lv.