.Dd $Mdocdate$

.Os

.Nm dcmdterm

.Nd graph dives on the terminal

.Nm dcmdterm

.Op Fl alntv

.Op Ar files...

The

.Nm

utility accepts XML files generated by

.Xr dcmd 1

and graphs depths and/or temperatures on the terminal.

Multiple dives are stacked atop each other.

Its arguments are as follows:

.Bl -tag -width Ds

.It Fl a

Accumulate dives instead of showing them stacked.

This is useful for free-diving where multiple dives are done in

sequence.

.It Fl l

Show the legend.

.It Fl n

Don't show UTF-8 or ANSI colours.

.It Fl t

Show temperatures if the dive profile contains them.

.It Fl v

Parse files in verbose mode.

.It Ar files...

XML input files with one or more dives.

.El

.Pp

.Nm

uses ANSI/VT100 terminal escapes for console manipulation and

colours.

If

.Ar files

is empty or

.Dq \&- ,

standard input is used.

.Pp

By default,

.Nm

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.

.Pp

Multiple graphs are stacked atop each other with the x-axis being the

relative time into the dive.

In

.Fl a

accumulation mode, however, graphs are shown as starting at the first

date and time.

.Pq Dives must have been parsed with a date and time .

This is useful, for example, with a sequence of free-dives.

.Ex -std

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

.Pp

.Dl dcmd -r \(dq\(dq \(dqd6i\(dq | dcmdterm -a

.Pp

This will extract only the current day's dives, then format them one

after another instead of stacking them atop each other.

.Pp

To compare two dive profiles previously downloaded into

.Pa dive1.xml

and

.Pa dive2.xml ,

run:

.Pp

.D1 dcmdterm -l dive1.xml dive2.xml

.Xr dcmd 1

The

.Nm

utility was written by

.An Kristaps Dzonsons ,

.Mt [email protected] .