diff --git a/Documentation/user-manual.html.git b/Documentation/user-manual.html.git index 1a28417a2..c501dbd9f 100644 --- a/Documentation/user-manual.html.git +++ b/Documentation/user-manual.html.git @@ -17,7 +17,7 @@ */ * { padding: 0; margin: 0; } -img { border: 0; } +img { border: 0; margin: 15px; } /*** Layout ***/ @@ -446,66 +446,10 @@ 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.9, July 2019

+

Version 4.9, April 2020

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 -software solutions:

-
-

Subsurface binaries are available for Windows PCs (Win 7 or later from +and free dives. Subsurface binaries are available for Windows PCs (Win 7 or later from version 4.6 of Subsurface onwards), Intel based Macs (OS/X) and many Linux distributions. Subsurface can be built for many more hardware platforms and software environments where Qt and @@ -569,22 +513,7 @@ option reloads the complete user manual into the window.

-

2. The user survey

-
-

In order to develop Subsurface to serve its users in the best possible way, -it’s important to have user information. Upon launching Subsurface -and using the software for a week or so, a one-box user survey pops up. It is entirely -optional and the user controls what, if any, data are sent to the Subsurface development -team. All data the user sends is useful, and will only be -used to steer future development and to customize the software to fit the needs of -the Subsurface users. If you complete the survey, or click the option not to -be asked again, that should be the last communication of this type you receive. -However, if your diving and/or subsurface habits change and you wish to fill in -another survey, just launch Subsurface with the --survey option on the command line.

-
-
-
-

3. Start Using the Program

+

2. Start Using the Program

The Subsurface window is usually divided into four panels with a Main Menu (File Edit Import Log View Help) at the top of the window (for Windows @@ -643,7 +572,7 @@ temperatures and SAC; total time and number of dives selected).

Profile: Show only the Dive Profile of the selected dive.

Info: Show only the Notes about the last selected dive and statistics for all highlighted dives.

-

Globe: Show only the world map, centered on the last selected dive.

+

Map: Show only the world map, centered on the last selected dive.

Like other functions that can be accessed via the Main Menu, these options can also be triggered using keyboard shortcuts. The shortcuts are shown with an underline in the main menu entries, with the Alt-key pressed, @@ -654,7 +583,7 @@ following sections, the procedures to create a new logbook will be explained.

-

4. Creating a new logbook

+

3. Creating a new logbook

Select File → New Logbook from the main menu. All existing dive data are cleared so new information can be added. If there are unsaved data in an @@ -663,7 +592,7 @@ saved before a new logbook is created.

-

5. Storing dive information in the logbook

+

4. Storing dive information in the logbook

Now that a new logbook is created, it is simple to add dive data it. Subsurface allows several ways of adding dive data to a logbook.

@@ -709,7 +638,7 @@ Spreadsheet or CSV files containing dive profiles.
-

5.1. Entering dive information by hand

+

4.1. Entering dive information by hand

This is usually the approach for dives without a dive computer. The basic record of information within Subsurface is a dive. The most important information in a simple dive logbook usually includes dive type, date, time, duration, @@ -718,19 +647,19 @@ some remarks about the dive. Subsurface can store much more information for each dive. To add a dive to a dive log, select Log → Add Dive from the Main Menu. The program then shows three panels on which to enter -information for a dive: two tabs in the Info panel (Notes and -Equipment), as well as the Dive Profile panel that displays a graphical profile -of each dive. These panels are respectively marked A, B and -C +information for a dive: three tabs in the Info panel (Notes, +Equipment and Information), as well as the Dive Profile panel that displays a graphical profile +of each dive. These panels are respectively marked A, B, C and +D in the figure below. Each of these tabs will now be explained for data entry.

-FIGURE: Add dive +FIGURE: Add dive

Most actions when editing a new dive can be individually undone, as described in the section on undoing edits, but changes -in the Equipment panel are not yet included in that in-depth undo implementations, and therefore +in the Profile panel are not yet included in that in-depth undo implementations, and therefore Subsurface enters Editing Mode when changes are made in this panel. This is indicated by the message in the blue box at the top of the panels (see the image below).

@@ -738,16 +667,18 @@ indicated by the message in the blue box at the top of the panels (see the image Blue edit bar
-

The Apply changes button should be selected after all the equipment for a dive has been entered.

-

If this hand-entered dive was not in the sea but in a body of water above sea level you may wish to edit the altitude setting in the -Information panel because dives at altitude need special calculations.

-

All edits to a new dive, including changes to the equipment after -selecting the Apply changes button, are -saved in memory but NOT written to storage. -If you don’t manually save them before closing Subsurface, the program will +

The Apply changes button should be selected after all the profile segments for a dive has been entered.

+

If this hand-entered dive was not in the sea but at altitude away from the sea, you may wish to edit the altitude setting in the +Information tab because dives at altitude need special calculations.

+

In addition, the water type of this dive (e.g. sea water; fresh water) can be entered in the water type setting in the +Information tab. In order to do this, enable editing of water type in the +Dive log Preferences (File→Preferences→Dive log).

+

All edits to a new dive, including changes to the equipment after selecting the +Apply changes button, are saved in memory but NOT written to storage. If you +don’t manually save them before closing Subsurface, the program will ask again, this time whether the complete dive log should be saved to storage or not.

-

5.1.1. Creating a Dive Profile

+

4.1.1. Creating a Dive Profile

The Dive Profile (a graphical representation of the depth of the dive as a function of time) is shown in the panel on the top right hand of the Subsurface window. When a dive is manually added to a logbook, Subsurface @@ -803,9 +734,9 @@ the Notes and the Equipment tabs on the top le

-

5.2. Importing new dive information from a Dive Computer

+

4.2. Importing new dive information from a Dive Computer

-

5.2.1. Connecting and importing data from a dive computer.

+

4.2.1. Connecting and importing data from a dive computer.

The use of dive computers allows the collection of a large amount of information about each dive, e.g. a detailed record of depth, duration, rates of ascent/descent @@ -1058,7 +989,7 @@ as well as contextual information about the dives recorded on the dive computer.

-

5.2.2. Connecting Subsurface to a Bluetooth-enabled dive computer

+

4.2.2. Connecting Subsurface to a Bluetooth-enabled dive computer

Bluetooth is becoming a more common way of communication between dive computers and Subsurface. Subsurface provides a largely operating system independent Bluetooth interface. An increasing number of dive computers use Bluetooth Low Energy (BTLE) @@ -1068,36 +999,39 @@ consequently adaptations need to be made for communicating with each different d 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.

+with respect to new dive computers that use these mechanisms of communication.

Setting up Subsurface for Bluetooth communication requires four steps:

  • -Ensure Bluetooth is activated on the host computer running Subsurface. +1.Ensure Bluetooth is activated on the host computer running Subsurface.

  • -Ensure Subsurface sees the Bluetooth adapter on the host computer. +2.Ensure Subsurface sees the Bluetooth adapter on the host computer.

  • -Ensure the Bluetooth-enabled dive computer is Bluetooth-discoverable and in PC upload mode. +3.Ensure the Bluetooth-enabled dive computer is Bluetooth-discoverable and in PC upload mode.

  • -Ensure Subsurface is paired with the Bluetooth-enabled dive computer. +4.Ensure Subsurface is paired with the Bluetooth-enabled dive computer. +

    +
    • +
  • +

    +5.If more than one Bluetooth mode is available, select the appropriate mount point.

Select the Download dialog by selecting Import → Import from dive computer from the Main Menu. After checking the box labelled "Choose Bluetooth download mode", the dialog below appears.

-
-
On Linux or MacOS:
FIGURE: Download Bluetooth @@ -1135,11 +1069,9 @@ address and its pairing status. For BTLE devices the address often starts with " 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 Pair option and wait for the task to complete. If this dive computer -is being paired to Subsurface for the first time, it’s possible Subsurface will -request a Pass Code or PIN number. The most commonly-used Pass Code is 0000, -and this works for the Shearwater Petrel. If necessary, consult the user manual of the -dive computer being used.

+Select the Pair option and wait for the task to complete. +If necessary, consult the user manual of the +dive computer being used. This accomplishes steps 4 and 5, above.

@@ -1171,28 +1103,16 @@ Request PIN code This closes the Bluetooth dialog. Now select Download in the Download from dive computer dialog which should still be open. The downloaded dives are shown on the righthand side of the download dialog.

-
On Windows:
-FIGURE: Download Bluetooth on Windows +FIGURE: Download Bluetooth on Windows
-

On Windows platforms the Local Bluetooth device details section on the right is not displayed as -is the case on the Linux/Mac systems. -To start a scan (by pressing the Scan button) -check that the Bluetooth device on the Subsurface computer is turned on by selecting -the dive computer from the list of available Bluetooth devices (see image above). If the dive computer -is being accessed by Subsurface for the first time, it’s possible Subsurface will -request a Pass Code or PIN number. Supply the Pass Code recommended in the user manual of the dive computer. -A Pass Code or PIN of 0000 is often the default.

-

The pairing step is checked and done automatically during -the download process. If the devices have never been paired the system will ask -permission and put a message on the right side of the screen: Add a -device, Tap to set up your DC device. Always allow this pairing. After a -discovered item is selected, select the Save button. -Finally select the Download button on the Download dialog and wait for the process to complete.

+

Bluetooth download on Windows is much the same as on Linux and MacOS. +A log message on the bottom left of the Remote Bluetooth device selection +shows details about the current status of the Bluetooth agent (see image above).

@@ -1205,10 +1125,6 @@ will not work. However, Bluetooth hardware/dongles from these manufacturers (e.g. iSonic) that support the Microsoft Bluetooth Stack do work.
-

A log message on the bottom left of the Remote Bluetooth device selection -shows details about the current status of the Bluetooth agent. To -select another dive computer for download using the "Remote Bluetooth selection dialog" -press the three-dots button from the "Choose Bluetooth download mode" option.

-

5.2.3. Changing the name of a dive computer

+

4.2.3. Changing the name of a dive computer

It may be necessary to distinguish between different dive computers used to upload dive logs to Subsurface. For instance if a buddy’s dive computer is the same make and model as your own and dive logs are uploaded from both dive computers @@ -1255,30 +1171,71 @@ show the nickname for that particular device instead of the model name, allowing easy identification of devices.

-

5.2.4. Uploading data for a specific dive from more than one dive computer

+

4.2.4. Uploading data for a specific dive from more than one dive computer

Some divers use more than one dive computer at the same time, e.g. during technical diving. If you import the dive profiles from these different dive computers into Subsurface, the profiles can be viewed independently. During upload the data from the dive computers are automatically merged into a single dive. The different profiles are presented on the Profile panel with -the name of each dive computer indicated at the bottom left. +the name of each dive computer indicated at the bottom left as well as an indicator of the +number of dive computers uploaded for this dive (e.g."No. 2 of 2"). The original dive profile is +shown by default while profiles from additional dive computers are added "behind" that of the +first uploaded dive computer. While the dive is highlighted in the Dive List, switch between the profiles of the -different dive computers by using either the left/right arrow keyboard keys or -by selecting View → Previous DC or View → Next DC. The data in the Notes panel +different dive computers by using the left/right arrow keyboard keys. If profiles from more than +one dive computer exists for a dive, right-clicking on the name of the dive computer +(bottom left of the profile panel) activates a context menu (image below) that allows one to make the selected +dive computer the one whose profile is shown by default: this changes the order in which the profiles +are shown when using the left-arrow and right-arrow keys. The context menu also allows deleting any of +the dive computers or to take the information from a specific dive computer and present that +as a separate dive.

+
+
+FIGURE:dc management +
+
+

The data in the Notes panel are not affected by the specific dive computer that is selected.

-

5.2.5. Updating the dive information imported from the dive computer.

+

4.2.5. Updating the dive information imported from the dive computer.

With the uploaded dives in the Dive List, the information from the dive computer is not complete and more details must be added to have a full record of the dives. To do this, -the Notes and the Equipment tabs on the top left hand of the -Subsurface window should be used.

+the Notes, Equipment and Information tabs on the top left hand of the +Subsurface window should be used. These three tabs represent a +increase in the amount of information stored for a dive.

+
    +
  1. +

    +The Notes tab +holds basic information about the dive, the date and time, locality, +budiy, divemaster and some dive notes. This is about the minimum amount of +information required for a coherent dive log. +

    +
    2. +
  2. +

    +If one wishes, one can expand the dive information by using the +Equipment tab to record information about the equipment used: cylinders +and their start and end pressures, dive suit used and weight system used. +

    +
    3. +
  3. +

    +Expanding the dive information even more, the Information tab is used +to record environmental information such as water type (usually fresh water or salt water), +temperatures, surface conditions and conditions during the dive, e.g. visibility +and current. For dives downloaded from a dive computer, water type and water temperature +are automatically provided in the Information tab. Some dive computers also +provide air temperature and altitude. +

    +
    4. +
-
Notes
-

To have a more complete dive record, the user needs to add -additional information by hand. The procedure +

The Notes tab
+

The procedure below is virtually identical for hand-entered dives and for dives downloaded from a dive computer.

-

Usually the date and time of the dive, gas mixture and water temperature are +

The date and time of the dive are shown as obtained from the dive computer. In some cases, provide the date and time of the dive, for example when entering a dive by hand or when a dive computer doesn’t provide this information. If you @@ -1286,7 +1243,7 @@ click on the Notes tab, the following fields are visible (left hand image, below):

-FIGURE: The Notes tab +FIGURE: The Notes tab

The right hand image, above, shows a Notes tab filled with dive information. @@ -1296,7 +1253,9 @@ the correct date. Press ESC to close the calendar. The time values (hour and minutes) can also be edited directly by clicking on each of them in the text box and by over-typing the information displayed.

-

How to UNDO information that has been typed. While editing a dive log you frequently +

+
+

How to UNDO information that has been typed. While editing a dive log you frequently replace or modify existing information. Sometimes this is unintended. Let’s say, for the moment, the time of your dive computer was set incorrectly and the dive time in the Notes tab is therefore incorrect. You wish to correct the time indicated in the Notes tab @@ -1316,15 +1275,7 @@ to a specific dive and changes to multiple dives can be undone.

FIGURE:Performing an undo
-

Air/water temperatures: Air and water temperatures during the dive are shown -in text boxes to the right of the Start time. Many dive computers supply water -temperature information and this box may have information. -If air temperature isn’t provided by the dive computer, the first temperature reading -might be used for the air temperature. Generally this is close to the real air temperature. -If editing is required, only a value is required, the units of temperature will be -automatically supplied by -Subsurface (following the Preferences, metric or imperial units will -be used).

+

Location:

@@ -1238,7 +1154,7 @@ with Subsurface.
@@ -1370,12 +1321,35 @@ data here are the geographic coordinates of the dive location.

FIGURE:Location creation panel -

There are three ways of adding the coordinates:

-

(1): Enter coordinates by hand if they are known, using one of +

New dive locations can be recorded in one of four ways:

+
    +
  1. +

    +Typing in known coordinates by hand +

    +
    2. +
  2. +

    +Positioning the dive site flag on the dive map +

    +
    3. +
  3. +

    +Dive site coordinates from the Subsurface-Mobile phone app +

    +
    4. +
  4. +

    +Dive site coordinates from a GPS track +

    +
    5. +
+

(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
+        or, alternatively,   30d13'28.9"N 30d49'1.5"E
 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
@@ -1383,12 +1357,27 @@ Decimal degrees, e.g. 30.22496 , 30.821798

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. +don’t have the degree sign (°). It can be replaced by a d like this: N30d W20d (see example above). 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 +If the typed coordinate information does not conform to one of the above formats, the background +of the text box turns RED. Correct the typing error(s) and the background of the text box +turns white again as it should be. +Dive site information can later be added or 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 +

+
+ + +
+Warning +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 +dives have the same location and try to keep their GPS coordinates the +same).
+
+

(2): Use the Dive Map to specify the coordinates. The Dive map now shows all the existing dive locations 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 @@ -1406,20 +1395,91 @@ dive site name in the Notes tab.

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): Obtain the coordinates using the Subsurface-mobile App on an - Android or iPhone device with GPS and if the dive site coordinates - were stored using one of this app.

-
- - - -
-Warning -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 -dives have the same location and try to keep their GPS coordinates the -same).
+

