Updates to Section 3 of the user manual
Section 3 is quite a long section. Ten of the screen shots are replaced. Large numbers of typos and inconsistencies are corrected. A few sentences are included e.g when dealing with the Subsurface Companion. Section dealing with creating libdivecomputer dump files has been reorganised slightly. Signed-off-by: Willem Ferguson <willemferguson@zoology.up.ac.za> Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
Before Width: | Height: | Size: 7 KiB After Width: | Height: | Size: 6 KiB |
Before Width: | Height: | Size: 8 KiB After Width: | Height: | Size: 7.4 KiB |
Before Width: | Height: | Size: 11 KiB After Width: | Height: | Size: 9.4 KiB |
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 11 KiB |
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 11 KiB |
Before Width: | Height: | Size: 5.2 KiB After Width: | Height: | Size: 3.4 KiB |
Before Width: | Height: | Size: 13 KiB After Width: | Height: | Size: 11 KiB |
Before Width: | Height: | Size: 4.7 KiB After Width: | Height: | Size: 4.5 KiB |
Before Width: | Height: | Size: 5.4 KiB After Width: | Height: | Size: 5 KiB |
Before Width: | Height: | Size: 6 KiB After Width: | Height: | Size: 6.7 KiB |
|
@ -135,7 +135,7 @@ open logbook, the user is asked whether the open logbook should be
|
||||||
saved before a new logbook is created.
|
saved before a new logbook is created.
|
||||||
|
|
||||||
[[S_GetInformation]]
|
[[S_GetInformation]]
|
||||||
== How to obtain dive information to store in the user's logbook
|
== How to store dive information in the user's logbook
|
||||||
|
|
||||||
There are several ways in which dive information can be added to a logbook:
|
There are several ways in which dive information can be added to a logbook:
|
||||||
|
|
||||||
|
@ -179,7 +179,7 @@ fields are visible:
|
||||||
|
|
||||||
image::images/AddDive2.jpg["FIGURE: The Dive Notes tab",align="center"]
|
image::images/AddDive2.jpg["FIGURE: The Dive Notes tab",align="center"]
|
||||||
|
|
||||||
The *Starttime* field reflects the date and the time of the dive. By clicking
|
The *Start time* field reflects the date and the time of the dive. By clicking
|
||||||
the down-arrow on the right of that field a calendar will be displayed from
|
the down-arrow on the right of that field a calendar will be displayed from
|
||||||
which
|
which
|
||||||
one can choose the correct date. The time values (hour and minutes) can also be
|
one can choose the correct date. The time values (hour and minutes) can also be
|
||||||
|
@ -204,7 +204,7 @@ here. These can come from three sources:
|
||||||
a. One can find the coordinates on the world map in the bottom right hand
|
a. One can find the coordinates on the world map in the bottom right hand
|
||||||
part
|
part
|
||||||
of the Subsurface window. The map displays a green bar indicating "No location
|
of the Subsurface window. The map displays a green bar indicating "No location
|
||||||
data - Move the map double-click to set the location". Upon a double-click
|
data - Move the map and double-click to set the dive location". Upon a double-click
|
||||||
at the appropriate place, the green bar disappears and the coordinates are
|
at the appropriate place, the green bar disappears and the coordinates are
|
||||||
stored.
|
stored.
|
||||||
|
|
||||||
|
@ -225,9 +225,9 @@ Southern hemisphere latitudes are given with a *S*, e.g. S30°, or with a
|
||||||
negative value, e.g. -30.22496. Similarly western longitudes are given with a
|
negative value, e.g. -30.22496. Similarly western longitudes are given with a
|
||||||
*W*, e.g. W07°, or with a negative value, e.g. -7.34323.
|
*W*, e.g. W07°, or with a negative value, e.g. -7.34323.
|
||||||
|
|
||||||
Please note that GPS coordinates of a dive site a linked to the Location
|
Please note that GPS coordinates of a dive site are linked to the Location
|
||||||
name - so adding coordinates to dives that don't have a location set will
|
name - so adding coordinates to dives that does not have a location description
|
||||||
caused unexpected behavior (as Subsurface will think that all of these
|
will cause unexpected behavior (Subsurface will think that all of these
|
||||||
dives have the same location and try to keep their GPS coordinates the
|
dives have the same location and try to keep their GPS coordinates the
|
||||||
same.
|
same.
|
||||||
|
|
||||||
|
@ -238,16 +238,15 @@ the current logbook.
|
||||||
|
|
||||||
*Buddy*: In this field one can enter the name(s) of the buddy / buddies
|
*Buddy*: In this field one can enter the name(s) of the buddy / buddies
|
||||||
(separated by commas) who accompanied the user on the dive. Auto completion
|
(separated by commas) who accompanied the user on the dive. Auto completion
|
||||||
based on the list of buddies in the current logbook is offered.
|
is offered based on the list of buddies in the current logbook.
|
||||||
|
|
||||||
*Suit*: The type of diving suit that was used for the dive can be entered here.
|
*Suit*: The type of diving suit used for the dive can be entered here.
|
||||||
Just as with the
|
As with the other items, auto completion of the suit description is available.
|
||||||
other items, auto completion of the suit description is available.
|
|
||||||
|
|
||||||
*Rating*: In this field, users can provide a subjective overall rating of the
|
*Rating*: In this field, provide a subjective overall rating of the
|
||||||
dive on a 5-point scale by clicking the appropriate star on the rating scale.
|
dive on a 5-point scale by clicking the appropriate star on the rating scale.
|
||||||
|
|
||||||
*Visibility*: As with the previous item, users can provide a rating of
|
*Visibility*: As with the previous item, provide a rating of
|
||||||
visibility during the dive on a 5-point scale by clicking the appropriate star.
|
visibility during the dive on a 5-point scale by clicking the appropriate star.
|
||||||
|
|
||||||
*Tags*: Tags that describe the type of dive performed may
|
*Tags*: Tags that describe the type of dive performed may
|
||||||
|
@ -289,25 +288,25 @@ dive.
|
||||||
The dark dustbin icon on the left allows one to delete information for a
|
The dark dustbin icon on the left allows one to delete information for a
|
||||||
particular cylinder.
|
particular cylinder.
|
||||||
|
|
||||||
The user starts by selecting a cylinder type on the left-hand side of the
|
Start by selecting a cylinder type on the left-hand side of the
|
||||||
table. To select a cylinder, the user must click in the *cylinder type* box.
|
table. To select a cylinder, click in the *Type* box.
|
||||||
This brings up a list button that can be used to display a dropdown list of
|
This brings up a button that can be used to display a dropdown list of
|
||||||
cylinders:
|
cylinders:
|
||||||
|
|
||||||
image::images/CylinderDataEntry2.jpg["FIGURE:The cylinder drop-down list button",align="center"]
|
image::images/CylinderDataEntry2.jpg["FIGURE:The cylinder drop-down list button",align="center"]
|
||||||
|
|
||||||
This drop-down list can then be used to select the cylinder type that was used
|
The drop-down list can be used to select the cylinder type used
|
||||||
for this dive. The
|
for the dive. The
|
||||||
*Size* of the cylinder as well as its working pressure (*WorkPress*) will
|
*Size* of the cylinder as well as its working pressure (*WorkPress*) will
|
||||||
automatically be shown in the dialogue.
|
automatically be shown in the dialogue. If a cylinder is not shown in the dropdown list, type the name and description of that cylinder into the *Type* field.
|
||||||
|
|
||||||
Next, the user must indicate the starting pressure and the ending pressure of
|
Next, indicate the starting pressure and the ending pressure of
|
||||||
the
|
the
|
||||||
gas used during the dive. The unit of pressure (metric/imperial) corresponds
|
gas used during the dive. The unit of pressure (metric/imperial) corresponds
|
||||||
to the setting in the preferences.
|
to the setting in the _Preferences_.
|
||||||
|
|
||||||
Finally, the user should type in the gas mixture used. If air
|
Finally, type in the gas mixture used in the *O2%* field. If air
|
||||||
was used, a value of 21% can be entered on this field, or the field might be
|
was used, a value of 21% can be entered on this field, or it might be
|
||||||
left blank. If nitrox or trimix were used, their percentages of oxygen and/or
|
left blank. If nitrox or trimix were used, their percentages of oxygen and/or
|
||||||
helium must be specified.
|
helium must be specified.
|
||||||
Any inappropriate fields should be left empty. After typing the information for
|
Any inappropriate fields should be left empty. After typing the information for
|
||||||
|
@ -320,7 +319,7 @@ dive made using two cylinders (air and EAN50):
|
||||||
image::images/CylinderDataEntry3.jpg["FIGURE: a completed cylinder dive information table",align="center"]
|
image::images/CylinderDataEntry3.jpg["FIGURE: a completed cylinder dive information table",align="center"]
|
||||||
|
|
||||||
*Weights*: Information about the weight system used during a dive can be entered
|
*Weights*: Information about the weight system used during a dive can be entered
|
||||||
using a dialogue very similar to that of the cylinder information. If the user
|
using a dialogue very similar to that for the cylinder information. If the user
|
||||||
clicks the + button on the top right of the weights dialogue, the table looks
|
clicks the + button on the top right of the weights dialogue, the table looks
|
||||||
like this:
|
like this:
|
||||||
|
|
||||||
|
@ -331,7 +330,7 @@ through a down-arrow:
|
||||||
|
|
||||||
image::images/WeightsDataEntry2.jpg["FIGURE: Weights type drop-down list button",align="center"]
|
image::images/WeightsDataEntry2.jpg["FIGURE: Weights type drop-down list button",align="center"]
|
||||||
|
|
||||||
This drop-down list can then be used to select the type of weight system. In
|
The drop-down list can then be used to select the type of weight system. In
|
||||||
the *Weight*
|
the *Weight*
|
||||||
field, the weight used during the dive must be typed. After typing the
|
field, the weight used during the dive must be typed. After typing the
|
||||||
information
|
information
|
||||||
|
@ -346,7 +345,7 @@ with two types of weights: integrated and a weight belt:
|
||||||
image::images/WeightsDataEntry3.jpg["FIGURE: A completed weights information table",align="center"]
|
image::images/WeightsDataEntry3.jpg["FIGURE: A completed weights information table",align="center"]
|
||||||
|
|
||||||
There's NO need to click the _Save_ button before the dive
|
There's NO need to click the _Save_ button before the dive
|
||||||
profile has beeb completed.
|
profile has been completed.
|
||||||
|
|
||||||
==== Creating a Dive Profile
|
==== Creating a Dive Profile
|
||||||
|
|
||||||
|
@ -362,17 +361,17 @@ _Modifying the dive profile_: When the cursor is moved around the dive profile,
|
||||||
its position is indicated by two red lines as shown below. The depth and time
|
its position is indicated by two red lines as shown below. The depth and time
|
||||||
that the cursor represents are indicated, respectively on the left hand and
|
that the cursor represents are indicated, respectively on the left hand and
|
||||||
bottom axes. The units (metric/imperial) on the axes are determined by the
|
bottom axes. The units (metric/imperial) on the axes are determined by the
|
||||||
*preference* settings. The dive profile itself comprises several
|
*Preference* settings. The dive profile itself comprises several
|
||||||
line segments demarcated by waypoints (white dots on the profile, as shown
|
line segments demarcated by waypoints (white dots on the profile, as shown
|
||||||
above). The default dive depth is 15 m.
|
above). The default dive depth is 15 m.
|
||||||
If the dive depth was 21 m then the user needs to drag the appropriate waypoints
|
If the dive depth was 21 m then the user needs to drag the appropriate waypoints
|
||||||
downwards to represent 21 m. To add a waypoint, double-click on
|
downwards to represent 21 m. To add a waypoint, double-click on
|
||||||
any line segment.
|
any line segment. To move an additional waypoint, drag it.
|
||||||
To remove a waypoint, right-click on it and choose "Remove this point" from the
|
To remove this waypoint, right-click on it and choose "Remove this point" from the
|
||||||
context menu. The user will also need to drag the waypoints to represent an
|
context menu. The user needs to drag the waypoints to represent an
|
||||||
accurate
|
accurate
|
||||||
time duration for the dive. Below is a dive profile that represents a dive
|
time duration for the dive. Below is a dive profile that represents a dive
|
||||||
to 21 m for 31 min, followed by a 3 minute safety stop at 5 m.
|
to 21 m for 31 min, followed by a 5 minute safety stop at 5 m.
|
||||||
|
|
||||||
image::images/DiveProfile2.jpg["FIGURE: Edited dive profile",align="center"]
|
image::images/DiveProfile2.jpg["FIGURE: Edited dive profile",align="center"]
|
||||||
|
|
||||||
|
@ -380,7 +379,7 @@ _Specifying the gas composition:_ The gas composition used is clearly indicated
|
||||||
along the line segments of the dive profile. This defaults to the first gas
|
along the line segments of the dive profile. This defaults to the first gas
|
||||||
mixture specified in the *Equipment* tab, which was air in the case of the
|
mixture specified in the *Equipment* tab, which was air in the case of the
|
||||||
profile illustrated above. The gas mixtures of segments of the dive profile can
|
profile illustrated above. The gas mixtures of segments of the dive profile can
|
||||||
be edited. This is done by clicking on the particular
|
be edited. This is done by right-clicking on the particular
|
||||||
waypoint and selecting the appropriate gas from the context menu. Changing
|
waypoint and selecting the appropriate gas from the context menu. Changing
|
||||||
the gas for a waypoint affects the gas shown in the segment _to the left_ of
|
the gas for a waypoint affects the gas shown in the segment _to the left_ of
|
||||||
that
|
that
|
||||||
|
@ -389,9 +388,9 @@ context menu:
|
||||||
|
|
||||||
image::images/DiveProfile3.jpg["FIGURE: Gas composition context menu",align="center"]
|
image::images/DiveProfile3.jpg["FIGURE: Gas composition context menu",align="center"]
|
||||||
|
|
||||||
Below is the profile of a dive to 21 m for 31 min with a switch from air to
|
Below is the profile of a dive to 21 m for 31 min for which an extra waypoint was added at 18 m on the ascent and with a switch from air to
|
||||||
EAN40 on the ascent. In this case the first cylinder in the *Equipment* tab
|
EAN50 at 18 m. In this case the first cylinder in the *Equipment* tab
|
||||||
contained air and the second cylinder contained EAN40.
|
contained air and the second cylinder contained EAN50.
|
||||||
|
|
||||||
image::images/DiveProfile4.jpg["FIGURE: Completed dive profile",align="center"]
|
image::images/DiveProfile4.jpg["FIGURE: Completed dive profile",align="center"]
|
||||||
|
|
||||||
|
@ -404,7 +403,7 @@ on the top right hand of the Dive Notes tab. If the _Save_ button is clicked,
|
||||||
the dive data
|
the dive data
|
||||||
are saved in the current logbook. If the _Cancel_ button is clicked, the newly
|
are saved in the current logbook. If the _Cancel_ button is clicked, the newly
|
||||||
entered
|
entered
|
||||||
dive data are discarded. When exiting _Subsurface_ the user will be prompted
|
dive data are discarded. When exiting _Subsurface_, the user will be prompted
|
||||||
once more to save the logbook with the new dive(s).
|
once more to save the logbook with the new dive(s).
|
||||||
|
|
||||||
|
|
||||||
|
@ -430,9 +429,9 @@ PC-Communication mode. **This could drain the dive computer's battery**. We
|
||||||
therefore
|
therefore
|
||||||
recommend that the user checks if the dive computer is charged when
|
recommend that the user checks if the dive computer is charged when
|
||||||
connected to the USB port of a PC. For example, several Suunto and Mares dive
|
connected to the USB port of a PC. For example, several Suunto and Mares dive
|
||||||
computers do not recharge through the USB connection. The users should refer to
|
computers do not recharge through the USB connection. Users should refer to
|
||||||
the dive computer's manual
|
the dive computer's manual
|
||||||
if they are unsure whether the dive computer will recharge or drain its batteries
|
if they are unsure whether the dive computer recharges its batteries
|
||||||
while connected to the USB port.
|
while connected to the USB port.
|
||||||
|
|
||||||
To import dive information from a dive computer to a computer with
|
To import dive information from a dive computer to a computer with
|
||||||
|
@ -470,11 +469,11 @@ _Subsurface_ only imports dives that have not been uploaded before. This makes
|
||||||
the download process faster on most dive computers and also saves battery power
|
the download process faster on most dive computers and also saves battery power
|
||||||
of the dive computer (at least for those not charging while connected via USB).
|
of the dive computer (at least for those not charging while connected via USB).
|
||||||
If, for some reason, the user wishes to import ALL dives from the dive computer,
|
If, for some reason, the user wishes to import ALL dives from the dive computer,
|
||||||
even though some may already be in the logbook, then the the check box labeled
|
even though some may already be in the logbook, then check the the check box labeled
|
||||||
_Force download of all dives_ can be ticked.
|
_Force download of all dives_.
|
||||||
|
|
||||||
- The dialogue has two drop-down lists, *Vendor* and *Dive Computer*. On the
|
- The dialogue has two drop-down lists, *Vendor* and *Dive Computer*. On the
|
||||||
*vendor* drop-down list the user must select the make of the computer, e.g.
|
*vendor* drop-down list select the make of the computer, e.g.
|
||||||
Suunto, Oceanic,
|
Suunto, Oceanic,
|
||||||
Uwatec, Mares. On the *Dive Computer* drop-down list, the model name of
|
Uwatec, Mares. On the *Dive Computer* drop-down list, the model name of
|
||||||
the dive computer must be selected, e.g. D4 (Suunto), Veo200 (Oceanic), or Puck
|
the dive computer must be selected, e.g. D4 (Suunto), Veo200 (Oceanic), or Puck
|
||||||
|
@ -546,7 +545,7 @@ software? Has it worked before, or is this the first time the cable is being use
|
||||||
4) Consult *Appendix A* and make sure that the correct Mount Point
|
4) Consult *Appendix A* and make sure that the correct Mount Point
|
||||||
was specified (see above).
|
was specified (see above).
|
||||||
5) On Unix-like operating systems, does the user have write permission to the
|
5) On Unix-like operating systems, does the user have write permission to the
|
||||||
USB port? If not, users should consult *Appendix A*.
|
USB port? If not, consult *Appendix A*.
|
||||||
|
|
||||||
If the _Subsurface_ computer does not recognise the USB adaptor by
|
If the _Subsurface_ computer does not recognise the USB adaptor by
|
||||||
showing an appropriate device name next to the Mount Point, then there is a
|
showing an appropriate device name next to the Mount Point, then there is a
|
||||||
|
@ -563,16 +562,18 @@ two check boxes checked in the download dialogue discussed above:
|
||||||
during the download process: under normal circumstances they should not be checked.
|
during the download process: under normal circumstances they should not be checked.
|
||||||
When checking these boxes, the user is prompted to select a folder to
|
When checking these boxes, the user is prompted to select a folder to
|
||||||
save the information to. The default folder is the one in which the _Subsurface_
|
save the information to. The default folder is the one in which the _Subsurface_
|
||||||
dive log is kept. *Important:* After downloading with the above checkboxes
|
dive log is kept.
|
||||||
checked, no dives are shown in the
|
|
||||||
*Dive List* but two files are created in the folder selected above:
|
*Important:* _After downloading with the above checkboxes
|
||||||
|
checked, no dives are added to the
|
||||||
|
*Dive List* but two files are created in the folder selected above_:
|
||||||
|
|
||||||
subsurface.log
|
subsurface.log
|
||||||
subsurface.bin
|
subsurface.bin
|
||||||
|
|
||||||
These files should be send to the _Subsurface_ mail list:
|
These files should be send to the _Subsurface_ mail list:
|
||||||
_subsurface@hohndel.org_ with a
|
_subsurface@hohndel.org_ with a
|
||||||
request for the files to be analysed. One should provide the dive computer
|
request for the files to be analysed. Provide the dive computer
|
||||||
make and model
|
make and model
|
||||||
as well as contextual information about the dives recorded on the dive computer.
|
as well as contextual information about the dives recorded on the dive computer.
|
||||||
****
|
****
|
||||||
|
@ -582,14 +583,14 @@ as well as contextual information about the dives recorded on the dive computer.
|
||||||
==== Updating the dive information imported from the dive computer.
|
==== Updating the dive information imported from the dive computer.
|
||||||
|
|
||||||
The information from the dive computer is not complete and more
|
The information from the dive computer is not complete and more
|
||||||
details must be added in order to have a more complete record of the dives. To
|
details must be added in order to have a more full record of the dives. To
|
||||||
do this,
|
do this,
|
||||||
the *Dive Notes* and the *Equipment* tabs on the top left hand of the
|
the *Dive Notes* and the *Equipment* tabs on the top left hand of the
|
||||||
_Subsurface_ window should be used.
|
_Subsurface_ window should be used.
|
||||||
|
|
||||||
==== Dive Notes
|
==== Dive Notes
|
||||||
|
|
||||||
The date and time of the dive, gas mixture and perhaps water temperature is
|
The date and time of the dive, gas mixture and (often) water temperature is
|
||||||
shown as obtained from the dive computer, but the user needs to add some
|
shown as obtained from the dive computer, but the user needs to add some
|
||||||
additional information by hand in order to have a more complete dive record.
|
additional information by hand in order to have a more complete dive record.
|
||||||
The message in a blue box at
|
The message in a blue box at
|
||||||
|
@ -612,15 +613,11 @@ temperature information and this field may therefore not require further
|
||||||
editing. If
|
editing. If
|
||||||
editing is required, only a value is required. The units of temperature will be
|
editing is required, only a value is required. The units of temperature will be
|
||||||
automatically supplied by
|
automatically supplied by
|
||||||
_Subsurface_ (according to the 'Preferences', metric or imperial units will
|
_Subsurface_ (according to the _Preferences_, metric or imperial units will
|
||||||
be used).
|
be used).
|
||||||
|
|
||||||
*Location*: In this field one should type in text that describes the site
|
*Location*: In this field one should type in text that describes the site
|
||||||
where the dive was performed, e.g. "Tihany, Lake Balaton, Hungary". the required drivers to interact with the download cable and connected dive
|
where the dive was performed, e.g. "Tihany, Lake Balaton, Hungary".
|
||||||
computer.
|
|
||||||
|
|
||||||
If all the above points are in order and there is a failure to download the
|
|
||||||
dive
|
|
||||||
Auto completion of location names will
|
Auto completion of location names will
|
||||||
make this easier when a user frequently dives at the same sites.
|
make this easier when a user frequently dives at the same sites.
|
||||||
|
|
||||||
|
@ -629,8 +626,8 @@ here. These can come from three sources:
|
||||||
|
|
||||||
a. The user can find the coordinates on the world map in the bottom right hand
|
a. The user can find the coordinates on the world map in the bottom right hand
|
||||||
part
|
part
|
||||||
of the Subsurface window. The map displays a green bar indicating "No location
|
of the Subsurface window. The map displays a green bar indicating "Move the map
|
||||||
data - move the map and double-click to set the location". Double-click
|
and double-click to set the dive location". Double-click
|
||||||
at the appropriate place, the green bar disappears and the coordinates are
|
at the appropriate place, the green bar disappears and the coordinates are
|
||||||
stored.
|
stored.
|
||||||
|
|
||||||
|
@ -648,12 +645,12 @@ four formats with latitude followed by longitude:
|
||||||
Decimal degrees, e.g. 30.22496 , 30.821798
|
Decimal degrees, e.g. 30.22496 , 30.821798
|
||||||
|
|
||||||
Southern hemisphere latitudes are given with a *S*, e.g. S30°, or with a
|
Southern hemisphere latitudes are given with a *S*, e.g. S30°, or with a
|
||||||
negative value, e.g. -30.22496. Similarly western longitudes are given with a
|
negative value, e.g. -30.22496. Similarly, western longitudes are given with a
|
||||||
*W*, e.g. W07°, or with a negative value, e.g. -7.34323.
|
*W*, e.g. W07°, or with a negative value, e.g. -7.34323.
|
||||||
|
|
||||||
*Divemaster*: The name of the dive master or dive guide for this dive should be
|
*Divemaster*: The name of the dive master or dive guide for this dive should be
|
||||||
entered in this field.
|
entered in this field
|
||||||
This field offers auto completion based on the list of dive masters in
|
which offers auto completion based on the list of dive masters in
|
||||||
the current logbook.
|
the current logbook.
|
||||||
|
|
||||||
*Buddy*: In this field, one enters the name(s) of the buddy / buddies
|
*Buddy*: In this field, one enters the name(s) of the buddy / buddies
|
||||||
|
@ -726,10 +723,10 @@ automatically be shown in the dialogue.
|
||||||
|
|
||||||
Next one must indicate the starting pressure and the ending pressure of the
|
Next one must indicate the starting pressure and the ending pressure of the
|
||||||
specified gas during the dive. The unit of pressure (metric/imperial)
|
specified gas during the dive. The unit of pressure (metric/imperial)
|
||||||
corresponds to the settings chosen in the preferences.
|
corresponds to the settings chosen in the _Preferences_.
|
||||||
|
|
||||||
Finally, the user must type in the gas mixture used. If air was used, the
|
Finally, the user must provide the gas mixture used. If air was used, the
|
||||||
value of 21% can be entered here or this field can be left blank. If nitrox or
|
value of 21% can be entered or this field can be left blank. If nitrox or
|
||||||
trimix were used, their percentages of oxygen and/or helium should be entered.
|
trimix were used, their percentages of oxygen and/or helium should be entered.
|
||||||
Any inappropriate fields should be left empty. After typing the
|
Any inappropriate fields should be left empty. After typing the
|
||||||
information for the cylinder,
|
information for the cylinder,
|
||||||
|
@ -764,14 +761,14 @@ It is possible to enter information for more than one weight system by adding
|
||||||
an additional system
|
an additional system
|
||||||
using the + button on the top right hand. Weight systems can be deleted using
|
using the + button on the top right hand. Weight systems can be deleted using
|
||||||
the dustbin icon on the left hand. Here is an example of information for a dive
|
the dustbin icon on the left hand. Here is an example of information for a dive
|
||||||
with two types of weights: integrated and a weight belt:
|
with two types of weights: integrated as well as a weight belt:
|
||||||
|
|
||||||
image::images/WeightsDataEntry3.jpg["FIGURE: A completed weights information table",align="center"]
|
image::images/WeightsDataEntry3.jpg["FIGURE: A completed weights information table",align="center"]
|
||||||
|
|
||||||
==== Saving the updated dive information
|
==== Saving the updated dive information
|
||||||
|
|
||||||
The information entered in the *Dive Notes* tab and the *Equipment* tab can be
|
The information entered in the *Dive Notes* tab and the *Equipment* tab can be
|
||||||
saved with all the other information of the dives in the user's logbook by
|
saved by
|
||||||
using the
|
using the
|
||||||
two buttons on the top right hand of the *Dive Notes* tab. If the _Save_ button
|
two buttons on the top right hand of the *Dive Notes* tab. If the _Save_ button
|
||||||
is clicked,
|
is clicked,
|
||||||
|
@ -785,13 +782,13 @@ that the new data should be saved.
|
||||||
|
|
||||||
[[S_ImportingAlienDiveLogs]]
|
[[S_ImportingAlienDiveLogs]]
|
||||||
|
|
||||||
If a user has been diving for some time, it's possible that several dives were
|
If a user has been diving for some time, it is possible that several dives were
|
||||||
logged using other dive log software. All this information needs not
|
logged using other dive log software. This information does not need retyping
|
||||||
be typed by hand into _Subsurface_, because these divelogs can probably be
|
becuse these divelogs can probably be
|
||||||
imported onto _Subsurface_. _Subsurface_ will import divelogs from a range of
|
imported onto _Subsurface_. _Subsurface_ will import divelogs from a range of
|
||||||
other
|
other
|
||||||
dive log software. While some software is supported natively, for others the
|
dive log software. While some software is supported natively, for others the
|
||||||
user will have to
|
user has to
|
||||||
export the logbook(s) to an intermediate format so that they can then be imported
|
export the logbook(s) to an intermediate format so that they can then be imported
|
||||||
by _Subsurface_.
|
by _Subsurface_.
|
||||||
Currently, _Subsurface_ supports importing CSV log files from several sources.
|
Currently, _Subsurface_ supports importing CSV log files from several sources.
|
||||||
|
@ -800,7 +797,7 @@ preconfigured, but because the import is flexible, users can configure their own
|
||||||
imports.
|
imports.
|
||||||
Manually kept log files (e.g. in spreadsheet) can also be imported by
|
Manually kept log files (e.g. in spreadsheet) can also be imported by
|
||||||
configuring the CSV import.
|
configuring the CSV import.
|
||||||
_Subsurface_ can also import UDDF and UDCF files that are used by some divelog
|
_Subsurface_ can also import UDDF and UDCF files used by some divelog
|
||||||
software and some divecomputers, like the Heinrichs & Weikamp DR5. Finally,
|
software and some divecomputers, like the Heinrichs & Weikamp DR5. Finally,
|
||||||
for some divelog software like Mares Dive Organiser it is currently suggested to
|
for some divelog software like Mares Dive Organiser it is currently suggested to
|
||||||
import the logbooks first into a webservice like _divelogs.de_ and then import
|
import the logbooks first into a webservice like _divelogs.de_ and then import
|
||||||
|
@ -827,18 +824,15 @@ Towards the bottom right is a dropdown selector with a default label
|
||||||
of _Dive Log Files_ which gives access to the different types of direct imports
|
of _Dive Log Files_ which gives access to the different types of direct imports
|
||||||
available, as in dialogue *B*, above. Currently these are:
|
available, as in dialogue *B*, above. Currently these are:
|
||||||
|
|
||||||
- XML-formatted dive logs
|
- XML-formatted dive logs (Divinglog 5.0, MacDive and several other dive log systems)
|
||||||
- UDDF-formatted dive logs
|
- UDDF-formatted dive logs (e.g. Kenozoooid)
|
||||||
- UDCF-formatted dive logs
|
- UDCF-formatted dive logs
|
||||||
- JDiveLog
|
- JDiveLog
|
||||||
- Suunto Dive Manager (DM3 and DM4)
|
- Suunto Dive Manager (DM3 and DM4)
|
||||||
- MacDive (XML)
|
|
||||||
- DivingLog 5.0 (XML)
|
|
||||||
- Kenozooid (UDDF)
|
|
||||||
- CSV (text-based and spreadsheet-based) dive logs.
|
- CSV (text-based and spreadsheet-based) dive logs.
|
||||||
|
|
||||||
Selecting the appropriate file in the file list of the dialogue opens
|
Selecting the appropriate file in the file list of the dialogue opens
|
||||||
the imported dive log in the _Subsurface_ *Dive List*. A few other formats, not
|
the imported dive log in the _Subsurface_ *Dive List*. Some other formats, not
|
||||||
accessible through the Import dialogue are also supported, as explained below.
|
accessible through the Import dialogue are also supported, as explained below.
|
||||||
|
|
||||||
==== Importing from Mares Dive Organiser V2.1
|
==== Importing from Mares Dive Organiser V2.1
|
||||||
|
@ -847,13 +841,12 @@ Since Mares utilise proprietory Microsoft software not compatible with
|
||||||
multi-platform applications, these dive logs cannot be
|
multi-platform applications, these dive logs cannot be
|
||||||
directly imported into
|
directly imported into
|
||||||
_Subsurface_. Mares dive logs need to be imported using a three-step process,
|
_Subsurface_. Mares dive logs need to be imported using a three-step process,
|
||||||
using _www.divelogs.de_ as a mechanism to extract the dive information from
|
using _www.divelogs.de_ as a mechanism to extract the dive log information.
|
||||||
the file.
|
|
||||||
|
|
||||||
- The dive log data from Mares Dive Organiser need to be exported to the user's
|
- The dive log data from Mares Dive Organiser need to be exported to the user's
|
||||||
desktop, using
|
desktop, using
|
||||||
a _.sdf_ file name extension. Refer to xref:Mares_Export[Appendix
|
a _.sdf_ file name extension. Refer to xref:Mares_Export[Appendix C] for more
|
||||||
C] for more information.
|
information.
|
||||||
- Data should then be imported into _www.divelogs.de_. One needs to create a user
|
- Data should then be imported into _www.divelogs.de_. One needs to create a user
|
||||||
account in
|
account in
|
||||||
_www.divelogs.de_, log into that web site, then
|
_www.divelogs.de_, log into that web site, then
|
||||||
|
@ -887,8 +880,8 @@ image::images/Divelogs1.jpg["FIGURE:Download from Divelogs.de",align="center"]
|
||||||
|
|
||||||
Sometimes dive computers export dive information as files with
|
Sometimes dive computers export dive information as files with
|
||||||
_comma-separated values_ (.CSV). For example, the APD Inspiration and Evolution
|
_comma-separated values_ (.CSV). For example, the APD Inspiration and Evolution
|
||||||
closed circuit rebreather (CCR) systems export dive information in CSV format
|
closed circuit rebreather (CCR) systems export dive information in a CSV
|
||||||
that normally contains information about a single dive only. These
|
formatted file that normally contains information for a single dive only. These
|
||||||
files can easily be imported into _Subsurface_.
|
files can easily be imported into _Subsurface_.
|
||||||
CSV files are normally organised into
|
CSV files are normally organised into
|
||||||
a single line that provides the headers of the data columns, followed by the
|
a single line that provides the headers of the data columns, followed by the
|
||||||
|
@ -922,7 +915,7 @@ data? This field separator should be either a comma (,) or a TAB character.
|
||||||
This can be determined by opening the file with a text editor. If it is
|
This can be determined by opening the file with a text editor. If it is
|
||||||
comma-delimited, then the comma
|
comma-delimited, then the comma
|
||||||
characters between the values are clearly visible. If no commas are evident and
|
characters between the values are clearly visible. If no commas are evident and
|
||||||
the numbers are aligned,
|
the numbers are aligned in columns,
|
||||||
the file is probably TAB-delimited (i.e. it uses a TAB as a field separator, as
|
the file is probably TAB-delimited (i.e. it uses a TAB as a field separator, as
|
||||||
in the above example).
|
in the above example).
|
||||||
|
|
||||||
|
@ -939,7 +932,7 @@ instance for the above example:
|
||||||
Armed with this information, importing the data into _Subsurface_ is
|
Armed with this information, importing the data into _Subsurface_ is
|
||||||
straightforward. Select
|
straightforward. Select
|
||||||
_Import->Import Log Files_ from the main menu. In the resulting file
|
_Import->Import Log Files_ from the main menu. In the resulting file
|
||||||
selection menu, select oa CSV files, after which a common configuration dialog
|
selection menu, select _CSV files_, after which a common configuration dialog
|
||||||
appears for all the
|
appears for all the
|
||||||
files with a CSV extension:
|
files with a CSV extension:
|
||||||
|
|
||||||
|
@ -949,7 +942,7 @@ image::images/Import_CSV1.jpg["FIGURE: CSV download dialogue",align="center"]
|
||||||
There are pre-configured definitions for some dive computers, e.g. the APD
|
There are pre-configured definitions for some dive computers, e.g. the APD
|
||||||
rebreathers. If the user's dive computer is on this list, it should be selected
|
rebreathers. If the user's dive computer is on this list, it should be selected
|
||||||
using the dropdown
|
using the dropdown
|
||||||
box labeled _Pre-configured imports_. Finally the _OK_ should be clicked and
|
box labeled _Pre-configured imports_. Finally _OK_ should be clicked and
|
||||||
the dive will be imported and listed in the *Dive List* tab of _Subsurface_.
|
the dive will be imported and listed in the *Dive List* tab of _Subsurface_.
|
||||||
|
|
||||||
If the dive computer is not on the pre-configured list, the user must
|
If the dive computer is not on the pre-configured list, the user must
|
||||||
|
@ -961,7 +954,7 @@ variables. For each data column used for import, the user must check the
|
||||||
appropriate check box
|
appropriate check box
|
||||||
and indicate in which column these data are found. For instance, the image above
|
and indicate in which column these data are found. For instance, the image above
|
||||||
corresponds to the dialogue that would apply to the CSV data set described above
|
corresponds to the dialogue that would apply to the CSV data set described above
|
||||||
the image. Having performed the column specification, select the _OK_ button
|
the image. After completing the column specification, select the _OK_ button
|
||||||
and the dive will be imported and listed in the *Dive List* tab of _Subsurface_.
|
and the dive will be imported and listed in the *Dive List* tab of _Subsurface_.
|
||||||
|
|
||||||
|
|
||||||
|
@ -988,9 +981,10 @@ the data
|
||||||
are in clear columns, the file
|
are in clear columns, the file
|
||||||
is probably TAB-delimited (i.e. it uses a TAB as a field separator, as in the
|
is probably TAB-delimited (i.e. it uses a TAB as a field separator, as in the
|
||||||
above example).
|
above example).
|
||||||
A recommended field separator for the export is tab, as commas might be used in
|
A recommended field separator for the export is tab, as commas might be part of
|
||||||
the
|
the
|
||||||
field values themselves.
|
field values themselves. Therefore the use of an appropriate field separator
|
||||||
|
in very important.
|
||||||
|
|
||||||
b. Which columns need to be imported into _Subsurface_?. We do not
|
b. Which columns need to be imported into _Subsurface_?. We do not
|
||||||
currently have any mandatory input fields, but some, e.g. dive duration
|
currently have any mandatory input fields, but some, e.g. dive duration
|
||||||
|
@ -1001,15 +995,15 @@ import.
|
||||||
|
|
||||||
c. Units used for depth, weight and temperature. We consider depth to be
|
c. Units used for depth, weight and temperature. We consider depth to be
|
||||||
either feet or meters, weight kilograms or pounds and temperature either
|
either feet or meters, weight kilograms or pounds and temperature either
|
||||||
Celsius or Fahrenheit. However, the users can only select _Metric_ or
|
Celsius or Fahrenheit. However, the users can select _Metric_ or
|
||||||
_Imperial_ in the Preferences tab of _Subsurface_.. No mixture of unit s
|
_Imperial_ in the _Preferences_ tab of _Subsurface_. No mixture of unit
|
||||||
ystems is allowed for the different fields.
|
systems is allowed for the different fields.
|
||||||
|
|
||||||
Importing manually kept CSV log files is quite straight forward, but
|
Importing manually kept CSV log files is quite straight forward, but
|
||||||
there might be many fields and counting the field numbers is error
|
there might be many fields and counting the field numbers is error
|
||||||
prone. Therefore validation of the data to be imported is critical.
|
prone. Therefore validation of the data to be imported is critical.
|
||||||
|
|
||||||
To import the dives, one must select _Import->Import Log Files_ from the menu
|
To import the dives, select _Import->Import Log Files_ from the menu
|
||||||
bar. If the CSV option in the dropdown list is selected and the file list
|
bar. If the CSV option in the dropdown list is selected and the file list
|
||||||
includes file names ending with .CSV, one can select the
|
includes file names ending with .CSV, one can select the
|
||||||
_Manual dives_ tab that will bring up the following configuration dialog:
|
_Manual dives_ tab that will bring up the following configuration dialog:
|
||||||
|
@ -1022,15 +1016,19 @@ appear in the *Dive List* area of _Subsurface_.
|
||||||
|
|
||||||
|
|
||||||
[[S_Companion]]
|
[[S_Companion]]
|
||||||
=== Importing GPS coordinates with the Subsurface Companion app for mobile
|
=== Importing GPS coordinates with the *Subsurface Companion App* for mobile phones
|
||||||
phones
|
|
||||||
If the user has an Android device with GPS, the coordinates for the diving
|
If the user has an Android device with GPS, the coordinates for the diving
|
||||||
location can be obtained and automatically passed to Subsurface
|
location can be obtained and automatically passed to the _Subsurface_
|
||||||
divelog. To do this, one needs to:
|
divelog. This takes place when the Companion App stores the dive locations on
|
||||||
|
a dedicated Internet-based file server. _Subsurface_, in turn, can collect
|
||||||
|
the localities from the file server.
|
||||||
|
|
||||||
|
To do this, one needs to:
|
||||||
|
|
||||||
- Register on the http://api.hohndel.org/login/[Subsurface companion web page].
|
- Register on the http://api.hohndel.org/login/[Subsurface companion web page].
|
||||||
A confirmation mail with instructions and a personal *DIVERID* will be send together with
|
A confirmation mail with instructions and a personal *DIVERID* will be send together with
|
||||||
a long number that gives access to the companion app capabilities.
|
a long number that gives access to the file server and Companion App capabilities.
|
||||||
|
|
||||||
- Download the app from
|
- Download the app from
|
||||||
https://play.google.com/store/apps/details?id=org.subsurface[Google Play Store]
|
https://play.google.com/store/apps/details?id=org.subsurface[Google Play Store]
|
||||||
|
@ -1053,16 +1051,16 @@ this DIVERID and does not ask for it again unless one uses the _Disconnect_ menu
|
||||||
option (see below).
|
option (see below).
|
||||||
|
|
||||||
Now one is ready to get a dive position and send it to the server. The Android
|
Now one is ready to get a dive position and send it to the server. The Android
|
||||||
display will look like the left hand image (A) below, but without any dive.
|
display will look like the left hand image (*A*) below, but without any dive.
|
||||||
|
|
||||||
Touching the "+" icon on the top right to add a new dive site. Users will be
|
Touch the "+" icon on the top right to add a new dive site. Users will be
|
||||||
prompted for a place name (or asked to activate the GPS if it was turned off).
|
prompted for a place name (or asked to activate the GPS if it is turned off).
|
||||||
The main screen shows a list of dive locations, each with a name, date and
|
The main screen shows a list of dive locations, each with a name, date and
|
||||||
time. Some dives may have an arrow-up icon on the selection box to the left (see
|
time. Some dives may have an arrow-up icon on the selection box to the left (see
|
||||||
image B in the middle, below) indicating that they require upload to the server.
|
image B in the middle, below) indicating that they require upload to the server.
|
||||||
|
|
||||||
There are several ways to send dives to the server; the easiest is by simply
|
There are several ways to send dives to the server; the easiest is by simply
|
||||||
selecting the dive. See middle image below (B):
|
selecting the dive. See middle image below (*B*):
|
||||||
|
|
||||||
image::images/Companion.jpg["FIGURE: Screen shots (A-C) of companion app",align="center"]
|
image::images/Companion.jpg["FIGURE: Screen shots (A-C) of companion app",align="center"]
|
||||||
|
|
||||||
|
@ -1080,7 +1078,7 @@ saved on a Subsurface dive log (see below).
|
||||||
|
|
||||||
===== Settings on the Companion app
|
===== Settings on the Companion app
|
||||||
|
|
||||||
Selecting the _Settings_ menu option results in the right hand image above (C).
|
Selecting the _Settings_ menu option results in the right hand image above (*C*).
|
||||||
|
|
||||||
===== Server and account
|
===== Server and account
|
||||||
|
|
||||||
|
@ -1153,7 +1151,7 @@ of another registered diver.
|
||||||
This option sends all locations stored in the Android device to the server.
|
This option sends all locations stored in the Android device to the server.
|
||||||
|
|
||||||
|
|
||||||
==== Downloading dive locations to a Subsurface divelog
|
==== Downloading dive locations to the _Subsurface_ divelog
|
||||||
|
|
||||||
Download dive(s) from a dive computer or enter them manually into
|
Download dive(s) from a dive computer or enter them manually into
|
||||||
_Subsurface_ before obtaining the GPS coordinates from the server. The download
|
_Subsurface_ before obtaining the GPS coordinates from the server. The download
|
||||||
|
@ -1662,7 +1660,7 @@ image::images/Printpreview.jpg["FIGURE: Print preview page",align="center"]
|
||||||
|
|
||||||
|
|
||||||
[[S_Preferences]]
|
[[S_Preferences]]
|
||||||
== Setting user *Preferences* for _Subsurface_
|
== Setting user _Preferences_ for _Subsurface_
|
||||||
|
|
||||||
There are several settings within _Subsurface_ that the users can specify. These
|
There are several settings within _Subsurface_ that the users can specify. These
|
||||||
are found when selecting _File->Preferences_. The settings are performed in
|
are found when selecting _File->Preferences_. The settings are performed in
|
||||||
|
|