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


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


mosquitoget(1) reads dive profiles from suunto mosquito dive computers. dive-profile(5) describes the dive profile data format. make-dive-profile(1) creates dive profiles.

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