(3): Dive coordinates from a mobile device with GPS using Subsurface-Mobile. +Most smartphones have an integrated GPS, useful for collecting the coordinates of dive sites. +The user manual for Subsurface-mobile (accessible from within that app) +contains detailed instructions for +performing the collection of GPS data and for managing, uploading and +synchronising the coordinates with a dive log.

+

(4): Import coordinates from GPS equipment. Some divers prefer to take a GPS +onto the boat and record a GPS track while diving. Subsurface can extract the +dive site from this track and store the dive site coordinates as part of the dive log. +Follow the next steps:

+
    +
  1. +

    +Connect the GPS to your desktop computer. Most GPS equipment have a USB +port for connecting to a desktop computer and GPS track recordings can be +opened from the desktop computer. Make sure you can see the correct track +on the GPS as a .GPX file. Alternatively copy the appropriate .GPX file +from the GPS to a directory on your desktop computer. +

    +
    2. +
  2. +

    +In the Dive List, select the dive to be edited and specify a name for the dive site +using the Locality field in the Notes panel. +

    +
    3. +
  3. +

    +Open the Dive site managment panel by selecting the blue globe icon to the right +of the Locality text box of the Notes tab. +

    +
    4. +
  4. +

    +Select the button "Use GPS file" to the right of the Coordinates text box (see image A +above). This opens a file selection dialog. +

    +
    5. +
  5. +

    +Select the appropriate .GPX file on the GPS, or alternatively, the .GPX file that +has been copied from the GPS to the desktop computer. Subsurface reads the .GPX file +and compares the dive time with the times of the GPS track. The result is shown in +the panel in the image below. +

    +
    6. +
  6. +

    +GPS tracks are recorded in UTC time, that is the time at a longitude of zero degrees, +often referred to as "Greenwich time". In order to obtain the local time for the +GPS track, it is necessary to know the time zone of the dive site. For instance, in the +above example the time zone was UTC+2, that is 2 hours after UTC. Set the +UTC time zone in the appropriate text field shown in the image below. +

    +
    7. +
  7. +

    +Even though the .GPX standard requires dive tracks in UTC time, most GPS devices can +show the local time. Make sure your GPS device shows the same local time as your +dive computer. If the times are not identical, then specify a correction in the bottom +text box of the panel illustrated below. +

    +
    8. +
  8. +

    +The coloured icon to the right of the Start and end times in the above panel shows the +degree of synchronisation between dive computer and GPS device. A green icon +indicates that the GPS track coincides with the time of the dive. A yellow icon +indicates partial synchronisation while a red icon indicates that the dive and the +GPS track are at different times and that coordinates cannot be extracted. Make +sure that the GPS date and the dive date are the same. +

    +
    9. +
  9. +

    +Finally, select the Save button at the bottom right of the panel. This updates +the coordinates in the Dive site management panel and moves the flag on the map +to the locality corresponding to the coordinates. Then close the panel. +

    +
    10. +
+
+
+FIGURE:Import GPs coordinates +

Dive site name lookup: If you typed coordinates into the appropriate text box, you can do an automated name lookup based on the coordinates. @@ -1434,10 +1494,8 @@ sites named "Blue Hole", all of them are listed.

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.

-

Dive mode: This is a dropdown box allowing you to choose the type of dive -performed. The options are OC (Open Circuit SCUBA, the default setting, for most recreational dives), -Freedive (dive without SCUBA equipment), CCR (Closed-circuit -rebreather) and pSCR (Passive semi-closed rebreather).

+

Having entered information about the dive site into the Notes tab, the following +additional information can be typed in:

Divemaster: The name of the divemaster or dive guide should be entered in this field which offers auto selection based on the list of divemasters in @@ -1446,14 +1504,8 @@ the current logbook.

(separated with commas) who were on the dive. Auto selection based on the list of buddies in the current logbook is offered.

-

Suit: Here the type of dive suit used can be entered. -Auto selection of the suit description is available. -Some dry-suit users may choose to use this field to record what combination of -suit and thermal under suit was used.

Rating: Provide a subjective overall rating of the dive on a 5-point scale by clicking the appropriate star on the rating scale.

-

Visibility: Provide a rating of visibility during the -dive on a 5-point scale by clicking the appropriate star.

Tags: Tags that describe the type of dive done can be entered here (separated by commas). Examples of common tags are boat, drift, training, cave, etc. @@ -1461,24 +1513,14 @@ cave, etc. the tags that correspond to the typing. For instance, by typing cav, the tags cave and cavern are shown to choose from.

Notes: Any additional information for the dive can be entered here.

-

If this dive was away from the sea and your dive computer does not record atmospheric -pressure or altitude you may wish to edit the altitude setting in the -Information panel because dives at altitude require special calculations.

The image at the beginning of this section shows an example of a Notes tab after completing the dive information.

-
Equipment
-

The Equipment tab allow entering information about the type of -cylinder and gas used, as well as the weights used for the dive. The -message in the blue box at the top of the panel:

-
-
-FIGURE: Blue edit bar -
-
-

shows the equipment is being edited. This is a highly interactive part of -Subsurface and the information on +

The Equipment tab
+

The Equipment tab allows entering information about the type of +cylinder and gas used, as well as the weights used for the dive. This is a +highly interactive part of Subsurface and the information on cylinders and gases (entered here) determines the behavior of the Dive profile (top right-hand panel).

Cylinders: The cylinder information is entered through a dialog that looks @@ -1509,6 +1551,15 @@ for this dive, or just start typing in the box which shows the available options for the entered characters. The Size of the cylinder as well as its working pressure (Work.press) will automatically be shown in the dialog.

+

If your cylinder is not listed: Maybe the cylinder type you dive with is not listed in the dropdown list. Add a new +cylinder by selecting any of the existing cylinders in the list and clicking on the +name of that cylinder. This activates the cursor on the cylinder name. Overtype +the cylinder name with your new cylinder name and press ENTER on the keyboard. The new +cylinder name now appears on the dropdown list. Overtyping a cylinder name does not affect +the name that is being overtyped. Add a size and start pressure for that +cylinder. The usual convention is that double cylinders are prefixed with a "D" to +indicate "double". Say for instance you dive a manifolded twinset of two 7 litre steel cylinders. This +could be named "D7ℓ 232 bar" rather than "14ℓ 232 bar". However, use a rule that works for you.

Next, indicate the starting pressure and the ending pressure of the specified gas during the dive. The unit of pressure (metric/imperial) corresponds to the settings chosen in the Preferences.

@@ -1527,6 +1578,10 @@ for a dive using two cylinders (air and EAN50):

FIGURE: a completed cylinder dive information table
+

Suit: Here the type of dive suit used can be entered. +Auto selection of the suit description is available. +Some dry-suit users may choose to use this field to record what combination of +suit and thermal undersuit was used.

Weights: Information about the weight system used can be entered using a dialog similar to that of the cylinder information. If you click the + button on the top right of the weights dialog, the table looks like @@ -1562,9 +1617,110 @@ with two types of weights: integrated as well as a weight belt:

+
+
The Information tab
+

The Information tab serves two purposes:

+
    +
  1. +

    +Allow divers to enter information about the environment with respect to a specific dive. +

    +
    2. +
  2. +

    +Show some dive information that is not displayed elsewhere. +

    +
    3. +
+

Below is an example of an Information tab with complete information:

+
+
+FIGURE: A Information tab showing full information +
+
+

For technical or freedivers, the Dive mode can be selected. Dive mode: This is a dropdown box +allowing you to choose the type of dive +performed. The options are OC (Open Circuit SCUBA, the default setting, for most recreational dives), +Freedive (dive without SCUBA equipment), CCR (Closed-circuit +rebreather) and pSCR (Passive semi-closed rebreather).

+

Use the Information tab to also enter environmental information for a dive.

+

Air/water temperatures: Air and water temperatures during the dive are shown +in text boxes to the right of the Start time. Many dive computers supply water +temperature information and this box may contain that. +If air temperature isn’t provided by the dive computer, the first temperature reading +might be used for the air temperature. Generally this is close to the real air temperature. +If editing is required, only a value is required, the units of temperature will be +automatically supplied by +Subsurface (following the Preferences Units, metric or imperial units will +be used).

+

The Water type/density field shows the information reported by the dive computer. This field is +editable only if it is enabled in the Log Preferences (File→Preferences→Dive log). When enabled, for instance for manually-entered dives +without dive computer information, select the desired water type +using the dropdown box. The following water types are available:

+
    +
  1. +

    +Fresh water, usually at inland dive sites or in caves. +

    +
    2. +
  2. +

    +Salty water, i.e. water that contains a little salt (called brackish water). +

    +
    3. +
  3. +

    +EN13319, an average value that represents neither fresh water or sea water. This value is available +on some dive computers and is regarded by some as a safe value for both fresh water and sea water. +

    +
    4. +
  4. +

    +Salt water encountered in the sea. +

    +
    5. +
