2 EK  v        1                                                                                                                                                                                                                                                                        !LUNGA , version 1.02 (15.10.1998), by Gregor Cedilnik, Germany.

	***********************
	*** The Diver's log ***
	***********************

	Copyright Gregor Cedilnik 1998, 1999
	All right reserved

!#DISCLAIMER OF WARRANTY " 
No guarantee is given for this package to work correctly,
no guarantee to work at all or to do anything ;-)
Be careful with your dives and do not relay on this package.
Use it only for control of your own calculations!
Mistakes or errors can lead to harmful injuries!!!
Error reports as well as suggestions for improving this
package are very welcome. For e-mail address see below.


!#Description " 
This software package includes
	LUNGA.exe	The program, version 1.02 (Okt. 1998)
	LUNGA.cfg	Configuration file for LUNGA.exe
	PADI1.tab
	PADI2.tab
	PADI3.tab	Data-Files (dive-tables)
	SSI1.tab
	SSI2.tab
	SSI3.tab	Data-Files (dive-tables)
	mickey.dat
	donald.dat	Example files
The package is a kind of logbook for SCUBA-divers
for dives within no-decompression limits. It is able
to calculate residual nitrogen time and pressure groups.
It is created especially for HP-LX Palmtop computers,
but it should run on any computer under MS-DOS with
CGA-compatible display.

This package is not intended to substitute the 'conventional'
logbook, but it can be a helpful tool to verify the own
calculation of rnt and pressure goups or to plan dives.

The name 'LUNGA' is derived from 'Port Noarlunga' in Australia,
where I learned SCUBA-diving.

Limits: 'LUNGA' can handle 100 dives per person.
History: This is the first public release.

!#Installation " 
Just copy the files of this package to the same directory.
type 'LUNGA' from the ms-dos command line to start the program.

!#Using the program " 
You should already know how to document a dive (and understand
expressions like 'surfac interval', 'residual nitrogen time' or
'actual bottom time'). The program is intuitiv/self-explaining
(at least this was my aim). A simple online help is available
by pressing 'F1' (='HELP' on HP-LX palmtop computer).

!#Adding/removing divers, using tables " 
The names of the divers are given by the configuration file
'lunga.cfg'. Example files for divers 'Donald' and 'Mickey'
are included in this package.
Use a text editor to change the divers names in 'lunga.cfg'.
In that file each diver is define by a line 'DIVER: ###'
where '###' is the diver's name (maximum length 8 characters,
only letters or digits, no space (' ') allowed).
The number of divers in not
limited, but only the first two divers are shown in LUNGA.
The name of the dive table is also given in 'lunga.cfg'.
That file must begin with 'TABLE: ###', where '###' is the
table name. At the moment only 'PADI' and 'SSI' are supported.

!#Dive tables " 
The data used in LUNGA is compatibel to the the tables used
at PADI/SSI.
What does LUNGA do if the limits of this tables are exceeded:

         if depth-limit exceeded: instead of a pressure group
the sign '' is shown. If there is residual nitrogen
from the last dive, a residual nitrogen time 999'
is used. The calculation for the next dive is based
on pressure group 'Z'.

         

         if the total bottom time is exceeded: instead of a pressure
group the symbol '' is shown. The calculation for the
next dive is based on pressure group 'Z'.

        

         if surface-interval is to short for a new dive: a residual
nitrogen time 999' is used.


        if the surface interval is long enough (e.g. at a new day),
the previous dive has
not to be taken into calculation. Instead of a pressure group
the sign '-' is shown as pressure group at the beginning of
the current dive.

!#The future " 
At the moment no further features for LUNGA are planned.
If errors are found (comments are welcome) a new releas
(fixing them) will be published (see
www.uni-jena.de/~p5grce/lunga.html).
What features could be added?
* A program to print out the dive data. This could be done
  e.g. with 'PERL' or 'AWK'. And it could look like
  a page of the logbook which the diver is used to.
* 'LUNGA' could calculate dive limits (-> "how long can I dive
   in a given depth" or "what si-time is necessary").

!#The history "
The package was completely developed on a HP200LX Palmtop
computer using Turbo C 1.5, mainly during my holydays in Turkey
(HP200LX is a fine machine and I really think that Windows CE
threw back such machines a few years in performance and
usefulness).

LUNGA:
V1.02 (Nov. 1998) is the first release with nominally 0 bugs.

!#Freew#are" 
 This package is "postcard-ware", all rights are reserved.
Anybody who dives 'just for fun' (i.e. without making any
money with diving and without a profession related to diving)
can
use it for free. A postcard from where you are diving is very
welcome (address see below).
All others should contact me for a separate permission.
This program package may be freely distributed, but all the
files listed above must be included and may not be changed.
!
 
Enjoy your dives and this programm!

**********************
* Gregor Cedilnik    *
* Rechbergstr. 15    *
* D-71126 Gaeufelden *
* Germany            *
*                    *****************
* E-mail: gregor@cedilnik.de         *
**************************************

****************************************************************
****************************************************************
****************************************************************

!#Format of the dive tables: "

(if someone creates new tables, please send me a copy to include
them into the package)

!#Table1: " total bottom time -> pressure group

The first line contains the depths, ascending order from left to
right. Exactly 16 values must be given. If less are needed,
!use zeros ('0') to fill the line. 
The first colum n contains the pressure groups, they must be
namend from 'A' to 'Z' (26 values).
The table now gives the maximum time (in minutes) for the
given depth and pressure group. Empty fields (exceeding the
limits) must be filled with zeros ('0'). Filds with arrows
('use next pressure group') are also filled with zeros.

!#Table2 " pressure group: before surface interval (si) -> after si

The first line contains the pressure group after si,
left to right: from 'A' to 'Z' (26).
The first colum n contains the pressure groups before si (also
from 'A' to 'Z').
The table now gives the maximum time to change from one pressure
group to the other. Empty fields must be filled with zeros.
The time given in (h:mm) must be enterd as 'hmm' (example: 1:30
as 130, 0:05 as 5). If your table supports less than 26 pressure
groups, special ttention must be paid to line 'Z'. That pressure
group is used by 'LUNGA' also for dives exceeding the limit, so
any data must be supported here. One possibility is to use the
data from the highest pressure group supported by your table
and add a 'penalty' si to each value.

!#Table3: " pressure group (pg) -> residual nitrogen time (rnt)

nThe first line contains the pg, left to right: from 'Z' to 'A'
(26 values). The first colum n contains the depth (in meters)
in ascending order. Exactly 16 values must be given. If less
are needed, use zeros to fill the column.
The table now gives the rnt (in minutes) for the
given depth and pressure group. Empty fields (pressure group too
high for another dive) and undefined fields must be filled with
zeros ('0').


