diff --git a/Documentation/user-manual.html.git b/Documentation/user-manual.html.git index b81684a7f..a0e375cd4 100644 --- a/Documentation/user-manual.html.git +++ b/Documentation/user-manual.html.git @@ -445,7 +445,7 @@ asciidoc.install(3);

Manual authors: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg, Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Pedro Neves, Stefan Fuchs

-

Version 4.6, March 2017

+

Version 4.7, October 2017

Welcome as a user of Subsurface, an advanced dive logging program with extensive infrastructure to describe, organize, interpret and print scuba and free dives. Subsurface offers many advantages over other similar @@ -1044,9 +1044,16 @@ as well as contextual information about the dives recorded on the dive computer.

5.2.2. Connecting Subsurface to a Bluetooth-enabled dive computer

Bluetooth is becoming a more common way of communication between dive computers -and Subsurface, for or instance, the Shearwater Petrel -Mk2 and the OSTC Mk3. Subsurface provides a largely operating system independent -Bluetooth interface. Setting up Subsurface for Bluetooth communication requires +and Subsurface. Subsurface provides a largely operating system independent +Bluetooth interface. An increasing number of dive computers use Bluetooth Low Energy (BTLE) +as a means of communication. However, BTLE is not a standardised protocol, +consequently adaptations need to be made for communicating with each different dive computer model. See the +list of supported dive computers. +Bluetooth communication is often more reliable if all Bluetooth devices seen by the +Subsurface computer are removed and pairing with the Bluetooth dive computer +is performed from afresh. The Bluetooth and BTLE interfaces are under active development +with respect to new dive computers that use this mechanism of communication.

+

Setting up Subsurface for Bluetooth communication requires four steps:

  • @@ -1080,11 +1087,13 @@ box labelled "Choose Bluetooth download mode", the dialogue below appea FIGURE: Download Bluetooth
+

Although the Subsurface Bluetooth interface is intended to function without +Bluetooth pairing at the operating system level, it is always prudent to follow up +initial Bluetooth pairing problems by pairing the Bluetooth dive computer with the Subsurface computer using the operating system services of the desktop computer. Delete all +existing pairings and start by scanning for Bluetooth devices from an empty list (on the desktop) of Bluetooth devices. Once Subsurface has recognised the Bluetooth dive +computer, subsequent divelog downloads are likely to be simple.

On the Linux or MacOS platforms the name -of the Subsurface computer and its Bluetooth address are shown on the right hand side, -On the left hand side, if the -computer has connected more than one local Bluetooth devices you can use -the list box to indicate which one needs to connect to Subsurface. +of the Subsurface computer and its Bluetooth address are shown on the right hand side. The power state (on/off) of the Bluetooth adapter is shown below the address and can be changed by checking the Turn on/off box. If the Bluetooth address is not shown, then Subsurface does not see the local @@ -1100,8 +1109,12 @@ searching, the dive computer should be listed lefthand side of the dialogue (see image above). If this does not work, select the Clear button, then scan again for Bluetooth devices using the Scan button. After taking these actions Subsurface should see the dive computer. +On the left hand side, if the +computer has more than one local Bluetooth devices connected, use +the list box to indicate which one needs to connect to Subsurface. The label of the discovered dive computer contains the name of the device, its -address and its pairing status. If the device is not paired and has a red +address and its pairing status. For BTLE devices the address often starts with "LE". +If the device is not paired and has a red background color, a context menu can be opened by selecting the item with a right-click. Select the the Pair option and wait for the task to complete. If this dive computer @@ -1278,53 +1291,40 @@ divemaster, buddy, protective gear, notes about the dive) by selecting Apply textbox labelled Location on the Notes tab.

-

Type in the name of the dive site, e.g. "Tihany, Lake Balaton, Hungary". +

Using existing dive locations: Type in the name of the dive site, e.g. "Tihany, Lake Balaton, Hungary". If several dives are made at the same location, the site information for the first dive is re-used. -Existing dive locations -can be edited by selecting (on the Dive List panel) a dive done at that site -and by opening the location information. Click the globe button on the -right of the location name (see image image A below). -When typing the name of a dive site, -a dropdown list appears showing all sites with similar names. If the dive -site has been used before, click on the already-existing name. -The dive site names in the dropdown list contain either a globe symbol (indicating -existing dive sites in the Subsurface database) -or a + symbol (indicating dive site names that appear consistent with the -current dive site name but which haven’t been added to the dive site database). -If the present -dive site has not been used before, a message appears as follows (image A below):

