The make-dive-profile program

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

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