+

The topic of water salinity is complex because it differs sonewhat between different oceans. A warning icon +is shown if the water type reported by the dive computer currently displayed is different from +the value that is typed here. The water density value (corresponding to salinity) is automatically calculated +from the choice of water type.

+
+ + + +
+Note +Altitude If this dive was away from the sea and your dive computer does not record atmospheric +pressure or altitude you may wish to edit the altitude because dives at altitude require special calculations. +The text box Atm. pressure/Altitude allows this. If this text box +contains a value, dive calculations take into account altitude. The dropbox on the +right allows two ways of expressing atmospheric pressure: mbar or m/ft above sea level. +The altitude unit (metric/imperial) is taken from the settings in the Units Preferences screen. A +third option is to use the atmospheric pressure provided by the dive computer. In order to specify +the pressure/altitude, first select the appropriate unit in the dropbox (in the case of the image on the left +these are "mbar/m/use dc", then type an appropriate value into the text box. In the case +of m/ft the altitude typed into the text box is automatically converted to the +mean expected atmospheric pressure (mbar) at the specified altitude. +In the case of "use dc", no value is required in the text box. Atmospheric pressure provided by a dive +computer does not need any editing.
+
+

Recording of five dive conditions that can be done on a five star rating scale. The convention is that the most comfortable +environmental condition is marked with five stars, while the most unpleasant condition only +gets one star. An environmental condition with no stars is assumed to have no rating, e.g. surface waves in a cave.

+

Visibility: Provide a qualitative rating of visibility during the +dive on a 5-point scale by clicking the appropriate star.

+

Current: Provide a qualitative rating of water current strength during the +dive on a 5-point scale by clicking the appropriate star.

+

The following three environmental parameters can be entered if they are enabled in the Log Preferences (File→Preferences→Dive log)_:

+

Surface waves: Provide a qualitative rating of the size of surface waves (swell/chop) when entering or leaving the water.

+

Surge: Provide a qualitative rating of water surge strength during the +dive on a 5-point scale by clicking the appropriate star.

+

Chill: Provide a qualitative rating of your perception of how cold you got during the +dive.

+
-

5.2.6. Editing several selected dives simultaneously

+

4.2.6. Editing several selected dives simultaneously

METHOD 1: After downloading dives from a dive computer, the dive profiles of each is shown in the Dive profile tab, as well as a few items of information @@ -1597,7 +1753,7 @@ into which this information is to be pasted. Then, from the main menu, select

-

5.2.7. Adding Bookmarks to a dive

+

4.2.7. Adding Bookmarks to a dive

Many divers wish to annotate dives with text that indicate particular events, e.g. "Saw dolphins", or "Released surface buoy". This is easily done:

@@ -1634,7 +1790,7 @@ Hovering the mouse over the red bookmark, the appropriate text is shown at
-

5.2.8. Saving the updated dive information

+

4.2.8. Saving the updated dive information

The information entered in the Notes tab and the Equipment tab can be saved by using the two buttons on the top right hand of the Notes tab. If the Apply changes button @@ -1647,7 +1803,7 @@ the new data should now be saved permanently on the computer disk.

-

5.3. Importing dive information from other digital data sources or other data formats

+

4.3. Importing dive information from other digital data sources or other data formats

Many divers log their dives using the proprietary software provided by the manufacturers of their dive computers. Subsurface can import dive logs from a range of other dive log software. While import from some software is supported natively, @@ -1679,7 +1835,7 @@ beginning time of the dives to be significantly different) Subsurface will not create duplicate entries. Below is more specific information to import data to Subsurface.

-

5.3.1. Using the universal import dialog

+

4.3.1. Using the universal import dialog

Importing dives from other software is done through a universal interface activated by selecting Import from the Main Menu, then clicking on Import Log Files to bring up dialog A, below. The exact appearance @@ -1793,7 +1949,7 @@ This opens the imported dive log in the Subsurface Dive List

Some other formats not accessible through the Import dialog are also supported, as explained below.

-

5.3.2. Importing from OSTCTools

+

4.3.2. Importing from OSTCTools

OSTC Tools is a Microsoft-based suite of dive download and dive management tools for the OSTC family of dive computers. OSTC Tools downloads dive data from the dive computer and stores it as a binary file with file extension .dive . Subsurface can directly import these files when using @@ -1810,7 +1966,7 @@ imported to Subsurface; the rest of the data (buddies, equipment, notes, etc) need to be completed manually.

-

5.3.3. Importing from Mares Dive Organizer V2.1

+

4.3.3. Importing from Mares Dive Organizer V2.1

Since Mares uses proprietary Windows software not compatible with multi-platform applications, these dive logs cannot be directly imported into @@ -1844,7 +2000,7 @@ Finally, import the dives

-

5.3.4. Importing Scubapro SmartTrak divelogs

+

4.3.4. Importing Scubapro SmartTrak divelogs

SmartTrak stores the raw data from a Uwatec/Scubapro dive computer along with a plethora of other data manually added by the user, ranging from dive points to buddies data or DAN survey info. However, this is Microsoft Windows-based proprietary software by Uwatec (today Scubapro) @@ -1962,7 +2118,7 @@ the dives for instructions on this topic.

-

5.3.5. Importing dives from divelogs.de

+

4.3.5. Importing dives from divelogs.de

Importing dive information from divelogs.de is simple, using a single dialog box. The Import → Import from Divelogs.de option should be selected from the Main Menu. This @@ -1981,7 +2137,7 @@ success status is shown (see image B, below). The

-

5.3.6. Importing data in CSV format

+

4.3.6. Importing data in CSV format

A comma-separated file (.csv) can be used to import dive information either as dive profiles (as in the case of the APD Inspiration and Evolution closed circuit rebreathers) or as dive metadata (in case the user keeps dive data in a spreadsheet). The CSV format is a universal @@ -2178,7 +2334,7 @@ a smaller file to make sure everything works.

-

5.4. Manipulating Dive Site Information

+

4.4. Manipulating Dive Site Information

The dive site information of all dives is managed as a separate entity independent of the dive information. Selecting the rightmost tab of the Notes panel, labelled "Dive sites" brings up the dive sites management panel (image below). @@ -2196,14 +2352,14 @@ as well as the number of dives at each site. The list of sites can be ordered by on any of the three headings. A dustbin and an edit icon are on the left of each dive site name. The following actions are possible for managing the collection of dive sites:

-

5.4.1. Filter the list of dive sites

+

4.4.1. Filter the list of dive sites

At the top right of the dive site management panel is a text box (see image above). If you wish to only show dives from a particular site, then type a partial dive site name such as "Genova". This shows only the dive sites that have been described for Genova, assuming that the word "Genova" forms part of the dive site name or description.

-

5.4.2. Edit a dive site

+

4.4.2. Edit a dive site

The information for each dive site can be edited either from from within the Notes tab or within the Dive sites tab. In order to edit the dive site information, select the Edit icon to the left of the dive site name (see image above). Editing dive site information @@ -2219,7 +2375,7 @@ section dealing with Locations. Having finished editi select the Done button at the top. This returns you to the dive sites management panel.

-

5.4.3. Merge dive sites

+

4.4.3. Merge dive sites

Merging two or more dives is achieved in the dive site edit panel (see image above). We assume that the dive sites that need merging are not far apart. Merging is performed by selecting a dive site and then merging other dives with this selected dive site. In the edit panel, above, select the text box labelled "Show dive sites @@ -2235,7 +2391,7 @@ message is presented (see image above). Clicking the confirmation message merges the dive named at the top of the panel and returns you to the dive sites management panel.

-

5.4.4. Add a dive site

+

4.4.4. Add a dive site

At the top right of the dive sites management table is a round button with a "+". Clicking that button inserts a new site entitled "New dive site" into the list (image below). The new site can also be deleted (maybe after erroneously clicking the + icon or you realised the dive site already exists) by selecting Edit → Undo from the main menu or by typing Ctrl-Z (or CMD-Z on a Mac) while the dive sites management table has focus. Edit this new site by selecting its edit icon and provide a name, @@ -2248,7 +2404,7 @@ the "Done" button in the edit panel returns you to the dive sites management pan

-

5.4.5. Delete a dive site

+

4.4.5. Delete a dive site

On the left of each dive site is a dustbin icon. Clicking the dustbin deletes that site. If there are any dives performed at that site, a warning message is shown (see image below). If this site is then deleted, the location(s) of dives that used this site would need to be created.

@@ -2259,7 +2415,7 @@ the location(s) of dives that used this site would need to be created.

-

5.4.6. General approach to the use of the dive sites list

+

4.4.6. General approach to the use of the dive sites list

Since the dive sites list is managed separately from the dive list, it is possible to add dive sites to the list even though these sites have not been used for any dives. In this case the column labelled "# of dives" shows a zero. This makes it possible for divers to share dive sites and sites can be created before any of them are dived. Alternatively @@ -2268,109 +2424,13 @@ bumphead parrotfish. She said Jan - Apr is the best time. I hope to dive there m list becomes a repository of useful information outside of the dive list.

-

5.4.7. Delete unused dive sites

+

4.4.7. Delete unused dive sites

At the top left of the dive sites management panel is a button "Purge unused dive sites". Selecting this button deletes all the dive sites that do not have associated dives.

-

5.5. Importing Dive coordinates from a mobile device with GPS.

-

A smartphone with built-in GPS facilities can be used to store the locations of dives. -This is performed by:

-

1) Taking the mobile device along on the dive boat / liveabord while -automatically collecting dive site coordinate information.

-

2) Adding collected coordinate information to the dives using the Subsurface-mobile app.

-

3) Synchronizing the logbook with the Subsurface cloud using the Subsurface-mobile app.

-

Existing users might still be using the legacy Companion app. However, the Companion App -hasn’t been under development in several years and has now been removed from both Android -and iOS app stores. The functionality is fully integrated into Subsurface-mobile. -Please note that the old GPS fix internet service will be shut down by the end 2018 at which -point the Companion app will no longer be usable. Please switch to Subsurface-mobile instead.

-
-

5.5.1. Storing and and using GPS locations using Subsurface-mobile

-
-
Install Subsurface-mobile
-

Find Subsurface-mobile on Google Play and install it on an Android device. The app -is free. The iOS version is currently experimental. Subsurface-mobile has an extensive -user manual -accessible from within that app.

-
-
-
Create a Subsurface-mobile account
-

This topic is discussed at length in the Subsurface-mobile user manual. In the -Credentials screen of Subsurface-mobile provide an e-mail address and a user -password that enables subsequent access. A PIN number is e-mailed from the -Subsurface Internet server to the e-mail address that has been provided. -Type the PIN into the appropriate text field in the Credentials screen (see image below). -The Subsurface Internet server notifies the user that a new user has been registered.

-

N.B.: To successfully create a user account, the mobile device must have Internet connectivity, -either through the cellular network or via wifi.

-
-
-FIGURE: Subsurface-mobile, credentials screen -
-
-
-
-
Configure auto-collecting of GPS coordinates
-

Activate the main menu of Subsurface-mobile by selecting the "hamburger" menu button -at the bottom left of the Subsurface-mobile screen (see image above), then select -GPS → Preferences (see image below). The collection of GPS locations is done in the background and -automatically, using two settings:

-
    -
  • -

    -Time threshold. (minutes). The app will try to get a location every X minutes -

    -
    • -
  • -

    -Distance threshold. (meters). Minimum distance between two locations. -

    -
    • -
-

How are GPS coordinates collected? Assuming the diver sets 5 minutes and 50 -meters in the settings above, the app will start by recording a location at the current -location, followed by another one at every 5 minutes or every time you move 50 m -from previous location, whichever happens first. -If subsequent locations are within a radius of 50 meters from the previous one, -a new location is not saved. If the diver is not moving, only one location is -saved, at least until the Time-threshold period has elapsed. -If the diver moves, a trace of the route is obtained by saving a location every 50 meters.

-
-
-
Activate the automated recording of GPS locations
-

The Subsurface-mobile GPS menu has an option at the bottom labled -Run location service (see image below). Selecting this starts the automated recording -of GPS positions.

-
-
-FIGURE: Subsurface-mobile GPS menu -
-
-
-
-
After the dive, stop the automated recording of GPS locations
-

Select the menu option Disable location service at the bottom of the Subsurface-mobile GPS menu.

-
-
-
Apply the stored GPS locations to dives on the Subsurface dive list.
-