+Therefore, if a dive site has been used before, the name of that site (and sometimes +the names of similar sites) appears below the dive site text box (image below). Double-click on +the appropriate dive site name and the dive location will be associated with the +dive being entered. Then select Apply Changes (image below) to save the geolocation for this dive site.

-FIGURE:Location description panel +FIGURE:Location choice panel
-

Click the globe button and a panel appears to enter the coordinates and -other information about the site (image B, above). The most important -items are the coordinates of the site. There are three ways to specify coordinates:

-
    -
  1. -

    -Use the world map in the bottom right hand part - of the Subsurface window. The map displays an orange bar indicating "No location - data - Move the map and double-click to set the dive location". Doubleclick - at the appropriate place, and the orange bar disappears and the coordinates are - stored. -

    -
    2. -
  2. -

    -Use eiher the Subsurface-Mobile App or the Subsurface Companion App on an - Android or iPhone device with GPS and if the dive site coordinates - were stored using one of these apps. - Click here for more information -

    -
    3. -
  3. -

    -Enter coordiantes by hand if they are known, using one of - four formats with latitude followed by longitude: -

    +

    Entering a new dive location: On the other hand, having dived at a new dive location, +a new record needs to be created +that could be used for the new and for later dives at this new site. Type the name of the new dive site into the text box +(image A below).

    +
    +
    +FIGURE:Location creation panel +
    +
    +

    Double-click on the blue bar below the new dive location name. The blue bar disappears (image B above) and +the globe icon on the right-hand of the location name text box turns blue. In the Dive Map part of the Subsurface window, a world map appears (image C above). Click on the +blue globe icon to the right of the dive site name in the Notes panel (image B above). This opens a window for entering the details of the new dive location (image A below). +The globe icon changes to indicate that the location data are being edited. The only important +data here are the geographic coordinates of the dive location.

    +
    +
    +FIGURE:Location creation panel +
    +
    +

    There are three ways of adding the the coordinates:

    +

    (1): Enter coordinates by hand if they are known, using one of + four formats with latitude followed by longitude:

    ISO 6709 Annex D format e.g. 30°13'28.9"N 30°49'1.5"E
@@ -1332,15 +1332,36 @@ Degrees and decimal minutes, e.g. N30° 13.49760' , E30° 49.30788'
 Degrees minutes seconds, e.g. N30° 13' 29.8" , E30° 49' 1.5"
 Decimal degrees, e.g. 30.22496 , 30.821798
    -
    4. -

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 W, e.g. W07°, or with a negative value, e.g. -7.34323. Some keyboards don’t have the degree sign (°). It can be replaced by a d like this: N30d W20d. -If both a dive site name and coordinates have been provided, save the -dive site information by selecting the button Apply changes at the top of -the panel.

+Enter any other contextual information about the dive site (Description and Notes), +then select Apply Changes to save the geolocation for this dive site. +The dive site information can later be edited by clicking the globe icon to the right of the +dive site name in the Notes tab.

+

(2): Use the Dive Map to specify the coordinates. The Dive map now shows +all the existing dive lications in grey as well as an additional marker in red +(image B above). Drag the red marker to the location of the dive site being entered. +The map can be dragged and zoomed using the mouse wheel. Position the red marker +by dragging it on the map, zooming in on the appropriate part of the map and placing +the marker at an appropriate position (image B below). The coordinates of the dive +location are automatically inserted into the appropriate text box in the dive location +information window (image A below). Enter any other contextual information about the dive site (Description and Notes), +then select Apply Changes to save the geolocation for this dive site. +The dive site information can later be edited by clicking the globe icon to the right of the +dive site name in the Notes tab.

+
+
+FIGURE:Location creation panel +
+
+

Once the dive location data have been saved, the dive on the Dive List has +a globe icon immediately to the left of the location name of a particular dive.

+

(3): Use eiher the Subsurface-Mobile App or the Subsurface Companion App on an + Android or iPhone device with GPS and if the dive site coordinates + were stored using one of these apps. + Click here for more information

Important: GPS coordinates of a dive site are linked to the location name - so saving a dive site with only coordinates and no name causes problems. (Subsurface will think all of these @@ -1349,7 +1370,7 @@ same).

