-
Subsurface lets you configure a dive computer. Currently the Heinrichs-Weikamp (OSTC 2, OSTC 3) and
+
Subsurface lets you configure a dive computer. Currently, the Heinrichs-Weikamp (OSTC 2/2N/2C, OSTC 3, Sport) and
Suunto Vyper (Stinger, Mosquito, D3, Vyper, Vytec,
Cobra, Gekko and Zoop) family of dive computers are supported. A large number of settings of these dive computers
can be read and changed to different values. To begin, be sure the appropriate hardware driver
@@ -4548,18 +4537,18 @@ computer model from the panel on the left-hand (see image below).
There are several user-definable settings within Subsurface, found by selecting
File → Preferences, mostly affecting the way in which Subsurface
shows dive information to the user. The settings are in
-six panels: Defaults, Units, Graph, Language, Network, and Georeference,
+six panels: General, Units, Profile, Language, Network, and Georeference,
all of which operate on the same principles: specified settings can be applied to the display of
the dive log by selecting Apply. At this stage, any new settings only apply to the present
session and are not saved. In order to apply
new settings permanently, select the Save button. If you do not wish to
apply the new preferences, select Cancel.
-
13.1. Defaults
-
There are several headings in the Defaults panel:
+
13.1. General
+
There are several headings in the General panel:
-
+
@@ -4647,7 +4636,7 @@ traditional coordinates (degrees, minutes, seconds) or as decimal degrees
Choose the appropriate option.
-
13.3. Graph
+
13.3. Profile
This panel has three sections:
@@ -4692,7 +4681,7 @@ CCR Options: These options determine oxygen management for CCR dives:
-CCR: Show setpoints when viewing pO2: With this checkbox activated, the pO2
+CCR: Show setpoints when viewing pO2: With this checkbox activated, the pO2
graph on the dive profile has an overlay in red which indicates the CCR setpoint
values. See the section on Closed Circuit Rebreather dives.
@@ -4738,7 +4727,7 @@ CCR Options: These options determine oxygen management for CCR dives:
-Bühlmann: Set the gradient factors (GFlow and GFHigh) for calculcating the deco ceiling following
+Bühlmann: Set the gradient factors (GFLow and GFHigh) for calculcating the deco ceiling following
the ZH-L16 algorithm. GF_Low is the gradient factor at depth and GF_High is used at the surface.
At intermediate depths gradient factors between GF_Low and GF_High are used.
Gradient factors add conservatism to nitrogen and helium exposure during a dive, in a
@@ -4747,7 +4736,7 @@ Bühlmann: Set the gradient factors (GFlow and GFHigh) for calculcating
respect to inert gas loading and the deeper the ceilings are. Gradient
factors of 20/60 are considered conservative and values of 70/90 are considered
harsh.
- In addition decide whether to check the GFLow at max depth box. If checked, GF_Low is used for the
+ In addition decide whether to check the GFLow at max. depth box. If checked, GF_Low is used for the
deepest dive depth and linearly increased up to the GF_High value at the surface. If unchecked,
GF_Low is used between the deepest dive depth and the first deco stop, after which the
gradient factor linearly increases up to the GF_High value at the surface. For more information see:
@@ -4826,15 +4815,13 @@ combination from the list of locations. The Filter text box
to list similar languages. For instance there are several system variants of English
or French. This particular preference requires a restart of Subsurface to take
effect.
-
In this section also specify appropriate date an time formats for showing dive details.
+
In this section also specify appropriate date and time formats for showing dive details.
13.5. Network
This panel facilitates communication between Subsurface and data sources on the Internet.
This is important, for instance, when Subsurface needs to communicate with web
-services such as Cloud storage or the Subsurface Companion app. These Internet requirements are determined by your type of
-connection to the Internet and by the Internet Service Provider (ISP) used.
-Your ISP should provide the appropriate information.
+services such as Cloud storage, the
Subsurface Companion app or when you want to communicate through a proxy.
@@ -4844,7 +4831,7 @@ Your ISP should provide the appropriate information.
-
-Proxy type:
+Proxy:
If a proxy server is used for Internet access, the type of proxy needs to be selected from the dropdown list,
after which the IP address of the host and the appropriate port number should
be provided. If the proxy server uses authentication, the appropriate userID and
@@ -4906,7 +4893,7 @@ or City/State/Country (see image below).
Dive planning is an advanced feature of Subsurface, accessed by selecting
Log → Plan Dive from the main menu. It allows calculation of
inert gas load during a dive by using the Bühlmann ZH-L16 algorithm with the addition
-of gradient factors as implemented by Erik Baker.
+of gradient factors as implemented by Erik Baker, or using the VPM-B model.
c) Gas management: With open-circuit dives this is a primary
consideration. Divers need to keep within the limits of the amount of
@@ -5238,7 +5226,21 @@ The planner calculates the total volume of gas used during the dive and issues a
if you exceeds the total amount of gas available. Good practice demands that divers not dive to
the limit of the gas supply but that an appropriate reserve is kept
for unforeseen circumstances.
-For technical diving, this reserve can be up to 66% of the total available gas.
+For technical diving, this reserve can be up to 66% of the total available gas.
+In addition to calculating the total gas consumption for every cylinder the planner provides one way
+of calculating the recommended volume of bottom gas which is needed for safe asscent to the
+first deco gas change depth or the surface. This procedure is called the "minimum gas" or "rock bottom"
+consideration and it is used by various (but not all)
+technical diving organisations. The calculation assumes that in worst case an out of gas (OoG)
+situation could occur at the end of the planned bottom time at maximum depth. This OoG event forces
+the buddy team the share the gas of one diver and to stay at maximum depth for an additional
+time of n minutes (preferences option "problem solving time").
+At the same moment the combined SAC of both divers is increased by a estimated factor (preferences option
+"SAC factor") compared to the SAC factor of a single diver under normal conditions.
+The result of the minimum gas calculation for the bottom gas is printed to the planner output as an
+additional information. No automatic checks are performed based on this result.
+Please take care that the feature only gives valid results for simple, rectengular shaped single
+level dive profiles. For multi level dives one would need to check every leg of the profile independently.
Now you can start the detailed time-depth planning of the dive. Subsurface offers an unique
graphical interface for doing planning. The mechanics are
similar to hand-entering a dive profile in the dive log part of Subsurface. Upon activating the
@@ -5254,21 +5256,18 @@ above the dive profile changes from BLUE to RED.
left of the dive planner panel. Ensure the
Used Gas value in each row
of that table corresponds to one of the gas mixtures specified in the
Available Gases table.
Add new waypoints until the main features of the dive have been completed, e.g. the
-bottom time segment and deep stops (if these are implemented). Leave the remaining
-waypoints on the ascent to
Subsurface. In most cases
Subsurface
+bottom time segment and deep stops (if these are implemented). In most cases
Subsurface
computes additional way points in order to fulfill decompression requirements for that
-dive. A waypoint can be moved by selecting it and by using the arrow keys.
+dive. A waypoint can also be moved by selecting it and by using the arrow keys.
The waypoints listed in the
Dive Planner Points dialogue can be edited by hand in
order to get a precise presentation of the dive plan. In fact, it is sometimes more easy to create the
whole dive profile by editing the
Dive Planner Points dialog.
Show any changes in gas cylinder used by indicating gas changes as explained
in the section hand-creating a dive profile. These changes should
reflect the cylinders and gas compositions defined in the table with Available Gases.
-If two or more gases are used, automatic gas switches will be suggested during the ascent to
-the surface. These changes can be deleted by right-clicking the gas change and
-manually creating a gas change by right-clicking on the appropriate
-waypoint.
-
A non-zero value in the "CC set point" column of the table of dive planner points
+If two or more gases are used, automatic gas switches will be planned during the ascent to
+the surface.
+
A non-zero value in the "CC setpoint" column of the table of dive planner points
indicates a valid setpoint for oxygen partial pressure and that the segment
is dived using a closed circuit rebreather (CCR). If the last manually entered
segment is a CCR segment, the decompression phase is computed assuming the diver
@@ -5276,11 +5275,11 @@ uses a CCR with the specified set-point. If the last segment (however
short) is on open circuit (OC, indicated by a zero set-point) the
decompression is computed in OC mode and the planner only considers gas
changes in OC mode.
-
Below is an example of a dive plan to 45m using EAN26, followed by an ascent using EAN50
-and using the settings as described above.
+
Below is an example of a dive plan to 45m using Tx21/35, followed by an ascent using EAN50
+and oxygen and using the settings as described above.
-
+
Once the above steps have been completed, save by clicking the Save button
@@ -5304,14 +5303,16 @@ the transitions are shown separately from the segment durations at a particular
14.3. Planning pSCR dives
To plan a dive using a passive semi-closed rebreather (pSCR), select pSCR rather than
Open circuit in the dropdown list.
-The parameters of the pSCR dive can be set by selecting File → Preferences → Graph
+The parameters of the pSCR dive can be set by selecting File → Preferences → Profile
from the main menu, where the gas consumption calculation takes into account the pSCR dump
ratio (default 1:10) as well as the metabolic rate. The calculation also takes the oxygen drop
accross the mouthpiece of the rebreather into account. If the
pO2 drops below what is considered safe, a warning appears in the Dive plan
-details. A typical pSCR configuration is with a single cylinder and one or more bail-out
-cylinders. Therefore the setup of the Available gases and the Dive planner points tables
-are very similar to that of a CCR dive plan, described below. However, no oxygen setpoints
+details. A typical pSCR cylinder setup is very similar to an open circuit dive;
+one or more drive cilinders, possibly with different bottom and decompression
+gasses, including gas switches during the dive like in open circuit diving.
+Therefore, the setup of the Available gases and the Dive planner points tables
+are very similar to that of a open circuit dive plan, described above. However, no oxygen setpoints
are specified for pSCR dives. Below is a dive plan for a pSCR dive. The dive is comparable
to that of the CCR dive below, but note the longer ascent duration due to the lower oxygen
in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment.
@@ -5328,7 +5329,7 @@ list, circled in blue in the image below.
Available gases: In the Available gases table, enter the cylinder information for the
diluent cylinder and for any bail-out cylinders. Do NOT enter the information for the oxygen
cylinder since it is implied when the CCR dropdown selection is made.
-
Entering setpoints: Specify a default setpoint in the Preferences tab, by selecting File → Preferences → Graph from
+
Entering setpoints: Specify a default setpoint in the Preferences tab, by selecting File → Preferences → Profile from
the main menu. All user-entered segments in the Dive planner points table
use the default setpoint value. Then, different setpoints can be specified for dive segments
in the Dive planner points table. A zero setpoint
@@ -5381,11 +5382,7 @@ planner: the planner takes into account the configuration in the highlighted div
Selecting the Print button in the planner allows printing of the Dive Plan Details
for wet notes. You can also cut and paste the Dive Plan Details to
include in a text file or word processing document.
-
Dive plans have many characteristics in common with dive logs (dive profile, dive notes, etc).
-After a dive plan has been saved, the dive details and gas calculations are saved in
-the Notes tab. While a dive plan is being designed, it can be printed using
-the Print button in the dive planner. This prints the dive details and gas calculations
-in the Dive Plan Details panel of the dive planner. However, after the plan has been saved, it is
+
However, after the plan has been saved, it is
represented in a way very similar to a dive log and the gas calculations cannot be
accessed in the same way as during the planning process. The only way to print the
dive plan is to use the File → Print function on the main menu in the
@@ -5478,7 +5475,7 @@ cellspacing="0" cellpadding="4">
--version |
-Prints the current version of Subsurface. |
+Prints the current version of Subsurface |
--survey |
@@ -5496,6 +5493,10 @@ cellspacing="0" cellpadding="4">
--win32console |
Create a dedicated console if needed (Windows only). Add this option before everything else |
+
+--win32log |
+Write the program output to subsurface.log (Windows only). Add option before everything else |
+
@@ -5759,7 +5760,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.
Check for updates - Find out whether a newer version of Subsurface is available
- on the Subsurface web site.
+ on the Subsurface web site.
@@ -5816,7 +5817,7 @@ On a Mac users sometimes have to manually hunt for the correct
devices or any other dive computer using a USB-to-serial interface
based on the Silicon Labs CP2101 or similar chip can be found as
Mac_OSX_VCP_Driver.zip at the
-Silicon Labs document and software repository.
+Silicon Labs document and software repository.
@@ -6028,7 +6029,7 @@ environment of the operating system. After setting the dive computer to upload m
and select
Add new device. The dive computer should appear. If asked for a password, enter 0000.
Write down or copy the MAC address of your dive computer - this needed later and should be in the form 00:11:22:33:44:55.
If the graphical method doesn’t work, pair the device from the command line. Open a terminal
-and use hciconfig to check the Bluetooth controller status
+and use
hciconfig to check the Bluetooth controller status.
$ hciconfig
@@ -6053,7 +6054,7 @@ hci0: Type: BR/EDR Bus: USB
TX bytes:449 acl:0 sco:0 commands:46 errors:0
Check that the status now includes UP, RUNNING AND AUTH.
-
If there are multiple controllers running, it’s easiest to off the unused controller(s). For example, for hci1:
+
If there are multiple controllers running, it’s easiest to turn off the unused controller(s). For example, for hci1:
sudo hciconfig hci1 down
@@ -6094,7 +6095,7 @@ Scanning ...
00:11:22:33:44:55 Petrel
bluez-simple-agent hci0 00:11:22:33:44:55
-
Once ther dive computer is pired, set up the RFCOMM connection
+
Once the dive computer is paired, set up the RFCOMM connection.
Establishing the RFCOMM connection
@@ -6275,7 +6276,7 @@ for every dive.
Mark all the dives you’d like to import or open.
Note: The DR5 does not seem to store gradient factors nor deco information, so
for
Subsurface it is not possible to display them. Adjust the gradient
-factors in the
Graph Settings in
Subsurface to generate a deco overlay in the
+factors in the
Profile Settings in
Subsurface to generate a deco overlay in the
Subsurface Dive Profile panel but please note that the deco calculated by
Subsurface will most likely differ from the one displayed on the DR5.
@@ -6292,7 +6293,7 @@ factors in the
Graph Settings in
Subsurface to generate a deco
When mounted as a USB drive UDDF files are available in LOGBOOK directory.
Note: The xDEEP BLACK saves NDL time but does not seem to store gradient factors nor deco information, so
for
Subsurface it is not possible to display them. Adjust the gradient
-factors in the
Graph Settings in
Subsurface to generate a deco overlay in the
+factors in the
Profile Settings in
Subsurface to generate a deco overlay in the
Subsurface Dive Profile panel but please note that the deco calculated by
Subsurface will most likely differ from the one displayed on the xDEEP BLACK.
@@ -6389,7 +6390,7 @@ Open a text editor, e.g. Notepad (Windows) or TextWrangler (Mac).
Copy the contents of the clipboard into the text editor and save the text file
- with a filename extension of .apd
+ with a filename extension of .apd.
@@ -6473,7 +6474,7 @@ dive log software. The procedures below mostly apply to Linux and/or Windows.
-DiveManager is a MS Windows application for Suunto dive computers.
+ | DiveManager is a Windows application for Suunto dive computers.
Divemanager 3 (DM3) is an older version of the Suunto software. More recent
Suunto dive computers use Divemanager version 4 or 5 (DM4 or DM5). The
different versions of Divemanager use different methods and different file naming
@@ -6642,7 +6643,7 @@ The dives are now exported to the file DM4.bak (or DM5.bak)
|
|
-Atomic Logbook is a Windows software by Atomic Aquatics. It allows
+ | Atomic Logbook is Windows software by Atomic Aquatics. It allows
downloading of dive information from Cobalt and Cobalt 2 dive computers.
The divelog is kept in a SQLite database at
C:\ProgramData\AtomicsAquatics\Cobalt-Logbook\Cobalt.db. This file can
@@ -6754,7 +6755,7 @@ according to which spreadsheet program is used.
Organize the diving data in the spreadsheet, so the first row
contains the names (or titles) of each column and the information for each dive is stored in a single row.
Subsurface supports many data items (Dive number, Date,
-Time, Duration, Location, GPS, Max Depth, Mean Depth, Buddy, Notes, Weight and Tags).
+Time, Duration, Location, GPS, Max. Depth, Mean Depth, Buddy, Notes, Weight and Tags).
Organize dive data following a few simple rules:
-
@@ -6823,7 +6824,7 @@ Open the Regional and Language Options dialog box.
-
-Do one of the following:
+Do the following:
-
@@ -6940,7 +6936,7 @@ dialogue to save the new template using a new template name.
Additional information about Grantlee can be found at here Additional information about Grantlee can be found here
21.2. Grantlee exported variables
@@ -6987,7 +6983,7 @@ cellspacing="0" cellpadding="4">
divemaster |
-(string) dive master for the dive |
+(string) divemaster for the dive |
buddy |
@@ -7172,7 +7168,7 @@ cellspacing="0" cellpadding="4">
21.3. Defined CSS selectors
- As the dive profile is placed after rendering, Subsurface uses special CSS selectors to searche
+ As the dive profile is placed after rendering, Subsurface uses special CSS selectors to search
in the HTML output. The CSS selectors in the following table should be added. | 
+
+