Subsurface collects the first GPS location recorded after the start of a dive -(obtained within Subsurface from either the dive computer or from the -manually-entered dive information) and before the end of a dive. These -coordinates are shown in the Coordinates field of the dive site panel -for each dive. Within the dive site panel, provide a name for the -coordinates that have been assigned to the dive, following the instructions -under the heading above Location management.

-

The user manual for Subsurface-mobile (accessible from within that app) -contains detailed instructions for -performing the collection of GPS data and for managing, uploading and -synchronising this information.

-
-
-
-
-

5.6. Adding photographs or videos to dives

+

4.5. Adding photographs or videos to dives

Many (if not most) divers take photographs or videos during a dive. We term these as media, meaning either photos or videos. Subsurface allows the storage and display of these media for each dive. Images are @@ -2378,7 +2438,7 @@ superimposed on the dive profile at the times during the dive when they were tak from the dive profile or from the Media tab in the Notes Panel. Subsurface allows viewing of photographs as well as video files in a unified interface.

-

5.6.1. Loading media and synchronizing between dive computer and camera

+

4.5.1. Loading media and synchronizing between dive computer and camera

Right-click on a dive or on a group of dives on the dive list, bringing up the Dive list context Menu. Select the appropriate option to import media either from file or from the Internet. The system file browser appears. Select the folder and @@ -2463,7 +2523,7 @@ selected (see image above) these images can still be placed on the Media

-

5.6.2. Viewing the media

+

4.5.2. Viewing the media

Ensuring that thumbnails are created for video files

@@ -2481,7 +2541,7 @@ which image should be used for the thumbnail. Two actions are required to create

  • -The appropriate settings need to be set in the Preferences. +The appropriate settings need to be set in the Media Preferences (File→Preferences→Media).

  • @@ -2540,7 +2600,7 @@ can also be deleted using the Media tab (see text below).

-

5.6.3. The Media tab

+

4.5.3. The Media tab

Media associated with a dive are shown as thumbnails in the Media tab of the Notes Panel. Media taken in rapid succession during a dive (therefore sometimes with large overlap on the dive profile) can easily be accessed in the Media tab. This tab serves as @@ -2564,7 +2624,7 @@ new video file with the dive data encoded in the video stream. To do so run

<

from the command line. You need to have the libass library installed.

-

5.6.4. Media on an external hard disk

+

4.5.4. Media on an external hard disk

Most underwater photographers store media on an external drive. If such a drive can be mapped by the operating system (almost always the case) the media can be directly accessed by Subsurface. This eases the interaction between Subsurface and an external repository of media. When associating a dive profile with media from an @@ -2575,7 +2635,7 @@ program shows only the thumbnails and the images cannot be viewed at full-screen If the external drive with the media is re-connected, the media can be seen in the normal way.

-

5.6.5. Finding out which dives have associated media.

+

4.5.5. Finding out which dives have associated media.

Inspecting each individual dive in order to determine whether there are associated media can be time consuming. There is a rapid way of seeing which dives have associated media and which not: activate the Media checkbox in the dropdown list obtained by right-clicking on the header bar of the Divelist. In the Divelist, all dives with associated media @@ -2583,7 +2643,7 @@ have an icon indicating whether the media were taken during the dive, just befor More information is provided in the section dealing with photo icons on the Divelist.

-

5.6.6. Moving media among directories, hard disks or computers

+

4.5.6. Moving media among directories, hard disks or computers

After a photograph or video has been loaded into Subsurface and associated with a specific dive, Subsurface saves the path to the directory where the media lie as well as the file name of the each photo/video, in order to find it when the dive is opened again. @@ -2607,10 +2667,10 @@ not listed. The proposed changes can be applied by clicking Apply or re

-

5.7. Logging special types of dives

+

4.6. Logging special types of dives

This section gives examples of the versatility of Subsurface as a dive logging tool.

-

5.7.1. Multicylinder dives

+

4.6.1. Multicylinder dives