Dive site name lookup: If you typed coordinates into the appropriate text box, you can do an automated name lookup based on the coordinates. This is done when Subsurface uses the Internet to find the name of the dive site -based on the coordinates that were typed. If a name has been found, it is +based on the coordinates that were given. If a name has been found, it is automatically inserted into the tags box. The list box (Titled Dive sites on same coordinates") at the bottom of the dive site panel contains the names of other dives sites used at the @@ -1764,12 +1785,13 @@ core application.

generated by SmartTrak to Subsurface’s .xml format. It can be built together with Subsurface for Linux systems. Two dependencies need to be installed in your system before building: libglib2.0 and libmdb2.

+

In addition, a web service is available for divelog convertions from SmartTrak to Subsurface (see below).

Feel free to contact the Subsurface development team on our mailing list for assistance in importing SmartTrak dive logs.

-

Assuming the above dependencies -have been installed and the Subsurface source tree is in the directory ~/src/subsurface, then:

Building smtk2ssrf
+

Assuming the above dependencies +have been installed and the Subsurface source tree is in the directory ~/src/subsurface, then:

  • @@ -1837,6 +1859,21 @@ relevant as support for Galileo family of dive computers is still a work in progress.

+
For the lazy: a web service to convert SmartTrak to Subsurface
+

Open the website at:

+

https://thetheoreticaldiver.org/rch-cgi-bin/smtk2ssrf.pl

+

This is a no-frills +web service for converting SmartTrak dive logs to Subsurface. Select the browse button. This allows +you to browse your computer directories and to select the SmartTrak divelog to be converted. Once it has been selected, +click the Submit query button. After a short while, a dialog box appears (image below) for saving the converted file to +the local computer.

+
+
+FIGURE:Web service to convert SmartTrak divelog +
+
+
+
Merging the imported dives with the existing divelog

Open the new file (generated in the previous steps) using Subsurface and check the dives and data. If everything is fine, close the .xml file and open your regular divelog. @@ -2073,7 +2110,7 @@ automatically collecting dive site coordinate information.

2) Uploading the coordinates from the mobile device to the Subsurface Internet server.

3) Syncronising the dives in the Subsurface dive list with the coordinates stored on the Subsurface Internet server.

-

_Subsurface has two tools for achieving this:

+

Subsurface has two tools for achieving this:

  • @@ -2815,13 +2852,21 @@ for decompression.

FIGURE: Multicylinder profile
+

Several dive computers perform automatic recording of cylinder pressure. In this case no manual intervention is needed. +Older dive computers (e.g. Uwatec Galileo, several Suunto models) handle more than one pressure transducer on cylinders, +switching from one sensor to another as the diver switches among cylinders and providing a sequential record of cylinders pressures during a dive. Some of the latest models (e.g. Shearwater Perdix AI, Scubapro G2) record two or more pressure transducers concurrently and continuously during the whole dive. In these cases Suburface correctly interprets the data. +There is continuous effort within the _Subsurface development team to add new dive computer models to those that can be +downloaded from and to represent cylinder pressures correctly. Regardless of the type of sensor handling of dive computers, technical divers are likely to use both automated and manual methods of cylinder pressure logging when more than two gases are used. However, +automated recording of cylinder pressure simplifies logging of sidemount dives (where two cylinders are used). See the +list of supported dive computers.

5.6.2. Sidemount dives

Sidemount diving is just another form of multi-cylinder diving, often with both or all cylinders having the same gas mixture. Although it’s a popular configuration for cave divers, sidemount -diving can be done by recreational divers who’ve completed the appropriate training. Sidemount -dive logging involves three steps, exactly as with multi-cylinder dives above:

+diving can be done by recreational divers who have completed the appropriate training. See the comments in the +last paragraph, above, about automated recording of cylinder pressures. Manual +logging of cylinder pressures during sidemount involves three steps, exactly as with multi-cylinder dives above:

To log pSCR dives, no special procedures are required. Use the normal steps outlined above:

@@ -2912,26 +2957,30 @@ over two hours.

