The mosquitograph program

Uwe Ohse / available software / The mosquitotools package

The mosquitograph program

mosquitograph - Create graphs from dive profiles.

SYNOPSIS

mosquitograph FILE [...]

DESCRIPTION

mosquitograph creates PIC graphs from one or more dive profiles. By default it will create a graph on an own page per dive. 'No decompression times', speed vectors and inert gas saturation may be included.The dive profile will be read from the standard input if FILE is `-'.

OPTIONS

-1, --merge

Merge dives into one graph. The default is to create one graph per dive. Use this option to create an 'overlay' style graph.

-A, --air-pressure-at-surface=PRESSURE

Air pressure at surface. Append an unit to the number, unless the unit is the default unit 'bar'. Default value: 1bar.

-b, --black-white

Do not use colors. Color support depends on relatively new versions of groff. Use this option if your groff is too old.

-c, --continuous-load

Keep track on tissue load between dives. The default is to start with freshly initialized load values for each graph. This options causes the program to keep track of the tissue load between dives. The order of the dives on the command line is important.

-C, --ceilings=NUMBER

Show deco ceilings. Draw markers are the deepest depth where a tissue load would be NUMBER times 100 percent of it's maximum load or higher. IOW: To maintain a safety reserve of (1-NUMBER)*100 percent the diver shall stay below that border. Example: Draw markers at the depth were the diver would have cross the 25% safety margin:

  mosquitograph -ceilings 0.75 filename.dive

-D, --desaturation-factor=FACTOR

Desaturation speed factor. Assume that desaturation halfvalue times are FACTOR times longer as usual. The default FACTOR is 1.00. Values over one are safer, and values below one should be avoided, as they are highly optimistical.

--feet

Use feet, not meters. For use in backward countries.

--fahrenheit

Use degree fahrenheit, not degree celsius. For use in one backward country.

-H, --height=ARG

Height of graphic in cm.

-l, --load

Show inert gas load in bar.

--load-ambient-%

Inert gas load as % of tolerable ambient pressure. Show the inert gas saturation of the tissues as percentage of the maximum saturation allowed for the tissue at the current depth. 0% is the inert gas load at the surface, when breathing air, and 100% is the maximum inert gas load load allowed by the decompression model used.

--load-surface-%

Inert gas load as % of tolerable surface pressure. Show the inert gas saturation of the tissues as percentage of the maximum saturation allowed for the tissue at the surface.

-m, --model=MODEL

Decompression model to use. Model description files are looked for in /package/misc/mosquitotools-0.1.2/data/ or the current directory. The file name shall be MODEL.model

-n, --nitrox-fraction=ARG

The fraction of nitrogen in the cylinder. In other words: Nitrogen partial pressure in gas mix at 1 bad ambient pressure. Default: 0.78. Note: This overrides _all_ gas information in the dive data.

-N, --no-deco-times

Show no deco times. 'No deco time' is the time the diver may stay at the current depth without having to do a decompression stop. Note that this is a very rough approximation and that it doesn't take into account the settings of the --ceilings and --desaturation-factor options. So better do not bet your life on this calculation.

-P, --page-for-log

Make log file page. This will create an additional header containing the basic dive data.

-S, --saturation-factor=FACTOR

Saturation speed factor. Assume that saturation halfvalue times are FACTOR times as long as usual. The default FACTOR is 1. Values larger 1 should be avoided at all cost. See the --desaturation-factor option for how to slow down desaturation.

-V, --vectors

Show ascend/descend speed vectors. This adds red arrows to the graph showing the vertical speed of the dive.

-W, --width=ARG

Width of graphic in cm.

-u, --unload

Show inert gas unloading. This option is broken right now.

--examples

Usage examples.

--see-also

Where to find related information.

--show-units

Show known units.

--caveat

Show warnings.

--version

Show version: mosquitograph (mosquitotools) 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

Simple usage, showing the result in the screen:

  mosquitograph filename | groff -pt | gv -

Create multiple graphs, printing the result:

  mosquitograph filename1 filename2 | groff -pt | lpr

Show the tissue load on the terminal:

  mosquitograph --load filename | groffer

Show tissue load and speed vectors:

  mosquitograph --load --vectors filename | groffer

Show tissue load relative to the maximum for the current depth:

  mosquitograph --load-ambient-% filename | groffer

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