Subsurface easily handles dives involving more than one cylinder. Multi-cylinder diving usually happens (a) if a diver doesn’t have enough gas for the complete dive in a single cylinder; (b) if a diver needs more than one gas mixture because of the depth or the decompression needs of the dive. For this reason @@ -2662,7 +2722,7 @@ automated recording of cylinder pressure simplifies logging of sidemount dives ( list of supported dive computers.

-

5.7.2. Sidemount dives

+

4.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 have completed the appropriate training. See the comments in the @@ -2710,7 +2770,7 @@ logging of cylinder pressures during sidemount involves three steps, exactly as

-

5.7.3. Passive semi-closed circuit rebreather (pSCR) dives

+

4.6.3. Passive semi-closed circuit rebreather (pSCR) dives

-

5.7.4. Closed circuit rebreather (CCR) dives

+

4.6.4. Closed circuit rebreather (CCR) dives

@@ -2753,7 +2813,7 @@ over two hours.

Visualising the pO2 drop: The difference between the pO2 of the fresh cylinder gas and the pO2 -in the loop can be visualised in Subsurface by opening the Profile +in the loop can be visualised in Subsurface by opening the Tech setup panel in the File → Preferences menu item and then providing suitable information in the section labelled pSCR options. The pSCR metabolic rate is your rate of oxygen metabolism in liters/min (commonly between 0.5 and 2.5). The Dilution ratio is the ratio indicating how much gas in the loop is replaced with @@ -2762,7 +2822,7 @@ used when planning pSCR dives. If the oxygen content of the loop is not recorded estimates the pO2 in the loop using the information supplied above. This pO2 is shown as the green line representing the oxygen partial pressure in the dive profile. If the oxygen pressure in the loop is measured using an oxygen sensor connected to a dive computer, this information is probably recorded by the dive computer and these -measured pO2 values are shown on the dive profile. In addition, the Preferences panel allows one to activate +measured pO2 values are shown on the dive profile. In addition, the Tech setup Preferences panel allows one to activate a checkbox labelled Show equivalent OC pO2 with pSCR pO2. This activates display of the pO2 in the fresh gas from the cylinder (an orange line). The vertical distance between the orange graph and the green graph indicates the "pO2 drop over the mouthpiece". Much of pSCR diving involves managing this pO2 difference.

@@ -2792,7 +2852,7 @@ differs from the OC-pO2 (orange line).
-
@@ -2867,8 +2927,8 @@ If no sensor data are available, the pO2 value is assumed to be equal

The mean pO2 of the sensors is indicated with a green line,

The oxygen setpoint values as well as the readings from the individual oxygen sensors can be shown. The display of additional CCR information is turned on by -checking the appropriate boxes in the Preferences panel (accessible by -selecting File → Preferences → Profile). This part of +checking the appropriate boxes in the Tech setup Preferences panel (accessible by +selecting File→Preferences→Tech setup). This part of the Preferences panel is shown in the image below, representing two checkboxes that modify the display of pO2 when the appropriate toolbar button on the Dive Profile has been checked.

@@ -2955,7 +3015,7 @@ by clicking the appropriate button to the left of the dive profile:

The default color of the computer-generated deco ceiling is white. This can be set to red -by checking the appropriate check box after selecting File → Preferences → Profile. +by checking the appropriate check box after selecting File→Preferences→Tech setup. The profile above indicates the dive computer-generated deco ceiling in red.

Cylinder pressures: Some CCR dive computers like Poseidon record the pressures of the oxygen and diluent cylinders. The pressures of these two cylinders @@ -2980,10 +3040,10 @@ Poseidon and APD equipment can be found in -

6. Obtaining more information about dives entered into the logbook

+

5. Obtaining more information about dives entered into the logbook

-

6.1. Using the Dive Map to obtain more dive information

+

5.1. Using the Dive Map to obtain more dive information

The Dive Map has buttons useful for obtaining spatial information about a dive. These are:

@@ -3045,31 +3105,12 @@ Select visible dive locations. In the Dive List panel, highlight all the dive si
-

6.2. The Information tab (for individual dives)

+

5.2. The Information tab (for individual dives)

The Information 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 gas volume consumed, the surface air consumption (SAC) and the number of oxygen toxicity units (OTU) incurred.

-
-
- - -
-Note -The text box Atm. pressure allows one to specify -the altitude or the atmospheric pressure of the dive site while diving. If this text box -contains a value, dive calculations take into account altitude. The dropbox on the -right allows two ways of expressing atmospheric pressure: mbar or m/ft above sea level. -The altitude unit (metric/imperial) is taken from the settings in the Preferences screen. A -third option is to use the atmospheric pressure provided by the dive computer. In order to specify -the pressure/altitude, first select the appropriate unit (in the case of the image on the left -these are "mbar/m/use dc", then type an appropriate value into the text box. In the case -of m/ft the altitude typed into the text box is automatically converted to the -mean expected atmospheric pressure (mbar) at the specified altitude. -In the case of "use dc", no value is required in the text box. Atmospheric pressure provided by a dive -computer does not need any editing.
-
-

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

+

5.3. 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 +dive has been selected, figures for only that dive are given. This tab +shows the number of dives selected, the total amount of dive time in these +dives, +as well as the minimum, maximum and mean for the dive duration, +water temperature and surface air consumption (SAC). It also shows the depth of the +shallowest and deepest dives of those selected.

+
+
+

5.4. 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 @@ -3097,19 +3150,7 @@ image showing extra data for a dive using a Poseidon rebreather.

-

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 -dive has been selected, figures for only that dive are given. This tab -shows the number of dives selected, the total amount of dive time in these -dives, -as well as the minimum, maximum and mean for the dive duration, -water temperature and surface air consumption (SAC). It also shows the depth of the -shallowest and deepest dives of those selected.

-
-
-

6.5. The Dive Profile

+

5.5. The Dive Profile

Typical dive profile @@ -3182,7 +3223,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.5.1. The Information Box

+

5.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 @@ -3218,7 +3259,7 @@ buttons on the left of the profile panel. These are:

@@ -3083,7 +3124,19 @@ Refer to Appendix F for more information. Show the Maximum Operating Depth (MOD) of the dive, given the gas mixture used. MOD is dependent on the oxygen concentration in the breathing gas. For air (21% oxygen) it is around 57 m if a maximum pO2 of 1.4 is specified in the Preferences section -(select File → Preferences → Profile and edit the text box pO2 in calculating MOD. +(select File → Preferences → Tech setup) and edit the text box pO2 in calculating MOD. When diving below the MOD there is a markedly increased risk of exposure to the dangers of oxygen toxicity.
@@ -3243,8 +3284,11 @@ TTS longer than 2 hours is not accurately calculated and Subsurface only indicat
Note Show Deco information. When enabled, the information box shows the surface GF and the momentary -ceilings for the individual tissue compartments. The surface GF is an indication of to what degree +Show Deco information. When enabled, the information box shows the current gradient factor (GF), +the surface GF and the momentary +ceilings for the individual tissue compartments. The gradient factor is in indication of how +much of the allowed pressure gradient between tissues (normalized with a 100/100 Bühlmann model) +the diver is currently using. The surface GF is an indication of to what degree the partial pressure of nitrogen in the blood exceeds the partial pressure required for safely reaching the surface. Surface GF > 100% means that it is unsafe to surface.
@@ -3331,8 +3375,8 @@ The dark green area at the bottom of the graph represents the pressures of inert The top black horizontal line indicates the inert gas pressure limit determined by the gradient factor that applies to the depth of the diver at the particular point on the Dive Profile. The gradient factor shown is an - interpolation between the GFLow and GFHigh values specified in the Profile tab of the Preferences - Panel of Subsurface. + interpolation between the GFLow and GFHigh values specified in the Ceiling Display part of the Tech setup Preferences + Panel of Subsurface.

  • @@ -3387,7 +3431,7 @@ Graph E indicates the situation after remaining at 4.5 meters f
    • -

    6.5.2. Computer-reported events during dive

    +

    5.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). @@ -3413,7 +3457,7 @@ a small red flag on the profile and are discussed more fully in the section on inserting bookmarks.

    -

    6.5.3. The Profile Toolbar

    +

    5.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). @@ -3714,7 +3758,7 @@ in slower tissues at the end of the dive.

    -

    6.5.4. The Dive Profile context menu

    +

    5.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 @@ -3735,12 +3779,12 @@ restored to view by selecting Unhide all events from the context menu.

    -

    6.6. Filtering the dive list

    +

    5.6. Filtering the dive list

    The dives in the Dive List can be filtered, selecting only some of the dives based on attributes such as dive tags, dive site, divemaster or buddy. For instance, filtering lets you list the dives during a particular year at a specific dive site, or otherwise the cave dives with a particular buddy. Filtering can be performed -based on any information in the Info Panel.

    +based on any information in the Information Panel.

    To open the filter, select Log → Filter divelist from the main menu. This replaces the Dive Map Panel with a Filter Panel. The top window bar contains the number of dives that satisfy the current selections of the filter (see image below).

    @@ -3763,7 +3807,8 @@ useful for rebreather divers and free divers who also do some open circuit divin Figure: Filter panel
    -

    The filter criteria can be any of the following:

    +

    The top text box is a full-text filter: dives are searched in their entirety (notes and all other fields) for the word(s) in the text box. Let us assume the text box contains the word "whale". There are three ways the dive contents is filtered: 1) Starts with: all words starting with the text in the text box are used to filter the dive list. This means that a dive containing the word "whaleshark" is included in the divelist. 2) Substring: dives with all words that include the text in the full text search box are included in the list. If the full-text box contains "shark", dives containing the word "whaleshark" are also included in the dive list. 3) Full word: filtering is performed strictly using the word in the full-text box. If the full-text box contains "shark", dives containing "whaleshark" are NOT included in the dive list. However if a dive contains "bull shark" it is included in the dive list.

    +

    For the fields in the lower half of the panel the filter criteria can be any of the following:

    1) Using different text boxes in the Filter panel performs an AND operator on different attributes. For example, typing "Peter" for the Persons attribute and "Sipadan" for the Location attribute results in a dive list containing all dives with Peter at Sipadan.

    @@ -3801,10 +3846,10 @@ To re-open the Filter Panel in this case, select Log → Filte
    -

    7. Organizing the logbook (Manipulating groups of dives)

    +

    6. Organizing the logbook (Manipulating groups of dives)

    -

    7.1. The Dive List context menu

    +

    6.1. The Dive List context menu

    Several actions on either a single dive, or a group of dives, can be performed using the Dive List Context Menu. It is found by selecting either a single dive or a group of dives and then right-clicking.

    @@ -3814,7 +3859,7 @@ Context Menu. It is found by selecting either a single dive or a group of dives

    The context menu is used in many functions described below.

    -

    7.1.1. Customizing the columns showed in the Dive List panel

    +

    6.1.1. Customizing the columns showed in the Dive List panel

    Example: Dive list info options @@ -3857,7 +3902,7 @@ just before or after the dive, or of landscapes as seen from the boat.
    -

    7.2. Renumbering the dives

    +

    6.2. Renumbering the dives

    Dives are normally numbered incrementally from non-recent dives (low sequence numbers) to recent dives (higher sequence numbers). Numbering of dives is not always consistent. For instance, when non-recent dives are @@ -3874,7 +3919,7 @@ to perform the renumbering. A popup window appears letting the user specify the starting number for the process.

    -

    7.3. Grouping dives into trips and manipulating trips

    +

    6.3. Grouping dives into trips and manipulating trips

    For regular divers, the dive list can rapidly become very long. Subsurface can group dives into trips. It does this by grouping dives that have date/times not separated by more than two days and creating @@ -3891,7 +3936,7 @@ having to scan a long lists of dives. To group the dives in a dive list, (from the Main Menu) select Log → Auto group. The Dive List panel now shows only the titles for the trips.

    -

    7.3.1. Editing the title and associated information for a particular trip

    +

    6.3.1. Editing the title and associated information for a particular trip

    Normally, in the dive list, minimal information is included in the trip title. More information about a trip can be added by selecting its trip title bar from the Dive List. This shows a Trip Notes tab in the Notes panel. Here @@ -3905,19 +3950,19 @@ tab. The trip title in the Dive List panel should now reflect t edited information.

    -

    7.3.2. Viewing the dives during a particular trip

    +

    6.3.2. Viewing the dives during a particular trip

    Once the dives have been grouped into trips, you can expand one or more trips by clicking the expansion button [+/-] on the left of each trip title. This expands the selected trip, revealing individual dives during the trip.

    -

    7.3.3. Merging dives from more than one trip into a single trip

    +

    6.3.3. Merging dives from more than one trip into a single trip

    After selecting a trip title, the context menu allows the merging of trips by either merging the selected trip with the trip below or with the trip above. (Merge trip with trip below; Merge trip with trip above)

    -

    7.3.4. Splitting a single trip into more than one trip

    +

    6.3.4. Splitting a single trip into more than one trip

    If a trip includes, for example, ten dives, you can split this trip into two trips (trip 1: top four dives; trip 2: bottom six dives) by selecting and right-clicking the top four dives. The resulting context menu lets the user create a new trip by @@ -3934,9 +3979,9 @@ the completed action on the right (B):

    -

    7.4. Manipulating single dives

    +

    6.4. Manipulating single dives

    -

    7.4.1. Delete a dive from the dive log

    +

    6.4.1. Delete a dive from the dive log

    Dives can be permanently deleted from the dive log by selecting and right-clicking them to bring up the context menu, then selecting Delete dive(s). Typically this would apply to a case where a user wishes to delete @@ -3944,7 +3989,7 @@ workshop calibration dives of the dive computer or dives of extremely short duration.

    -

    7.4.2. Unlink a dive from a trip

    +

    6.4.2. Unlink a dive from a trip

    You can unlink dives from the trip to which they belong. To do this, select and right-click the relevant dives to bring up the context menu. Then select the option Remove dive(s) @@ -3952,13 +3997,13 @@ from trip. The dive(s) now appear immediately above or below the trip t which they belonged, depending on the date and time of the unlinked dive.

    -

    7.4.3. Add a dive to the trip immediately above

    +

    6.4.3. Add a dive to the trip immediately above

    Selected dives can be moved from the trip to which they belong and placed within a separate trip. To do this, select and right-click the dive(s) to bring up the context menu, and then select Create new trip above.

    -

    7.4.4. Shift the start time of dive(s)

    +

    6.4.4. Shift the start time of dive(s)

    Sometimes it’s necessary to adjust the start time of a dive. This may apply to situations where dives are done in different time zones or when the dive computer has a wrong time. To do this, select and right-click @@ -3970,7 +4015,7 @@ time option of whether the time adjustment should be earlier or later.

    -

    7.4.5. Merge dives into a single dive

    +

    6.4.5. Merge dives into a single dive

    Sometimes a dive is briefly interrupted, for example, if a diver returns to the surface for a few minutes, resulting in two or more dives being recorded by the dive computer and appearing as different dives in the Dive List panel. @@ -3986,7 +4031,7 @@ below shows the depth profile of two dives that were merged:

    -

    7.4.6. Split selected dives

    +

    6.4.6. Split selected dives

    On some occasions, a diver reaches the surface and immediately dives again. However, it may happen that the dive computer does not register a new dive, but continues the previous dive due to the brief surface interval. In this case it is possible to @@ -3995,15 +4040,15 @@ If this operation is performed, Subsurface scans the selected dive(s) a dive at points during the dive where the depth is less than a metre.

    -

    7.4.7. Load image(s) from file(s)

    +

    6.4.7. Load image(s) from file(s)

    This topic is discussed in the section: Adding photographs or videos to dives.

    -

    7.4.8. Load image from web

    +

    6.4.8. Load image from web

    This topic is discussed in the section: Adding photographs or videos to dives.

    -

    7.4.9. Undo dive manipulations

    +

    6.4.9. Undo dive manipulations

    Important actions on dives or trips, described above, can be undone or redone. This includes: delete dives, merge dives, split selected dives, renumber dives and shift dive times. To do this after performing any of these actions, from the Main Menu select @@ -4013,8 +4058,10 @@ To do this after performing any of these actions, from the Main Menu

    -

    8. Exporting the dive log or parts of the dive log

    +

    7. Exporting the dive log or dive sites

    +
    +

    7.1. Exporting the dive log

    The export function can be found by selecting File → Export, which brings up the Export dialog. This dialog always gives two options: save ALL dives, or save only the dives selected in Dive List panel of Subsurface. Click the appropriate @@ -4033,6 +4080,12 @@ radio button (see images below).

  • +Subsurface dive sites XML. Export the dive sites in XML format. This allows the + sharing of dive sites with other divers or software. +

    +
    • +
  • +

    Universal Dive Data Format (UDDF). Refer to http://uddf.org for more information. UDDF is a generic format that enables communication among many dive computers and computer programs. @@ -4054,16 +4107,27 @@ Universal Dive Data Format (UDDF). Refer to http://uddf.org fo

  • -CSV dive details, that includes the most critical information of the dive +CSV summary dive details, that includes the most critical information of the dive profile. Included information of a dive is: dive number, date, time, buddy, - duration, depth, temperature and pressure: in short, most of the information - that recreational divers enter into handwritten log books. + duration, depth, temperature and atmospheric pressure: in short, most of the information + that recreational divers enter into handwritten log books. It does not include the dive profile.

  • -CSV dive profile, that includes a large amount of detail for each dive, including - the depth profile, temperature and pressure information of each dive. +CSV Dive computer dive profile, that includes a large amount of detail for each dive, including + the depth profile, temperature and pressure information of each dive. The source of the data + being saved are the data as downloaded from your dive computer. +

    +
    • +
  • +

    +CSV Computer Profile Panel daata. This option exports the information presented in the Profile Panel. + The Profile panel contains many calculated and interpolated values, e.g. SAC, + cylinder pressure, decompression ceilings, gas partial pressures and interpolated depths. These + data therefore differ from the raw dive information imported from a dive computer. This export option + is primarily intended to be accessible to external software for further processing of the Profile Panel + information.

  • @@ -4080,22 +4144,6 @@ Universal Dive Data Format (UDDF). Refer to http://uddf.org fo

  • -HTML format, in which the dive(s) are stored in HTML files, readable - with an Internet browser. Most modern web browsers are supported, but JavaScript - must be enabled. The HTML export cannot be changed or edited. - It contains most of the information recorded in the dive log. However, it does not show the - calculated values in the Dive Profile panel, e.g. dive ceiling, calculated cylinder pressure, gas - pressures and MOD. The HTML export contains a search - option to search the dive log. HTML export is specified on the second tab of the - Export dialog (image B above). A typical use of this option is to export all your - dives to a smartphone or a tablet where it would serve as a portable record - of dives, useful for dive companies wishing to verify the dive history of a diver, - and doing away with the need to carry an original logbook - when doing dives with dive companies. -

    -
    • -
  • -

    Worldmap format, an HTML file with a world map upon which each dive and some information about it are indicated. This map is not editable. If you select any of the dive sites on the map, a summary of the dive is available in text, as shown @@ -4151,6 +4199,23 @@ characters and GPS coordinates of dive sites are preserved as well.

    • +HTML. This export is provided by selecting the appropriate tab at the top of the panel. + The dive(s) are stored in HTML files, readable + with an Internet browser. Most modern web browsers are supported, but JavaScript + must be enabled. The HTML export cannot be changed or edited. + It contains most of the information recorded in the dive log. However, it does not show the + calculated values in the Dive Profile panel, e.g. dive ceiling, calculated cylinder pressure, gas + pressures and MOD. The HTML export contains a search + option to search the dive log. HTML export is specified on the second tab of the + Export dialog (image B above). A typical use of this option is to export all your + dives to a smartphone or a tablet where it would serve as a portable record + of dives, useful for dive companies wishing to verify the dive history of a diver, + and doing away with the need to carry an original logbook + when doing dives with dive companies. +

      +
      • +
    • +

      General Settings, under the HTML tab, provides the following options:

        @@ -4186,8 +4251,9 @@ Under Style Options some style-related options are available like font instance www.divelogs.de.

    +
    -

    9. Keeping a Subsurface dive log in the Cloud

    +

    8. Keeping a Subsurface dive log in the Cloud

    For each diver, dive log information is highly important. Not only is it a record of diving activities for your pleasure, but it’s important information required @@ -4203,23 +4269,26 @@ from the cloud is no more difficult than accessing the dives on the local hard d The only requirement is that you should first register as a user on the cloud. To use Subsurface cloud storage , follow these steps:

    -

    9.1. Create a cloud storage account

    +

    8.1. Create a cloud storage account

    • -Open the Network Preferences by selecting File → Preferences → Network. +Open the Cloud Preferences by selecting File → Preferences → Cloud. (See image of the +Clod Preference panel here).

    • In the section headed Subsurface cloud storage, enter an email address that - Subsurface can use for user registration. + Subsurface can use for user registration. This is the only step that requires an email address. +Subsurface will never use this email address again.

    • Enter a novel password that Subsurface will use to store the - dive log in the cloud. + dive log in the cloud. The password can comprise lower case letters, + numbers, plus(+), minus(-) and underscore(_).

    • @@ -4227,13 +4296,13 @@ Enter a novel password that Subsurface will use to store the Click Apply to send the above email address and password to the (remote) cloud server. The server responds by sending a verification PIN to the above email address (This is the only occasion that Subsurface uses the - email address provided above). The Network Preferences dialog now has a new PIN text + email address provided above). The Cloud Preferences dialog now has a new PIN text box, not visible previously.

    • -Enter the PIN in the corresponding text box in the Network Preferences dialog +Enter the PIN in the corresponding text box in the Cloud Preferences dialog (this field is only visible while the server is waiting for email address confirmation)

      @@ -4245,9 +4314,20 @@ will be marked as verified and the Subsurface cloud storage service is

    +
    +
    +
    + + + +
    +Important +If you encounter any problems during the cloud registration process, read the Cloud FAQ
    +
    +
    -

    9.2. Using Subsurface cloud storage

    +

    8.2. Using Subsurface cloud storage

    • @@ -4259,7 +4339,7 @@ cloud storage server.

    • -In the Defaults Preferences tab, you can select to use the Subsurface cloud +In the Dive Log Preferences tab, you can select to use the Subsurface cloud storage data as the default data file by checking the box marked Cloud storage default file. This means the data from the Subsurface cloud storage is loaded when Subsurface starts and saved there when Subsurface closes. @@ -4276,7 +4356,7 @@ connected to the Internet.

    -

    9.3. Web access to Subsurface cloud storage

    +

    8.3. Web access to Subsurface cloud storage

    One of the nice side benefits of using Subsurface cloud storage is that you can also access your dive data from any web browser. Simply open https://cloud.subsurface-divelog.org, @@ -4287,7 +4367,7 @@ shown in the Profile panel, including some cylinder pressures, deco ceilings and O2/He/N2 partial pressures.

    -

    9.4. Other cloud services

    +

    8.4. Other cloud services

    If you prefer not to use the integrated cloud storage of dive logs (and don’t need the web access), it’s simple to store dive logs in the cloud using several of the existing facilities on the @@ -4312,7 +4392,7 @@ Internet access is available.

    -

    10. Several Subsurface users on one desktop computer

    +

    9. Several Subsurface users on one desktop computer

    A frequent need is for two or more persons to use Subsurface on the same desktop computer. For instance members of a household may use the same computer or one family member may perform dive uploads for other @@ -4350,7 +4430,7 @@ user profile and settings, including unique cloud and Subsurface-Mobile

    -

    11. Printing a dive log

    +

    10. Printing a dive log

    Subsurface provides a simple and flexible way to print a whole dive log or only a few selected dives. Pre-installed templates or a custom written template can be used to choose where the data are fitted into the page.

    @@ -4491,7 +4571,7 @@ Below is a (rather small) example of the output for one particular page.

    -

    11.1. Writing a custom print template (advanced)

    +

    10.1. Writing a custom print template (advanced)

    Writing a custom template is an effective way to produce highly customized printouts. Subsurface uses HTML templates to render printing. You can create a template, export a new template, import an existing template and delete an existing template by using the appropriate buttons under the Template dropdown list in the print dialog. See APPENDIX E for information on how @@ -4500,7 +4580,7 @@ to write or modify a template.

    -

    12. Configuring a dive computer

    +

    11. Configuring a dive computer

    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, @@ -4554,70 +4634,32 @@ computer model from the panel on the left-hand (see image below).

    -

    13. Setting user Preferences for Subsurface

    +

    12. Setting user Preferences for Subsurface

    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: General, Units, Profile, Language, Network, and Georeference, +twelve panels: Display, Language, Units, Dive Download, Dive log, Equipment, +Media, Tech setup, Georeference, Cloud, Network and Reset, 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. General

    -

    There are several headings in the General panel:

    +

    12.1. Display

    +

    These settings control the screen display of Subsurface.

    -FIGURE: Preferences general page +FIGURE: Preferences: Display

    • -Lists and tables: Specify the font type and font size of the - Dive Table panel: decreasing the font size allows one to see more dives on a screen. -

      -
      • -
    • -

      -Dives: For the Default Dive Log File specify the directory and - file name of your - electronic dive log book. This is a file with filename extension of either .xml or .ssrf. When - launched, Subsurface will automatically load the specified dive log book. There are three options: -

      -
        -
      • -

        -No default file: When checked, Subsurface does not automatically load a dive log at startup. -

        -
        • -
      • -

        -Local default file: When checked, Subsurface automatically loads a dive log from the local hard disk. -

        -
        • -
      • -

        -Cloud storage default file: When checked, Subsurface automatically loads the dive log from the cloud - device that was initialized using the Preferences _Network tab (see below). -

        -
        • -
      -
      • -
    • -

      -Display invalid: Dives can be marked as invalid (when a user wishes to hide - dives that he/she doesn’t consider valid dives, e.g. pool dives, but still want to - keep them in the dive log). This controls whether those dives are displayed in - the dive list. -

      -
      • -
    • -

      -Default cylinder: From the dropdown list, select the default cylinder to be used in - the Equipment tab of the Notes panel. +Font for lists and tables: Specify the font type and font size of the + tabular data, e.g. Dive Table and Cylinder: decreasing the font size allows one to see more + information on a screen.

    • @@ -4631,28 +4673,30 @@ apply the new preferences, select Cancel.

    at all.

    -
  • -

    -Video thumbnails: In generating thumbnails for videos associated with dives, Subsurface - needs to have the appropriate information (see section on View Images). Three preferences need to be set - as explained in APPENDIX F. These are: a) switch on thumbnails, b) specify - the location of the ffmpeg program and c) set the place within video where the thumbnail needs - to be obtained from. -

    -
    • -
  • -

    -Clear all settings: As indicated in the button below this heading, all settings are - cleared and set to default values. -

    -
    • -

    13.2. Units

    +

    12.2. Language

    +

    Choose a language that Subsurface will use.

    -FIGURE: Preferences Units page +FIGURE: Preferences: Language +
    +
    +

    Check the System Default language i.e. the language of the underlying operating system +if this is appropriate. This is the default setting in Subsurface. +To change it, uncheck this checkbox and pick a language / country +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 panel also specify appropriate date and time formats for showing dive details.

    +
    +
    +

    12.3. Units

    +
    +
    +FIGURE: Preferences: Units

    Choose between metric and imperial units of depth, pressure, @@ -4667,17 +4711,160 @@ traditional coordinates (degrees, minutes, seconds) or as decimal degrees Choose the appropriate option.

    -

    13.3. Profile

    -

    This panel has three sections:

    -
    +

    12.4. Dive download

    +
    -FIGURE: Preferences Graph page +FIGURE: Preferences: Dive download +
    +
    +

    Subsurface remembers connections that are made with dive computers for downloading dives, shown as connection +buttons in the Dive download panel. This enables a user to establish a previously-used dive computer connection +by simply selecting one of the connection buttons. This is especially useful when using Bluetooth-equipped dive +computers that need to establish a Bluetooth connection each time a download is done. However, when using more +than one dive computer, several connection buttons are shown and this can be confusing. Delete all the connection +buttons by selecting the button marked "Delete all dive computer connections'. Clearing the connection buttons +requires that when the next download is done, a new connection needs to be established first.

    +
    +
    +

    12.5. Dive log

    +

    This panel controls many options for recording information in the log and for displaying +the log.

    +
    +
    +FIGURE: Preferences: Dive log +
    +
    +
      +
    • +

      +Default dive log file: For the Default Dive Log File specify the directory and + file name of your + electronic dive log book. This is a file with filename extension of either .xml or .ssrf. When + launched, Subsurface will automatically load the specified dive log book. There are three options: +

      +
        +
      • +

        +No default file: When checked, Subsurface does not automatically load a dive log at startup. +

        +
        • +
      • +

        +Local default file: When checked, Subsurface automatically loads a dive log from the local hard disk. + Specify the default file path and divelog name in the text box. +

        +
        • +
      • +

        +Cloud storage default file: When checked, Subsurface automatically loads the dive log from the cloud + device that was initialized using the _Cloud tab (see below). +

        +
        • +
      +
      • +
    • +

      +Display invalid dives: Dives can be marked as invalid (when a user wishes to hide + dives that he/she doesn’t consider valid dives, e.g. pool dives, but still want to + keep them in the dive log). This controls whether those dives are displayed in + the dive list. +

      +
      • +
    • +

      +Show tools for recording wave height, surge and chill during a dive. Some divers like to record + the sea conditions during a dive. Checking this checkbox allows these tools to be displayed + in the Information tab of the Info panel. The tools for visibility and current are always shown, + irrespective of whether this radio button has been checked or not. +

      +
      • +
    • +

      +Allow editing of water salinity: The Information tab has a tool for displaying the water salinity, i.e the type of + water dived in and its salinity. In the case of manually-entered dives, editing of water type is always active. + In some cases one may want to edit the water type of a dive derived from a dive log. For instance you left the dive computer + setting as "Salt water" while actually diving in an inland lake with fresh water. In this case you may wish to edit the + water type in the dive log and change it to Fresh water. Checking this checkbox allows editing of the water type + of a dive. If the water type of a dive differs from that of the dive computer setting during the dive, a warning is + shown to alert you. This does not indicate an error: it is just a useful indication that the water type has been edited. + IMPORTANT: Editing the water type does not change the information of depth, + partial pressures and deco ceiling values for that dive: the information from the dive computer is always used. + However, editing the water type gives a useful indication to a diver of what the water type really was during the dive. +

      +
      • +
    • +

      +Show mean depth: If this box is checked, the Dive Profile panel contains a grey line that shows + the mean depth of the dive, up to any time instant during the dive. Normally this is a u-shaped line indicating the deepest mean depth just before + ascent. +

      +
      • +
    +
    +
    +

    12.6. Equipment

    +

    This tab sets some dedault values relating to equipment.

    +
    +
    +FIGURE: Preferences: equipment +
    +
    +
      +
    • +

      +Default cylinder: From the dropdown list, select the default cylinder to be used in + the Equipment tab of the Notes panel. This makes it quicker to enter dive equipment + specifications in the Equipment tab. +

      +
      • +
    • +

      +Show unused cylinders: Checking this checkbox allows showing all cylinders entered for a dive + in the Cylinder Table of the Equipment tab, even if one or more cylinders were actually not used. +

      +
      • +
    +
    +
    +

    12.7. Media

    +

    This tab sets some defaults relating to photos or videos during dives.

    +
    +
    +FIGURE: Preferences: media +
    +
    +
      +
    • +

      +Update thumbnails: Photographs or videos are sometimes edited after being uploaded and linked to Subsurface. If + a photo is therefore more recent than its original thumbnail, checking this checkbox allows a new thumbnail to be created + after a photo or video has been edited. +

      +
      • +
    • +

      +Video thumbnails: In generating thumbnails for videos associated with dives, Subsurface + needs to have the appropriate information (see section on View Images). Three preferences need to be set + as explained in APPENDIX F. These are: a) switch on thumbnails, b) specify + the location of the ffmpeg program and c) set the place within video where the thumbnail needs + to be obtained from. +

      +
      • +
    +
    +
    +

    12.8. Tech setup

    +

    This tab sets common variables used for decompression calculations pertaining to technical diving.

    +
    +
    +FIGURE: Preferences: Tech setup

    • -Gas pressure display setup. Even though nitrogen and helium pressures are also included here, these items mainly pertain to oxygen management: +Gas pressure display setup. Even though nitrogen and helium pressures are also included here, +these items mainly pertain to oxygen management:

      • @@ -4735,7 +4922,7 @@ CCR Options: These options determine oxygen management for CCR dives:

      • Metabolic rate: this is the - volume of oxygen used by a diver during a minute. Set this value for pSCR dive planning + volume of oxygen used by a diver during a minute. Set this value for pSCR dive planning and decompression calculations.

        • @@ -4780,13 +4967,13 @@ CCR Options: These options determine oxygen management for CCR dives:

        • -VPM-B: Provide a conservatism level for calculating the VPM-B ceiling. Values between 0 +VPM-B: Provide a conservatism level for calculating the VPM-B ceiling. Values between 0 (least conservative) and 4 (most conservative) are valid.

        • -Bühlmann: Set the gradient factors (GFLow and GFHigh) for calculating the deco ceiling following +Bühlmann: Set the gradient factors (GFLow and GFHigh) for calculating 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 @@ -4812,81 +4999,38 @@ Bühlmann: Set the gradient factors (GFLow and GFHigh) for calculating

        -
      • -

        -Misc -

        -
          -
        • -

          -Show unused cylinders in Equipment Tab: This checkbox allows display of information about unused cylinders when viewing the -Equipment Tab. If this box is not checked, and if any cylinders entered using the Equipment Tab are not used (e.g. there -was no gas switch to such a cylinder), then these cylinders are omitted from that list. -

          -
          • -
        • -

          -Show mean depth: If this box is checked, the Dive Profile panel contains a grey line that shows - the mean depth of the dive, up to any time instant during the dive. Normally this is a u-shaped line indicating the deepest mean depth just before - ascent. -

          -
          • -
        -
    -

    13.4. Language

    -

    Choose a language that Subsurface will use.

    +

    12.9. Georeference

    -FIGURE: Preferences Language page +FIGURE: Georeference panel
    -

    Check the System Default language i.e. the language of the underlying operating system -if this is appropriate. This is the default setting in Subsurface. -To change it, uncheck this checkbox and pick a language / country -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 and time formats for showing dive details.

    +

    Subsurface provides a geo-lookup service (that is, given the coordinates of a dive site) derived from +a click on the Dive Map panel at the bottom right of the Subsurface window, or from a GPS instrument or from the Subsurface-Mobile app). A search on the Internet is done to find +the name of the closest known location. This function only works if Subsurface has an +Internet connection. The preference of the dive site name can be configured, e.g. Country/State/City +or City/State/Country.

    -

    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 when you want to communicate through a proxy.

    +

    12.10. Cloud

    +

    These setting allow storing the dive log in the digital cloud.

    -FIGURE: Preferences Network page +FIGURE: Cloud panel
    -

    This dialog has three sections:

    • -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 -password are required so that Subsurface can automatically pass -through the proxy server to access the Internet. This information is usually obtained -from your ISP. -

      -
      • -
    • -

      Subsurface cloud storage: To store your dive log in the cloud, a valid email address and password are required. This lets Subsurface email security information - regarding cloud storage to you, and to set up cloud storage appropriately. - Two additional options are given: -

      -
        -
      • -

        -Sync to cloud in the background: This option allows saving of dive information to the cloud storage - while you do other things within Subsurface. + regarding cloud storage to you, and to set up cloud storage appropriately. Detailed + instructions for registering + on the cloud server are provided in the Cloud preference panel (see above image), as well as in the section of this manual dealing with: + Keeping a Subsurface dive log in the cloud.

      • @@ -4896,27 +5040,47 @@ from your ISP.

      -
      • -
    -

    13.6. Georeference

    -

    Subsurface provides a geo-lookup service (that is, given the coordinates of a dive site) derived from -a click on the Dive Map panel at the bottom right of the Subsurface window, or from a GPS instrument or -from the Subsurface-Mobile app). A search on the Internet is done to find -the name of the closest known location. This function only works if Subsurface has an -Internet connection. The preference of the dive site name can be configured, e.g. Country/State/City -or City/State/Country (see image below).

    +

    12.11. 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 when you want to communicate through a proxy.

    -FIGURE: Georeference panel +FIGURE: Preferences Network page
    +

    Proxy server: A proxy server is a computer serving as a link between a user and the Internet. It +serves to protect the user from illegal access from users on the Internet to the desktop +computer of the user. Proxy servers are commonly used in a corporate environment. 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 +password are required so that Subsurface can automatically pass +through the proxy server to access the Internet. This information is usually obtained +from your ISP or your network technician.

    +
    +
    +

    12.12. Reset

    +
    +
    +FIGURE: Preferences: Reset defaults +
    +
    +

    Reset all preferences: Selecting the button in this panel will clear all the preference settings +in Subsurface and set them to default values. Since there are many settings, this is an action that is not lightly done, as it may take some time before all the preferences have been set to convenient values again. Resetting to default values also affects Internet and cloud access.

    +
      +
    • +

      +This brings us to the end of the section dealing with Subsurface Preferences. +

      +
      • +
    -

    14. The Subsurface dive planner

    +

    13. The Subsurface dive planner

    Dive planning is an advanced feature of Subsurface, accessed by selecting Log → Plan Dive from the main menu. It allows calculation of @@ -4972,7 +5136,7 @@ A user who is not absolutely sure about any of the above requirements should not

    -

    14.1. The Subsurface dive planner screen

    +

    13.1. The Subsurface dive planner screen

    Like the Subsurface dive log, the planner screen is divided into several sections (see image below). The setup parameters for a dive are entered into the sections on the left hand and bottom side of the screen. They are: Available Gases, Rates, Planning, Gas Options and Notes.

    @@ -4989,7 +5153,7 @@ any warning messages about the dive plan are printed.

    -

    14.2. Open circuit dives

    +

    13.2. Open circuit dives

    • @@ -5060,7 +5224,8 @@ Bot. MOD: the gas Maximum Operating Depth (MOD) if it is used as a bottom mix. A

      MND: the gas Maximum Narcotic Depth (MND). Automatically calculated based on the Best Mix END preference (default 30m / 98 ft). Editing this field will modify the He% according to the depth set. - Set to '*' to calculate the best He% for the dive maximum depth. + Set to '*' to calculate the best He% for the dive maximum depth. Depending on the checkbox, oxygen + is considered narcotic (the END is used) or not (the EAD is used).

    @@ -5095,7 +5260,7 @@ The most efficient way to create a dive profile is to enter the appropriate valu
    -

    14.2.1. Recreational dives

    +

    13.2.1. Recreational dives

    Recreational mode is intended for what most divers would call "recreational", "sports"or "nontechnical" dives, remaining within no-deco limits (NDL). It computes the maximum time a diver can stay at the current depth without needing mandatory decompression @@ -5211,14 +5376,14 @@ a larger safety margin.

    -

    14.2.2. Non-recreational open circuit dives, including decompression

    +

    13.2.2. Non-recreational open circuit dives, including decompression

    Non-recreational dive planning involves exceeding the no-deco limits and/or using multiple breathing gases. These dives are planned in three stages:

    a) Nitrogen management: This is done by specifying the rates for descent and ascent, as well as the deco model (GFLow, GFHigh or Conservatism level) under the headings Rates and Planning to the bottom left of the planning screen. Two deco models are supported the Bühlmann model and the VPM-B model. Select one of the two models. When selecting the Bühlmann model, the gradient factors (GFHigh and GFLow -need to be specified. Initially, the GFHigh and GFLow values in the Preferences +need to be specified. Initially, the GFHigh and GFLow values in the Tech setup preferences panel of Subsurface is used. If these are changed within the planner (see Gas Options within the planner), the new values are used without changing the original values in the Preferences. @@ -5485,10 +5650,10 @@ within the framework of your formal training to perform dive planning.

    -

    14.3. Planning pSCR dives

    +

    13.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 → Profile +The parameters of the pSCR dive can be set by selecting File → Preferences → Tech setup from the main menu, where the gas consumption calculation takes into account the pSCR dump ratio (default 1:8) as well as the metabolic rate. Specify the bottom and deco SAC rates. Here the SAC in the planner is the volume of gas per minute @@ -5510,7 +5675,7 @@ in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment.<

    -

    14.3.1. Planning for pSCR bailout

    +

    13.3.1. Planning for pSCR bailout

    @@ -5558,13 +5723,13 @@ columns, as in the cave example, above. See the example of bailout for a CCR div
    -

    14.4. Planning CCR dives

    +

    13.4. Planning CCR dives

    To plan a dive using a closed circuit rebreather, select the CCR option in the dropdown 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 → Profile from +

    Entering setpoints: Specify a default setpoint in the Preferences tab, by selecting File → Preferences → Tech setup 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 @@ -5582,7 +5747,7 @@ this is calculated for bail out ascents.

    Note that, in the Dive plan details, the gas consumption for a CCR segment is not calculated, so gas consumptions of 0 liters are the norm.

    -

    14.4.1. Planning for CCR bailout

    +

    13.4.1. Planning for CCR bailout

    -

    14.5. Modifying an existing dive plan

    +

    13.5. Modifying an existing dive plan

    Normally, when a dive plan has been saved, it is accessible from the Dive List, like any other dive log. Within the Dive List there is no way to change a saved dive plan. To change a dive plan, select it on the Dive List. Then, in the main menu, @@ -5635,7 +5800,7 @@ dives are considered two versions of the same dive and do not influence other each during decompression calculation (see next section).

    -

    14.6. Planning for repetitive dives

    +

    13.6. Planning for repetitive dives

    Repetitive dives can easily be planned if the dates and start times of the repetitive dive set are specified appropriately in the top left-hand Start Time field. Subsurface @@ -5652,7 +5817,7 @@ this configuration, highlight the template dive in the Dive List

    -

    14.7. Printing the dive plan

    +

    13.7. Printing the dive plan

    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.

    @@ -5663,7 +5828,7 @@ dive plan is to use the File → Print function on the main menu i same way as for dive logs or by copy and paste to a word processor.

    -

    14.8. Saving a dive with its dive plan

    +

    13.8. Saving a dive with its dive plan

    In the section dealing with dives using more than one dive computer we discussed the way in which multiple profiles for a single dive can be viewed using the left-arrow and right-arrow keyboard keys. A similar method can be used for saving a dive plan @@ -5701,7 +5866,7 @@ between the planned profile and the real-life profile using the right-arrow/left

    -

    15. Running Subsurface from the command-line

    +

    14. Running Subsurface from the command-line

    Subsurface can be launched from the command-line to set some specialised settings or as part of an script-based automated process for manipulating a dive log. The format for launching Subsurface from the @@ -5769,13 +5934,13 @@ cellspacing="0" cellpadding="4">

    -

    16. Description of the Subsurface Main Menu items

    +

    15. Description of the Subsurface Main Menu items

    This section describes the functions and operation of the items in the Main Menu of Subsurface. Several of the items below are links to sections of this manual dealing with the appropriate operations.

    -

    16.1. File

    +

    15.1. File

    • @@ -5811,7 +5976,7 @@ dealing with the appropriate operations.

  • -Cloud storage online - Switch between the online version of the logbook, and the locally stored one. +Cloud storage online - Switch between the online version of the logbook, and the locally stored one.

  • @@ -5843,7 +6008,7 @@ dealing with the appropriate operations.

  • -Configure dive computer - Edit the configuration of a dive computer. +Change settings on dive computer - Edit the configuration of a dive computer.

  • @@ -5854,7 +6019,7 @@ dealing with the appropriate operations.

    • -

    16.2. Edit

    +

    15.2. Edit

    • @@ -5864,7 +6029,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.

    -

    16.3. Import

    +

    15.3. Import

    • @@ -5880,6 +6045,11 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.

    • +Import dive sites: Import a XML dive site file that someone else shared with you. +

      +
      • +
    • +

      Import from Divelogs.de - Import dive information from www.Divelogs.de.

      @@ -5887,7 +6057,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.
    -

    16.4. Log

    +

    15.4. Log

    • @@ -5941,7 +6111,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.

    -

    16.5. View

    +

    15.5. View

    • @@ -5966,7 +6136,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.

    • -Globe - View only the World Map panel. +Map - View only the World Map panel.

    • @@ -5986,15 +6156,10 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives. Next DC - Switch to next dive computer.

      • -
    • -

      -Full Screen - Toggles Full Screen mode. -

      -
    -

    16.6. Help

    +

    15.6. Help

    • @@ -6024,10 +6189,10 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.

    -

    17. APPENDIX A: Operating system specific information for importing dive information from a dive computer.

    +

    16. APPENDIX A: Operating system specific information for importing dive information from a dive computer.

    -

    17.1. Make sure that the OS has the required drivers installed

    +

    16.1. Make sure that the OS has the required drivers installed

    @@ -5622,7 +5787,7 @@ overlapping icons.
    @@ -6052,7 +6217,18 @@ On Linux users need to have the correct kernel

    On Windows, the OS should offer to download the correct driver once the user connects the dive computer to the USB port and - operating system sees the equipment for the first time. + operating system sees the equipment for the first time. In some instances this + seems to fail, but regardless, every USB device (with the exception of HID devices + like the Suunto EON Steel family) needs a driver. For many divecomputer this means + downloading a cable specific driver (these tend to be for example FTDI, Silicon Labs, + or Prolific drivers). In other cases (for example for dive computers with a "real" USB + interface like the Atomics Cobalt) it is sufficient to have the WinUSB (or the libusbK) + driver installed. In current Windows versions the WinUSB binary is already part of Windows + and the "driver" is a simple inf file that tell Windows to use the WinUSB driver. But it + still needs to be "installed". Often it is sufficient to install the dive log app that is + provided by the dive computer vendor to trigger the driver installation. But in cases + where that doesn’t work, some googling to find the correct driver for a specific download + cable may be necessary.

  • @@ -6068,7 +6244,7 @@ On a Mac users sometimes have to manually hunt for the correct
    -

    17.2. How to Find the Device Name for USB devices and set its write permission

    +

    16.2. How to Find the Device Name for USB devices and set its write permission

    @@ -6176,7 +6352,7 @@ port, the dive computer interface can connect and you should be able to import dives.

    -

    17.3. Manually setting up Bluetooth enabled devices

    +

    16.3. Manually setting up Bluetooth enabled devices

    @@ -6076,7 +6252,7 @@ On a Mac users sometimes have to manually hunt for the correct When connecting a dive computer by using a USB connector, usually Subsurface will either propose a drop down list with the -correct device name (or mount point for the Uemis Zurich), or it will +correct device name or it will disable the device select drop down if no device name is needed at all. In the rare cases where this doesn’t work, here are some ways to find out what the device name is:
    @@ -6206,7 +6382,7 @@ manufacturer’s user guide. When using a Shearwater Predator/Petrel/Nerd, s
    -

    17.3.1. On Windows:

    +

    16.3.1. On Windows:

    Bluetooth is most likely already enabled. For pairing with the dive computer choose Control Panel → Bluetooth Devices → Add Wireless Device. This should bring up a dialog showing your dive computer (which should be in Bluetooth mode) and @@ -6219,7 +6395,7 @@ this COM port already. If not, enter it manually.

    other software, remove the existing pairing with the dive computer.

    -

    17.3.2. On MacOS:

    +

    16.3.2. On MacOS:

    Click on the Bluetooth symbol in the menu bar and select Set up Bluetooth Device…. The dive computer should then show up in the list of devices. Select it and go through the pairing process. This step should only be needed once for @@ -6228,7 +6404,7 @@ initial setup.

    Device or Mount Point drop-down in the Subsurface Import dialog.

    -

    17.3.3. On Linux

    +

    16.3.3. On Linux

    Be sure Bluetooth is enabled on the Subsurface computer. On most common distributions this should be true out of the box and pairing should be straightforward. For instance, Gnome3 shows a @@ -6437,48 +6613,10 @@ let the Subsurface developers know on the user forum or the developer mailing li

    -

    18. APPENDIX B: Dive Computer specific information for importing dive data.

    +

    17. APPENDIX B: Dive Computer specific information for importing dive data.

    -

    18.1. Importing from Uemis Zurich

    -
    - - - -
    -Note -Subsurface downloads the information -stored on the SDA (the built-in file system of the Uemis) including -information about dive spots and -equipment. Buddy information is not yet downloadable. -Things are very similar to a normal USB-connected dive computer -(the Uemis is one of those that recharge when connected to the USB port). -The main difference is that you don’t enter a -device name, but instead the location where the UEMISSDA file system is -mounted once connected to the dive computer. On Windows this is a drive letter ( -often E: or F:), on a Mac this is -/Volumes/UEMISSDA and on Linux systems this differs depending on the -distribution. On Fedora it usually is -/var/run/media/<your_username>/UEMISSDA. In all cases Subsurface -should suggest the correct location in the drop down list.
    -
    -

    After selecting the above device name, download the -dives from the Uemis Zurich. One technical issue with the Uemis Zurich -download implementation (this is a Uemis firmware limitation, not a -Subsurface issue) is that you cannot download more than about 40-50 -dives without running out of memory on the SDA. This will usually only -happen the very first time you download dives from the Uemis Zurich. -Normally when downloading at the end of a day or even after a dive -trip, the capacity is sufficient. If Subsurface displays an error -that the dive computer ran out of space, the solution is straightforward. -Disconnect the SDA, turn it off and on again, and reconnect -it. You can now retry (or start a new download session) and the -download will continue where it stopped previously. You -may have to do this more than once, depending on how many dives are -stored on the dive computer.

    -
    -
    -

    18.2. Importing from Uwatec Galileo

    +

    17.1. Importing from Uwatec Galileo

    @@ -6512,7 +6650,7 @@ available for OSX 10.6 or higher. In addition it is foreseen that the IrDA stack will be phased out in Linux. This is old technology and, even though it is currently more robust, fast and efficient than many other technologies such as Bluetooth, it is not fasionable. If IrDA communication is required for an operating system that does not support it, an easy solution is to run Subsurface in a virtual machine (VM) that contains support for IrDA. A VM (e.g. VMWare or vitualbox) can be installed on most modern operating systems. The only hardware setup required is to route the USB port of the host OS through to the guest OS.

    -

    18.3. Importing from Heinrichs Weikamp DR5

    +

    17.2. Importing from Heinrichs Weikamp DR5

    @@ -6530,7 +6668,7 @@ factors in the Profile Settings in Subsurface to generate a de
    -

    18.4. Importing from xDEEP BLACK

    +

    17.3. Importing from xDEEP BLACK

    @@ -6547,7 +6685,7 @@ factors in the Profile Settings in Subsurface to generate a de
    -

    18.5. Importing from Shearwater Predator/Petrel/Nerd using Bluetooth

    +

    17.4. Importing from Shearwater Predator/Petrel/Nerd using Bluetooth

    @@ -6558,7 +6696,7 @@ factors in the Profile Settings in Subsurface to generate a de
    -

    18.6. Importing from Poseidon MkVI Discovery

    +

    17.5. Importing from Poseidon MkVI Discovery

    @@ -6594,7 +6732,7 @@ Redbook format dive log (file with .cvsr extension). This is a compressed

    Subsurface accesses the .txt and the .csv files to get dive log information.

    -

    18.7. Importing from APD Inspiration/Evolution CCR

    +

    17.6. Importing from APD Inspiration/Evolution CCR

    @@ -6689,7 +6827,7 @@ by the APD equipment but can be manually entered in the Equipment Tab.<
    -

    19. APPENDIX C: Exporting Dive log information from external dive log software.

    +

    18. APPENDIX C: Exporting Dive log information from external dive log software.

    The import of dive log data from external dive log software is mostly performed using @@ -6715,7 +6853,7 @@ Import the accessible dive log data into Subsurface. data from foreign dive log software. The procedures below mostly apply to Linux and/or Windows.

    -

    19.1. Exporting from Suunto Divemanager (DM3, DM4 or DM5)

    +

    18.1. Exporting from Suunto Divemanager (DM3, DM4 or DM5)

    @@ -6884,7 +7022,7 @@ The dives are now exported to the file DM4.bak (or DM5.bak)
    -

    19.2. Exporting from Atomic Logbook

    +

    18.2. Exporting from Atomic Logbook

    -

    19.3. Exporting from Mares Dive Organiser V2.1

    +

    18.3. Exporting from Mares Dive Organiser V2.1

    @@ -6899,7 +7037,7 @@ be directly imported to Subsurface.
    @@ -6942,7 +7080,7 @@ The password for accessing the .zip file is mares.
    -

    19.4. Exporting from DivingLog 5.0 and 6.0

    +

    18.4. Exporting from DivingLog 5.0 and 6.0

    @@ -6990,7 +7128,7 @@ save the log file in Subsurface.

    -

    20. APPENDIX D: Exporting a spreadsheet to CSV format

    +

    19. APPENDIX D: Exporting a spreadsheet to CSV format

    Many divers keep a dive log in some form of digital file, commonly a spreadsheet with various fields of information. These logs can be easily imported into Subsurface after the @@ -7032,7 +7170,7 @@ GPS position: use decimal degrees, e.g. 30.22496 30.821798

    -

    20.1. LibreOffice Calc and OpenOffice Calc

    +

    19.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:

    @@ -7055,7 +7193,7 @@ 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.2. Microsoft Excel

    +

    19.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. @@ -7124,7 +7262,7 @@ explained on the section Importing CSV dives.

    -

    21. APPENDIX E: Writing a custom print template

    +

    20. APPENDIX E: Writing a custom print template

    Subsurface has a way to create or modify templates for printing dive logs to produce customized printouts of them. Templates written in HTML, as well as a simple @@ -7169,7 +7307,7 @@ Table) can be modified in this way. After completing the edits, use the Expo dialog to save the new template using a new template name.

    To write a custom template, the following elements must exist so the template will be correctly handled and rendered.

    -

    21.1. Main dive loop

    +

    20.1. Main dive loop

    Subsurface exports a dive list called (dives) to the Grantlee back end. It is possible to iterate over the list as follows: .template.html

    @@ -7188,7 +7326,7 @@ dialog to save the new template using a new template name.

    Additional information about Grantlee can be found here

    -

    21.2. Grantlee exported variables

    +

    20.2. Grantlee exported variables

    Only a subset of the dive data is exported:

    -

    21.3. Defined CSS selectors

    +

    20.3. Defined CSS selectors

    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.

    @@ -7468,7 +7606,7 @@ in flow layout templates only (when data-numberofdives = 0)

    -

    21.4. Special attributes

    +

    20.4. Special attributes

    There are two ways of rendering- either rendering a specific number of dives in each page or make Subsurface try to fit as many dives as possible into one page (flow rendering).

    The data-numberofdives data attribute is added to the body tag to set the rendering mode.

    @@ -7506,10 +7644,10 @@ render as much dives as possible:
    -

    22. APPENDIX F: Setting up video thumbnails.

    +

    21. APPENDIX F: Setting up video thumbnails.

    -

    22.1. Setting up the appropriate thumbnails for videos that are associated with dives.

    +

    21.1. Setting up the appropriate thumbnails for videos that are associated with dives.

    In handling video associated with dives, Subsurface needs to create a thumbnail for each video that can be shown either on the dive profile or in the Media tab. By default this is a nonspecific placeholder thumbnail. To see thumbnails that represent individual videos, Subsurface uses an external program calle FFmpeg. @@ -7532,7 +7670,7 @@ On Mac and Linux, make sure the ffmpeg command is in the path. This sho

  • -In the General tab of the Preferences, set the preferences for generating video thumbnails. This is achieved by: +In the Media tab of the Preferences, set the preferences for generating video thumbnails. This is achieved by:

    • @@ -7563,10 +7701,43 @@ of the video will be used.
    • -

    23. APPENDIX G: FAQs.

    +

    22. APPENDIX G: FAQs.

    -

    23.1. Subsurface appears to miscalculate gas consumption and SAC

    +

    22.1. Cloud FAQ

    +
    +

    22.1.1. After filling in the correct information and submitting it, I do not receive a PIN by email

    +
      +
    1. +

      +Check carefully that there is not a spelling mistake in the email address you provided. +

      +
      2. +
    2. +

      +Check that the return email containing the PIN is not in the SPAM folder of your email client. +

      +
      3. +
    3. +

      +Wait for 24 hours and check again for an email with a PIN. +

      +
      4. +
    4. +

      +If there is still no email containing a PIN, send mail to in-app-support@subsurface-divelog.org +

      +
      5. +
    +
    +
    +

    22.1.2. I want to access the Subsurface cloud facility but I have forgotten my password. How can I reset my password?

    +

    Open the following web address: https://cloud.subsurface-divelog.org/passwordreset

    +

    This will require that you enter the same email address that you used during cloud registration.

    +
    +
    +
    +

    22.2. Subsurface appears to miscalculate gas consumption and SAC

    Question: I dived with a 12.2 l tank, starting with 220 bar and ending with 100 bar, and I calculate a different SAC compared what Subsurface calculates. Is Subsurface miscalculating?

    Answer: Not really. What happens is that Subsurface actually calculates gas @@ -7597,7 +7768,7 @@ starts becoming much more noticeable at high pressure. A 400 bar really does not contain twice as much air as a 200 bar one. At lower pressures, air acts pretty much like an ideal gas.

    -

    23.2. Some dive profiles have time discrepancies with the recorded samples from my dive computer…

    +

    22.3. Some dive profiles have time discrepancies with the recorded samples from my dive computer…

    Subsurface ends up ignoring surface time for many things (average depth, divetime, SAC, etc). Question: Why do dive durations in my dive computer differ from that given by Subsurface?

    Answer: For example, if you end up doing a weight check (deep enough to trigger the "dive started") @@ -7609,7 +7780,7 @@ you may stay in the water for a long time, but spend most of it at the surface. you don’t want that to count as some kind of long dive”.

    -

    23.3. Some dive profiles are missing from the download

    +

    22.4. Some dive profiles are missing from the download

    Question: I cannot download all my dives, only the most recent ones, even though my dive computer’s manual states that it records history of e.g. 999 dives? @@ -7633,7 +7804,7 @@ cannot be salvaged after being overwritten by new dives.