Note -Closed system rebreathers use advanced technology to recirculate -gas that has been breathed. They also do two things to maintain a +Closed system rebreathers also recirculate +gas that has been breathed. However, they use advanced technology to maintain a breathable oxygen concentration: -a) remove carbon dioxide from the exhaled gas +a) remove carbon dioxide from the exhaled gas. b) regulate the oxygen concentration to remain within safe diving limits. The CCR interface of Subsurface is currently experimental and under active development. Subsurface currently supports Poseidon MkVI -and APD Discovery/Evolution dive computers. In contrast to a conventional recreational -dive computer, a CCR system computer does not allow the download of a log +and APD Discovery/Evolution dive computers, as well as Shearwater dive computers connected +to CCR systems. In contrast to a conventional recreational +dive computer, a CCR system computer usually does not allow the download of a log containing multiple dives. Rather, each dive is stored independently. This means that Subsurface cannot download a dive log directly from a CCR dive computer, but that it imports individual CCR dive profiles in the same way it -imports dive log data from other digital databases: one dive at a time. +imports dive log data from other digital databases: one dive at a time. However, the Shearwater +based CCR systems are different in this respect and allow multi-dive downloads.
Import a CCR dive
-

See the section dealing with Importing dive information from other -digital sources. CCR dive data are currently obtained from the proprietary software -provided when purchasing CCR dice equipment. See Appendix B +

For Shearwater CCR controllers, or independent Shearwater CCR logs, just download the dive log as would +be the case for non-CCR dives. Subsurface interprets the CCR dive lig correctly. +Except for Shearwater CCR dive computers, CCR dive data are currently obtained from the proprietary software +provided when purchasing CCR dice equipment. See the section dealing with Importing dive information from other +digital sources and Appendix B for more complete information. Use that software to download the dive data into a known directory. From the main menu of Subsurface, select Import → Import log files to bring up the universal import dialogue. As @@ -3074,7 +3123,69 @@ Poseidon MkVI and APD equipment can be found in 6. Obtaining more information about dives entered into the logbook

-

6.1. The Info tab (for individual dives)

+

6.1. Using the Dive Map to obtain more dive information

+

The Dive Map has a number of buttons useful for manipulation several aspects of a dive. These are:

+
+ + + +
+Note +Select this button to show the Dive Map as a satellite image or as a Google Maps +representation.
+
+
+ + + +
+Note +Zoom in. Select a smaller area of the map.
+
+
+ + + +
+Note +Zoom out. Select a larger area of the map.
+
+
+
+FIGURE: Map menu +
+
+

The "Hamburger" button on the top right-hand of the Dive Map +activates the Map menu. The items are:

+
    +
  • +

    +Open location in Google Maps. Open the location of the active dive in a separate Google Maps window with the + dive site indicated by a Google Maps teardrop marker. +

    +
    • +
  • +

    +Copy location to clipboard (decimal). Copy the coordinates of the active dive to the clipboard in decimal degrees + e.g. -25.933905 30.710572 +

    +
    • +
  • +

    +Copy location to clipboard (sexagesimal). Copy the coordinates of the active dive to the clipboard in sexagecimal, e.g. 25°56’02.058"S + 30°42’38.059"E +

    +
    • +
  • +

    +Select visible dive locations. In the Dive List panel, highlight all the dive sites visible in the Dive Map. This allows easy + selection of the dives within a particular geographical area to inspect them or to calculate statistics for them. +

    +
    • +
+
+
+

6.2. The Info tab (for individual dives)

The Info tab gives some summary information about a particular dive that has been selected in the Dive List. Useful information here includes the surface interval before the dive, the maximum and mean depths of the dive, the @@ -3093,7 +3204,7 @@ Refer to Appendix F for more information.

-

6.2. The Extra Data tab (usually for individual dives)

+

6.3. The Extra Data tab (usually for individual dives)

When using a dive computer, it often reports several data items that cannot easily be presented in a standardised way because the nature of the information differs from one dive computer to another. These data often comprise setup information, metadata about @@ -3107,7 +3218,7 @@ image showing extra data for a dive using a Poseidon rebreather.

-

6.3. The Stats tab (for groups of dives)

+

6.4. The Stats tab (for groups of dives)

The Stats tab gives summary statistics for more than one dive, assuming that more than one dive has been selected in the Dive List using the standard Ctrl-click or Shift-click of the mouse. If only one @@ -3119,7 +3230,7 @@ water temperature and surface air consumption (SAC). It also shows the depth of shallowest and deepest dives of those selected.

-

6.4. The Dive Profile

