Uwe Ohse / available software / The mosquitotools package

The make-dive-profile program

make-dive-profile - Create a dive profile.

SYNOPSIS


make-dive-profile depth time [depth time pairs...]

DESCRIPTION


make-dive-profile creates a dive profile from the depth / time pairs on the command line for later use with mosquitograph. It may be useful for education and to answer 'what if' questions.

'depth' is the depth of each step in meters, and 'time' is it's length. A negative 'time' means to stay on 'depth' until 'time' minutes have passed since the start of the dive.

A unit may be appended to 'depth' (defaults to meter, use the --show-units option for more units) and 'time' (defaults to minutes, but 'seconds' and hours are also recognized).

To switch gas during the `dive' use 'n2 XX' instead of a depth/time pair, where N2 is the new nitrogen percentage of the gas mix. The default gas is air, containing 78% nitrogen. To use a different gas from the beginning of the dive use 'n2 ZZ' as the first depth/time pair.

OPTIONS


-a, --ascend-speed=LENGTH-UNIT
Ascend rate in units per minute. Default 10m/min. You have to append a unit to the number, if the unit isn't meter. A value of 0 is not allowed.
-A, --aprupt
Generate profiles with aprupt depth changes. The default is to use smooth depth changes. An aprupt profile ignores the --ascend-speed and --descend-speed options.
-d, --descend-speed=LENGTH-UNIT
Descend rate in units per minute. Default 20m/min. You have to append a unit to the number, if the unit isn't meter. A value of 0 is not allowed.
-D, --date=YYYY-MM-DDThh:mm[:ss]
Use date as dive-start-date. The date and time have to be given in the iso-8601 format. This option is useful when you want to use the continuous load calculation option of mosquitograph. The date format is something like '2003-07-20T13:14'.
-I, --id=ID
Use ID as dive identifier in the profile. The default is 'demo-dive', which should usually be good enough. You may find it useful to use different dive ids if you plan to work with more than one dive profile created by make-dive-profile.
-i, --interval=SECONDS
Fake sampling interval. This interval determines the time difference between two values in the dive profile and the granularity of the graph. The default interval is 20 seconds. When given an interval of 0 make-dive-profile will create a profile with just the absolutely needed points, which will be much shorter, but not as beautiful.
--see-also
Where to find related information.
--examples
Usage examples.
--show-units
Show known units.
--caveat
Show warnings.
--version
Show version: make-dive-profile 0.1.2.
--help
Show a list of options or the long help on one. The use with an argument shows the long help text of that option, without an argument it will list all options.
--longhelp
Show longer help texts for all or one option.

EXAMPLES


Create a dive profile with a ground time of 15 minutes on 40 meters, followed by 5 minutes on 12, 5 minutes on 9, 5 minutes on 6 and 10 minutes on 3 meters:
  make-dive-profile 40 -15   12 5   9 5   6 5   3 10
Now do the same using a slow ascend speed of 2 meters per minute:
  make-dive-profile -a 2 40 -15   12 5   9 5   6 5   3 10

KNOWN UNITS


Pressure may be given as 1.23unit, with unit being one of:
  bar (default), mbar, hpa, kpa, atm, psi.

Volumes may be given as 1.23unit, with unit being one of:

  liter (default), cuft.

Lengths may be given as 1.23unit, with unit being one of:

  m or meter (default), cm, mm, f or foot, yard.

CAVEAT


This software is still in an early testing stage and may contain serious flaws. Do not bet your life on it!

COPYRIGHT


Copyright (C) 2003 Uwe Ohse.

The software comes with NO WARRANTY, to the extent permitted by law.

For now this package it is subject to the conditions found in http://www.ohse.de/uwe/licenses/UO-GPL-TEST but it will be free software in the future.

AUTHOR


Uwe Ohse, uwe@ohse.de.

MORE INFORMATION


Please report bugs to mosquitotools@lists.ohse.de

SEE ALSO


mosquitograph(1) turns dive profiles into pictures. dive-profile(5) describes the dive profile data format. mosquitoget(1) reads dive profiles from suunto mosquito dive computers.

The mosquitotools have a mailing list. Send an empty mail to mosquitotools-subscribe@bulkmail.ohse.de to subscribe to it.

The mosquitotools homepage is at

  http://www.ohse.de/uwe/mosquitotools.html