+

6.5. The Dive Profile

Typical dive profile @@ -3192,7 +3303,7 @@ increases the size of the dive profile to fill the area of the panel.

Water temperature is shown as a blue line with temperature values placed adjacent to significant changes.

-

6.4.1. The Information Box

+

6.5.1. The Information Box

The Information box displays a large range of information about the dive profile. Normally the Information Box is located to the top left of the Dive Profile panel. The Information Box can be moved around in the Dive Profile @@ -3214,7 +3325,7 @@ and ceiling characteristics of the particular dive. These include: Time period into the dive (indicated by a @), depth, cylinder pressure (P), temperature, ascent/descent rate, surface air consumption (SAC), oxygen partial pressure, maximum operating depth, equivalent air depth (EAD), equivalent narcotic depth -(END), equivalent air density depth (EADD), decompression requirements at that +(END), equivalent air density depth (EADD, also as gas density in g/l), decompression requirements at that instant in time (Deco), time to surface (TTS), the calculated ceiling, as well as of the statistics in the Information Box, shown as four buttons on the left of the profile panel. These are:

@@ -3378,7 +3489,7 @@ Graph E indicates the situation after remaining at 4.5 meters f
-

6.4.2. Computer-reported events during dive

+

6.5.2. Computer-reported events during dive

Many dive computers record events during a dive. For instance, most dive computers report alarms relating to high partial pressures of oxygen, to rapid ascents or the exceeding of no-deco limits (NDL). @@ -3404,7 +3515,7 @@ a small red flag on the profile and are discussed more fully in the section on inserting bookmarks.

-

6.4.3. The Profile Toolbar

+

6.5.3. The Profile Toolbar

The dive profile can include graphs of the partial pressures of O2, N2, and He during the dive (see figure above) as well as a calculated and dive computer reported deco ceilings (only visible for deep, long, or repetitive dives). @@ -3449,6 +3560,9 @@ normalized air consumption during the dive. So areas in red or orange indicate times of increased normalized air consumption while dark green reflects times when the diver was using less gas than average.

+

When in planner mode, the SAC is set to be constant during the bottom part +of the dive as well during decompression. Therefore, when planning a dive, +the color is a representation of the breathing gas density.

-
@@ -3694,7 +3808,7 @@ in slower tissues at the end of the dive.

-

6.4.4. The Dive Profile context menu

+

6.5.4. The Dive Profile context menu

The context menu for the Dive Profile is accessed by right-clicking while the mouse cursor is over the Dive Profile panel. The menu allows creating Bookmarks, Gas Change Event markers, or manual CCR set-point changes @@ -4901,7 +5015,7 @@ of gradient factors as implemented by Erik Baker, or using the VPM-B model.

<
Warning The Subsurface dive planner IS CURRENTLY EXPERIMENTAL +The Subsurface dive planner IS EXPERIMENTAL and assumes the user is already familiar with the Subsurface user interface. It is explicitly used under the following conditions:
@@ -4956,7 +5070,7 @@ the dive plan are provided in a way that can easily be copied to other software. any warning messages about the dive plan are printed.

-FIGURE: Dive planner startup window +FIGURE: Dive planner startup window
@@ -5149,8 +5263,7 @@ under Available gases. If the initial cylinder pressure is set to 0, th true no-deco limit (NDL) without taking into account gas used during the dive. If the surface above the dive profile is RED it means that recreational dive limits are exceeded and either the dive duration or the dive depth needs to be reduced.

Below is an image of a dive plan for a recreational dive at 30 meters. Although the no-deco limit (NDL) is 23 -minutes, the duration of the dive is limited by the amount of air in the cylinder. That is shown in the -text box at the bottom right of the panel, requiring sufficient air for buddy-sharing during ascent.

+minutes, the duration of the dive is limited by the amount of air in the cylinder.

FIGURE: A recreational dive plan: setup @@ -5177,6 +5290,16 @@ This model tends to give deco stops at deeper levels than the Bühlmann model an dive durations than the Bühlmann model, albeit at the cost of higher tissue compartment pressures in the slow tissues. When selecting one of these models, keep in mind they are NOT exact physiological models but only mathematical models that appear to work in practice.

+

Please note as well that there is an intrinsic assumption of the VPM-B +model that off-gassing only happens during the ascent phase of the +dive (which is the part controlled by the planner). Thus it is +possible to get misleading results if you manually enter waypoints +well in the decompression phase of your dive. This is particularly +relevant when editing a dive read from disk in the planner since that +will have waypoints up to the surface. Thus for those dives, first +delete all waypoints during the ascent phase. This is most easily done by +holding the Ctrl- or Command-key while clicking on the trash can icon +next to the first ascent waypoint in the table on the left hand side.

For more information external to this manual see:

  • @@ -5231,21 +5354,12 @@ In addition to calculating the total gas consumption for every cylinder the plan 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.

+technical diving organisations. See the text below for a detailed explanation.

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 -planner, a default dive of depth 15 m for 20 min is offered in the blue design surface to the top -right hand of the screen. The white dots (waypoints) on the +planner, a default dive of depth 15 m for 20 min is offered in the blue design surface in the top +right hand part of the planner window. The white dots (waypoints) on the profile can be dragged with a mouse. Create more waypoints by double-clicking on the profile line and ensuring the profile reflects the intended dive. Drag the waypoints to represent the depth and duration of the dive. It is NOT necessary to specify the ascent part of the dive @@ -5267,7 +5381,12 @@ in the section hand-creating a dive profile. Thes 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 planned during the ascent to the surface.

-

A non-zero value in the "CC setpoint" column of the table of dive planner points +

Cylinders used for the plan need to be entered in the table of Available gases. In the column +Type select the appropriate cylinder size by using the dropdown list that appears when +double-clicking a cell in this column. By default, a large number of sizes are listed, +and a new cylinder size can be created by typing this into the text box. The cylinder size, start pressure +and default switch depths are initialised automatically. Specify the gas composition +(e.g. helium and oxygen content). 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 @@ -5275,19 +5394,33 @@ 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 Tx21/35, followed by an ascent using EAN50 -and oxygen and using the settings as described above.

+

Enter dive profile segments in the Dive planner points table by providing a time duration for +a segment as well as its final depth. If more than one cylinder is used during the dive, ensure that +the appropriate cylinder is selected for each segment of the dive plan by double-clicking the +cell and selecting the appropriate cylinder from the dropdown list in the Used gas column. +If required, insert a row in the Dive planner points table by adding a new line and then setting the +Run time value appropriately. In image A below, a segment (using an EAN50 cylinder) has been added and +you wish to use this gas during the very start of the dive (the other gas is not breathable at the surface). +Upon pressing Enter on the keyboard, that segment is moved to the top of that table and the plan is adjusted +automatically to take into account this new segment of the dive plan (image B below).

-FIGURE: Planning a dive: setup +FIGURE: Planning a dive: segments +
+
+

Below is an example of a dive plan to 55m using Tx20/30 and the Bühlmann algorithm, +followed by an ascent using EAN50 and using the settings as described above.

+
+
+FIGURE: Planning a dive: setup

Once the above steps have been completed, save by clicking the Save button towards the top middle of the planner. The saved dive plan will appear in the Dive List panel of Subsurface.

The dive plan details

-

On the bottom right of the dive planner, under Dive Plan Details, the exact details -of the dive plan are provided. These details may be modified by checking any of the +

On the bottom right of the dive planner, under Dive Plan Details, the details +of the dive plan are provided. These may be modified by checking any of the options under the Notes section of the dive planner, immediately to the left of the Dive Plan Details. If a Verbatim dive plan is requested, a detailed sentence-level explanation of the dive plan is given. If any @@ -5297,6 +5430,113 @@ message is printed underneath the dive plan information.

level is indicated in the Dive Plan Details. This duration INCLUDES the transition time to get to that level. However, if the Display transition in deco option is checked, the transitions are shown separately from the segment durations at a particular level.

+

The planner has a check box Display plan variations. By checking this box, the planner +provides information about a dive that is a little deeper or slightly +longer than the planned dive. This can be found near the top of the Dive plan details +where the dive duration is indicated. Checking this option creates a lot of additional computation, +to such a degree that the planner is slower than otherwise. The information is typically +given as:

+
+
+
Runtime: 53min + 0:52/m + 4:21/min
+
+

This indicates:

+
    +
  • +

    +Calculated dive duration is 53 min. +

    +
    • +
  • +

    +For each extra meter in depth during the bottom phase of the dive, the duration increases by 52 seconds. +

    +
    • +
  • +

    +For each extra minute of bottom time, the duration increases by 4 min 21 sec. Thus, if the bottom time is + two minutes longer than planned, the dive duration will be (2+2*4min 21 sec) = 10 minutes 42 sec longer and + would probably require that each deco stop is 10:42/53:00 = 20% longer than planned. These calculations + are only applicable for small deviations from the dive plan, not for larger deviations. +

    +
    • +
  • +

    +Minimum gas requirements* +

    +
    • +
+

The planner also estimates the minimum gas pressure required for safe ascent after an event that causes the dive +to be aborted. 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 +number of minutes. +At the same moment the combined SAC of both divers is increased by a estimated 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. No automatic checks are performed based on this result. +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.

+

There are two selector boxes on the left of the Dive plan details:

+
    +
  • +

    +SAC factor. This is your estimate of the degree to which your SAC increases if a critical problem arises underwater, + e.g. gas sharing or entanglement. Realistic values range from 2 to 5, reflecting the gas use of two divers sharing + a single gas cylinder after an OoG situation. +

    +
    • +
  • +

    +Problem solving time. This is your estimate of how long you would take to solve the problem before starting the ascent + to terminate the dive. The default value is 2 minutes. +

    +
    • +
+

Using the above information, the planner then estimates what the minimum botoom gas cylinder pressure needs to be for a +safe ascent. This information is given near the bottom of the Dive plan details, following the calculation of +bottom gas used during the dive if it exactly follows the plan. the minimum gas is typically given as:

+
+
+
Minimum gas (based on 2.0xSAC/+1min@81m): 2130 l/90bar/Δ:+80bar
+
+

This indicates:

+
    +
  • +

    +Within parentheses, the SAC factor and Problem solving time specified. +

    +
    • +
  • +

    +The number of liters of back gas required for a safe ascent (2130 litres in the example above) +

    +
    • +
  • +

    +The number of bars of back gas required for a safe ascent (90 bars in the example above). +

    +
    • +
  • +

    +The delta-value: number of bars of back gas available at the end of the bottom section of the dive, over and above the minimum + gas requirement (80 bars in the above example). A positive delta reflects a safe plan; a negative delta indicates insufficient gas for a + safe ascent. +

    +
    • +
+
+
+
+ + + +
+Warning +The plan variations and minimum gas estimates are only guidelines for a diver performing dive planning, intended to +enhance the safety of executing a particular dive plan. They are NOT precise +and should NOT be relied upon as the only safety features in dive planning. Interpret these esimates +within the framework of your formal training to perform dive planning.
+
+
@@ -5318,7 +5558,7 @@ to that of the CCR dive below, but note the longer ascent duration due to the lo in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment.

-FIGURE: Planning a pSCR dive: setup +FIGURE: Planning a pSCR dive: setup
@@ -5341,7 +5581,7 @@ this is calculated for bail out ascents.

The dive profile for a CCR dive may look something like the image below.

-FIGURE: Planning a CCR dive: setup +FIGURE: Planning a CCR dive: setup

Note that, in the Dive plan details, the gas consumption for a CCR segment is not calculated, @@ -6781,10 +7021,11 @@ Tags and buddies: values should be separated using a comma.

  • GPS position: use decimal degrees, e.g. 30.22496 30.821798 -=== LibreOffice Calc and OpenOffice Calc

    • +
    +

    20.1. LibreOffice Calc and OpenOffice Calc

    These are open source spreadsheet applications forming parts of larger open source office suite applications. The user interaction with LibreOffice and OpenOffice is very similar. In Libreoffice Calc the time format should be set to minutes:seconds - [mm]:ss and dates should be set to one of: yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy. A typical dive log may look like this:

    @@ -6805,8 +7046,9 @@ In Libreoffice Calc the time format should be set to minutes:seconds - [mm]:ss a

    Double check the .CSV file by opening it with a text editor, and then import the dive data as explained on the section Importing CSV dives.

    +
    -

    20.1. Microsoft Excel

    +

    20.2. Microsoft Excel

    The field delimiter (called "list separator" in Microsoft manuals) is not accessible from within Excel and needs to be set through the Microsoft Control Panel. After changing the separator character, all software on the Windows machine uses the new character as a separator. @@ -7320,7 +7562,7 @@ cannot be salvaged after being overwritten by new dives.