USER MANUAL
Manual authors: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg, -Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat
Version 4.2, August 2014
From 22949a0004c062f9d2128b6726df8551fbf833e3 Mon Sep 17 00:00:00 2001
From: Dirk Hohndel USER MANUAL Manual authors: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg,
-Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat Version 4.2, August 2014 Version 4.4, February 2015 Welcome as a user of Subsurface, an advanced dive logging program with
extensive infrastructure to describe, organise, interpret and print scuba
and free dives. Subsurface offers many advantages over other similar
@@ -418,10 +418,16 @@ software solutions:
+Do you need a flexible way of logging dives using recreational equipment,
+ even not using a dive computer?
+
Do you use two different dive computer brands, each with its own proprietary
software for downloading dive logs? Do you dive with rebreathers as well
- as open circuit? Do you use a Reefnet Sensus time-depth recorder
- in conjunction with a dive computer? Subsurface offers a standard
+ as open circuit or recreational equipment? Do you use a Reefnet Sensus time-depth
+ recorder in conjunction with a dive computer? Subsurface offers a standard
interface for downloading dive logs from all these different pieces of
equipment and to store and analyse the dive logs within a unified system.
Do you use more than one operating system? Subsurface is fully compatible
with Mac, Linux and Windows, allowing you to access your dive log on each
- of your operating systems with a single application.
+ of your operating systems using a single application.
Do you use Linux or Mac and your dive computer has only Windows-based software
for downloading dive information (e.g. Mares)? Subsurface provides a way of
- storing and analysing your dive logs on other operating systems.
+ downloading and analysing your dive logs on other operating systems.
+
+Do you need an intuitive graphical dive planner that integrates with and takes
+ into account the dives that have already been logged?
When opened from within Subsurface, this manual does not have external controls. However, +a SEARCH function is important. This is activated by pressing control-F or command-F on +the keyboard. A text box appears at the bottom of the window. Use this to search for +any term in the manual.
In order to develop Subsurface in a way that serves its users in the best possible way, it is important to have some user information. Upon launching Subsurface @@ -476,7 +497,7 @@ command line.
The Subsurface window is usually divided into four panels with a Main Menu (File Import Log View Filter Help) at the top of the window (for Windows @@ -525,7 +546,7 @@ of the Dive Info panel (maximum, minimum and average depths, du temperatures and SAC; total time and number of dives selected).
The user can determine which of the four panels are displayed by selecting the @@ -548,51 +569,70 @@ following sections, the procedures to create a new logbook will be described.
Select File → New Logbook from the main menu. All existing dive data are +
Select File → New Logbook from the main menu. All existing dive data are cleared so that new information can be added. If there are unsaved data in an open logbook, the user is asked whether the open logbook should be saved before a new logbook is created.
There are several ways in which dive information can be added to a logbook:
Now that a new logbook was created, it is simple to add dive data to it. +Subsurface allows several ways of adding dive data to a logbook, detailed +in the following sections.
1) If the user has a handwritten divelog, a spreadsheet or another form of + manually maintained divelog, dive data can be added to the logbook using + one of these approaches:
-Enter dive information by hand. This is typically useful if the diver did not -use a dive computer and dives were recorded in a written logbook. +Enter dive information by hand. This is useful if the diver did not + use a dive computer and dives were recorded in a written logbook. See: + Entering dive information by hand
-Import dive information directly from a dive computer if it is supported by -Subsurface. The latest list of dive computers supported by Subsurface can -be found at: - -Supported dive computers. +Import dive log information that has been maintained either as a spreadsheet + or as a CSV file. Refer to: APPENDIX D: Exporting a spreadsheet to CSV format and + to Importing dives in CSV format. +
+2) If one has dives recorded using a dive computer, the depth profile of the + dive and a large amount of additional information can be accessed. These dives + can be imported from:
+The divecomputer itself. See: Importing new dive information from a Dive Computer or
-Import dive information from another database or file format. If you -have kept your dive logs with other log software, these logs can often -be imported to subsurface. This is discussed in more detail below. +Proprietary software distributed by manufacturers of dive computers. Refer + to: Importing dive information from other digital data sources or other data formats.
+Import from spreadsheet or CSV files containing dive profiles. + See: Importing dives in CSV format from dive computers or other dive log software +
+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, depth, the names of your dive buddy and of the dive master or dive guide, and some remarks about the dive. Subsurface can store much more information than this for each dive. In order to add a dive to a dive log, select Log -→ Add Dive from the Main Menu. The program then shows three panels to enter +→ Add Dive from the Main Menu. The program then shows three panels to enter information for a dive: two tabs in the Dive Info panel (Dive 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 @@ -600,21 +640,31 @@ of each dive. These panels are respectively marked A, < in the figure below. Each of these tabs will now be explained for data entry.
When one edits a field in Dive notes or Equipment panels, Subsurface enters Editing Mode, -indicated by the message in the blue box at the top of the Dive Notes panel. This message is +indicated by the message in the blue box at the top of the Dive Notes panel (see the image below). This message is displayed in all the panels under Dive notes and Equipment when in Editing Mode.
The Save button should only be selected after all the parts of a dive have been entered. +When entering dives by hand, the Info, Equipment and Profile tabs should be completed +before saving the information. By selecting the Save button, a local copy of the information +for this specific dive is saved in memory. When one closes Subsurface, the program will +ask again, this time whether the complete dive log should be saved on disk or not.
This panel contains the date, time and place information for a particular dive, environmental conditions, co-divers and buddies, as well as some descriptive information. If one clicks on the Dive Notes tab, the following fields are visible:
The Time field reflects the date and the time of the dive. By clicking @@ -640,25 +690,25 @@ here. These can come from three sources:
One can find the coordinates on the world map in the bottom right hand -part -of the Subsurface window. The map displays a green bar indicating "No location -data - Move the map and double-click to set the dive location". Upon a double-click -at the appropriate place, the green bar disappears and the coordinates are -stored. + part + of the Subsurface window. The map displays a green bar indicating "No location + data - Move the map and double-click to set the dive location". Upon a double-click + at the appropriate place, the green bar disappears and the coordinates are + stored.
The coordinates can be obtained from the Subsurface Companion app if the -user has an Android device with GPS and if the coordinates of the dive site -were stored using that device. -Click here for more information + user has an Android or iPhone device with GPS and if the coordinates of the dive site + were stored using that device. + Click here for more information
The coordinates can be entered by hand if they are known, using one of -four formats with latitude followed by longitude: + four formats with latitude followed by longitude:
Dive mode: This is a dropdown box allowing one to choose the type of dive +performed. The options are OC (Open Circuit, the default setting, meant for most recreational dives), +Freedive (dive without SCUBA equipment), CCR (Closed-circuit +rebreather) and pSCR (Passive semi-closed rebreather).
Divemaster: The name of the dive master or dive guide for this dive can be entered here. Again, this field offers auto completion based on the list of dive masters in @@ -705,12 +759,12 @@ until ALL other information has been added. Here is an example of a completed Dive Notes panel:
The Equipment tab allows the user to enter information about the type of cylinder and gas used, as well as the weights used for a dive. This is a highly interactive part of Subsurface and the information on @@ -720,7 +774,7 @@ cylinders and gases (entered here) affects the behaviour of the dive profile like this:
The + button at the top right allows the user to add more cylinders for this @@ -735,7 +789,7 @@ This brings up a button that can be used to display a dropdown list of cylinders:
The drop-down list can be used to select the cylinder type used @@ -760,7 +814,7 @@ is an example of a complete description for a dive made using two cylinders (air and EAN50):
Weights: Information about the weight system used during a dive can be entered @@ -769,14 +823,14 @@ clicks the + button on the top right of the weights dialogue, the table looks like this:
If one then clicks on the Type field, a drop-down list becomes accessible through a down-arrow:
The drop-down list can then be used to select the type of weight system or the user may start @@ -793,14 +847,14 @@ dustbin icon on the left hand. Here is an example of information for a dive with two types of weights: integrated and a weight belt:
There’s NO need to click the Save button before the dive profile has been completed.
The Dive Profile (a graphical representation of the depth of the dive as a function of time) is indicated in the panel on the top right hand of the Subsurface window. When a dive is manually added to a logbook, Subsurface @@ -808,7 +862,7 @@ presents a default dive profile that needs to be modified to best represent the dive being described:
Modifying the dive profile: When the cursor is moved around the dive profile, @@ -829,7 +883,7 @@ time duration for the dive. Below is a dive profile that represents a dive to 20 m for 30 min, followed by a 5 minute safety stop at 5 m.
Specifying the gas composition: The gas composition used is clearly indicated @@ -844,20 +898,20 @@ waypoint. Note that only the gases defined in the Equipment tab context menu.
Below is the profile of a dive to 20 m for 30 min and with a switch from air to +
Below is the profile of a dive to 25 m for 30 min and with a switch from air to EAN50 at the end of the duration at 20m. In this case the first cylinder in the Equipment tab contained air and the second cylinder contained EAN50.
The information entered in the Dive Notes tab, the Equipment tab as well as the Dive Profile can now be saved in the user’s logbook by using the two buttons @@ -870,9 +924,9 @@ once more to save the logbook with the new dive(s).
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 @@ -930,19 +984,20 @@ The dive computer should be placed into PC Communication mode.
-In Subsurface, from the Main Menu, the user must select Import → Import -From Dive Computer. -Dialogue A in the figure below appears: +In Subsurface, from the Main Menu, the user must select Import → Import + From Dive Computer. + Dialogue A in the figure below appears:
Dive computers tend to keep a certain number of dives in their memory, even -though these dives have already been imported to Subsurface. For that reason +though these dives have already been imported to Subsurface. For that reason, if +the divecomputer allows this, Subsurface only imports dives that have not been uploaded before. This makes the download process faster on most dive computers and also saves battery power of the dive computer (at least for those not charging while connected via USB). @@ -953,25 +1008,25 @@ even though some may already be in the logbook, then check the check box labelle
The dialogue has two drop-down lists, Vendor and Dive Computer. On the -vendor drop-down list select the make of the computer, e.g. -Suunto, Oceanic, -Uwatec, Mares. On the Dive Computer drop-down list, the model name of -the dive computer must be selected, e.g. D4 (Suunto), Veo200 (Oceanic), or Puck -(Mares). + vendor drop-down list select the make of the computer, e.g. + Suunto, Oceanic, + Uwatec, Mares. On the Dive Computer drop-down list, the model name of + the dive computer must be selected, e.g. D4 (Suunto), Veo200 (Oceanic), or Puck + (Mares).
The Device or Mount Point drop-down list contains the USB or Bluetooth port -name that Subsurface needs in order to communicate with the dive computer. -The appropriate port name must be selected. Consult -Appendix A -and -Appendix B -for technical details on how to find the appropriate port information for a -particular dive -computer and, in some cases, how to do the correct settings to the operating -system of the computer on which Subsurface is running. + name that Subsurface needs in order to communicate with the dive computer. + The appropriate port name must be selected. Consult + Appendix A + and + Appendix B + for technical details on how to find the appropriate port information for a + particular dive + computer and, in some cases, how to do the correct settings to the operating + system of the computer on which Subsurface is running.
+The checkbox marked Download into new trip ensures that, after upload, the downloaded dives + are grouped together as a new trip(s) in the Dive List.
Do not check the checkboxes labelled Save libdivecomputer logfile and - Save libdivecomputer dumpfile. These are only used as diagnostic tools - when problems with downloads are experienced (see below). + Save libdivecomputer dumpfile. These are only used as diagnostic tools + when problems with downloads are experienced (see below).
-The OK button must then be clicked. Dialogue B in the figure above -appears. +Then select the Download button. After successful download, Dialogue B + in the figure above appears.
With communication established, one can see how the data are -retrieved from the dive computer. -Depending on the make of the dive computer and/or number of recorded dives, this -could take some time. The user should be patient. The Download dialogue -shows a -progress bar at the bottom of the dialogue (for some dive computers the -progress information could be inaccurate as we cannot determine how much -downloadable data there is until all data have been downloaded). When the -download of the dive information is complete, all the imported dives appear -in the Dive List, sorted by date and time. Disconnect and -switch off the dive -computer to conserve its battery power. -If a particular dive is selected, the Dive Profile panel shows an informative -graph of dive depth against time for that particular dive. + retrieved from the dive computer. + Depending on the make of the dive computer and/or number of recorded dives, this + could take some time. Be patient. The Download dialogue + shows a + progress bar at the bottom of the dialogue (for some dive computers the + progress information could be inaccurate as we cannot determine how much + downloadable data there is until all data have been downloaded). When the + download of the dive information is complete, all the imported dives appear + in the Dive List, sorted by date and time. Disconnect and + switch off the dive + computer to conserve its battery power. + If a particular dive is selected, the Dive Profile panel shows an informative + graph of dive depth against time for that particular dive.
After the dives have been downloaded, they appear in a tabular format on the righthand +side of the dialogue (see image B, above). Each dive comprises a row in the table, with the date, duration +and depth shown. Next to each dive is a checkbox: check all the dives that need to +be transfered to the Dive List. In the case of the image above, the last six dives are +checked and will be transfered to the Dive List.
After this has been completed, select the OK button. +The checked dives are transfered to the Dive List.
If there is a problem in communicating with the dive computer, an error -message will be shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares -(Puck Pro)". Refer to the text in the box below. + message will be shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares + (Puck Pro)". Refer to the text in the box below.
Is the dive computer still in PC-communication or -Upload mode? + Upload mode?
Is the battery of the dive computer fully charged? If not then the battery -must be charged or replaced. + must be charged or replaced.
Is the connecting cable faulty? Does the cable work perfectly using other -software? Has it worked before, or is this the first time the cable is being used? Are the contacts -on the dive computer and the cable clean? + software? Has it worked before, or is this the first time the cable is being used? Are the contacts + on the dive computer and the cable clean?
Consult -Appendix A -and make sure that the correct Mount Point -was specified (see above). + Appendix A + and make sure that the correct Mount Point + was specified (see above).
On Unix-like operating systems, does the user have write permission to the -USB port? If not, consult -Appendix A + USB port? If not, consult + Appendix A
It may be necessary to distinguish between different dive computers used to upload dive logs to Subsurface. For instance if one’s partner’s dive computer is the same make and model as one’s own and dive logs are uploaded from both dive computers @@ -1125,32 +1195,33 @@ one would perhaps like to call one dc "Alice’s Suunto D4" and the other on dive computers of the same model, the logs of both (or all) being uploaded. In this case it might be prudent to call one of them "Suunto D4 (1)" and another one "Suunto D4 (2)". This is easily done in Subsurface. -On the Main Menu, select Log → Edit device names. A dialog opens, indicating the +On the Main Menu, select Log → Edit device names. A dialog opens, indicating the current Model, ID and Nickname of the dive computers used for upload. Edit the Nickname field for the appropriate dive computer. After saving the Nickname, the dive logs show the nickname for that particular device instead of the model name, allowing easy identification of devices.
The information from the dive computer is not complete and more -details must be added in order to have a fuller record of the dives. To -do this, +
With the uploaded dives in the Dive List, the information from the dive +computer is not complete and more details must be added in order to have +a fuller record of the dives. To do this, the Dive Notes and the Equipment tabs on the top left hand of the Subsurface window should be used.
The date and time of the dive, gas mixture and (often) water temperature is -shown as obtained from the dive computer, but the user needs to add some -additional information by hand in order to have a more complete dive record. +
The date and time of the dive, gas mixture and (often) water temperature are usually +shown as obtained from the dive computer, but the user needs to add +additional information by hand in order to have a more complete dive record. In a few cases, +(e.g. APD rebreathers) one also has to provide the date and time of the dive. If the contents of this tab is changed or edited in any way, the message in a blue box at the top of the panel indicates that the dive is being edited. If one clicks on the Dive Notes tab, the following fields are visible:
The Time field reflects the date and time of the dive. By clicking @@ -1179,25 +1250,25 @@ here. These can come from three sources:
The user can find the coordinates on the world map in the bottom right hand -part -of the Subsurface window. The map displays a green bar indicating "Move the map -and double-click to set the dive location". Double-click -at the appropriate place, the green bar disappears and the coordinates are -stored. + part + of the Subsurface window. The map displays a green bar indicating "Move the map + and double-click to set the dive location". Double-click + at the appropriate place, the green bar disappears and the coordinates are + stored.
The user can obtain the coordinates from the Subsurface Companion app if -an Android device with GPS was used and if the coordinates of the dive site -were stored using that device. -Click here for more information + an Android or iPhone device with GPS was used and if the coordinates of the dive site + were stored using that device. + Click here for more information
The coordinates can be entered by hand if they are known, using one of -four formats with latitude followed by longitude: + four formats with latitude followed by longitude:
Dive mode: This is a dropdown box allowing one to choose the type of dive +performed. The options are OC (Open Circuit, the default seting, meant for most recreational dives), +Freedive (dive without SCUBA equipment), CCR (Closed-circuit +rebreather) and pSCR (Passive semi-closed rebreather).
Divemaster: The name of the dive master or dive guide for this dive should be entered in this field which offers auto completion based on the list of dive masters in @@ -1248,18 +1323,18 @@ until ALL other information has been added. Here is an example of a completed Dive Notes panel:
The Equipment tab allows one to enter information about the type of cylinder and gas used as well as the weights used for the dive. The message in a blue box at the top of the panel:
indicates that the dive is being edited. This is a highly interactive part of @@ -1270,7 +1345,7 @@ cylinders and gases (entered here) determines the behaviour of the dive profile like this:
In most cases Subsurface obtains the gas used from the dive computer and @@ -1285,7 +1360,7 @@ brings up a list button that can be used to display a dropdown list of cylinders:
The drop-down list can then be used to select the cylinder type that was used @@ -1308,7 +1383,7 @@ button at the top right hand. Following is an example of a complete description for a dive using two cylinders (air and EAN50):
Weights: Information about the weight system used can be entered @@ -1318,14 +1393,14 @@ the + button on the top right of the weights dialogue, the table looks like this:
By clicking on the Type field, a drop-down list becomes accessible through a down-arrow:
The drop-down list can then be used to select the type of weight system @@ -1343,12 +1418,12 @@ the dustbin icon on the left hand. Here is an example of information for a dive with two types of weights: integrated as well as a weight belt:
METHOD 1: After uploading dives from a dive computer, the dive profiles of the uploaded dives are shown in the Dive profile tab, as well as a few items of information @@ -1372,23 +1447,24 @@ edited dive is changed, even though several dives have been selected in the Dive List. This greatly speeds up the completion of the dive log after several similar dives.
METHOD 2:There is a different way of achieving the same goal. Select a dive with all the appropriate information -typed into the Dive Notes and Equipment tabs. Then, from the main menu, select Log → Copy dive components. +typed into the Dive Notes and Equipment tabs. Then, from the main menu, select Log → Copy dive components. A box is presented with a selection of check boxes for most of the fields in the Dive Notes and Equipment tabs. Select the fields to be copied from the currently selected dive, then select OK. Now, in the Dive List, select the dives -into which this information is to be pasted. Then, from the main menu, select Log → Paste dive components. All the selected dives now contain the data initially selected in the original source dive log.
Many divers wish to annotate their dives with text that indicate particular events -during the dive, e.g. "Saw dolphins", or "Released surface bouy". This is easily +during the dive, e.g. "Saw dolphins", or "Released surface buoy". This is easily done:
Right-click at the appropriate point on the dive profile. -This brings up the dive profile context menu. Select Add bookmark. A red flag is -placed on the dive profile at the point that was initially selected (see A below). + This brings up the dive profile context menu. Select Add bookmark. A red flag is + placed on the dive profile at the point that was initially selected (see A below).
A text box is shown. Type the explanatory text for the bookmark (see C below). Select OK. -This saves the text associated with the bookmark. + This saves the text associated with the bookmark.
If one hovers using the mouse over the red bookmark, the appropriate text is shown at -the bottom of the information box (see D below). + the bottom of the information box (see D below).
The information entered in the Dive Notes tab and the Equipment tab can be saved by using the @@ -1430,7 +1506,7 @@ that the new data should be saved.
If a user has been diving for some time, it is possible that several dives were logged using other dive log software. This information does not need retyping because these dive logs can probably be @@ -1454,7 +1530,7 @@ them from there with Subsurface, as divelogs.de supports a few additional logbook formats that Subsurface currently cannot parse.
If the format of other software is supported natively on Subsurface, it should be sufficient to select -either Import→Import log files or File→Open log file. Subsurface supports the data formats +either Import → Import log files or File → Open log file. Subsurface supports the data formats of many dive computers, including Suunto and Shearwater. When importing dives, Subsurface tries to detect multiple records for the same dive and merges the information as best as it can. If @@ -1462,13 +1538,13 @@ there are no time zone issues (or other reasons that would cause the beginning time of the dives to be significantly different) Subsurface will not create duplicate entries.
Importing dives from other software is performed through a universal interface that is activated by selecting Import from the Main Menu, then clicking on Import Log Files. This brings up the dialogue A below.
Towards the bottom right is a dropdown selector with a default label @@ -1477,7 +1553,7 @@ available, as in dialogue B, above. Currently these are:
-XML-formatted dive logs (Divinglog 5.0, MacDive and several other dive log systems) +XML-formatted dive logs (DivingLog 5.0, MacDive and several other dive log systems)
-Poseidon CCR logs +Poseidon MkVI CCR logs
- - | -Closed system rebreathers use avanced technology to recirculate -gas that has been breathed while doing two things to maintain a -breathable oxygen concentration: -a) remove carbon dioxide from the gas that has been exhaled -b) regulate the oxygen concentration to remain within safe diving limits. -Currently, within Subsurface, the Poseidon MkVI Discovery is the best -supported CCR dive computer. The CCR interface of Subsurface is currently experimental -and under active development. In contrast to a conventional open circuit -dive computer, a CCR system computer does not allow the download of a log -containg multiple dives. Rather, each dive is stored independently. This -means that Subsurface cannot download a dive log directly from a CCR -dive computer, but that it imports CCR dive logs in the same way that it -imports dive log data from other databases. | -
See the section dealing with Importing dive information from other -digital sources. From the main menu of Subsurface, select Import→Import -log files to bring up the universal import dialogue. As -explained in the previous section, the bottom right -hand of the import dialogue contains a dropdown list of appropriate devices -that currently includes an option for MkVI files. Having selected the appropriate CCR format and -the directory where the original dive logs have been stored from the CCR dive -computer, one can select a particular dive log file (in the case of the MkVI -it is a file with a .txt extension). After selecting the appropriate dive log, -activate the Open button at the bottom right hand of the universal import dialogue.
Partial pressures of gases: The graph of oxygen partial pressure shows the -information from the oxygen sensors of the CCR equipment. In the case of the -Poseidon MKVI, the mean value of the two oxygen sensors are shown. In the case -of the APD equipment, the mean of the three oxygen sensors are shown. If one -sensor shows a very different oxygen PO2 reading compared to the others, the -divergent sensor is ingnored. For CCR dives the graph for oxygen partial pressure -should be fairly flat, reflecting the setpoint settings during the dive. -Partial pressures for nitrogen (and helium, -if applicable) are shown in the usual way as for other dives.
Cylinder pressures: CCR dive computers like the Poseidon MkVI record the -pressures of the oxygen and diluent cylinders. The pressure of the oxygen cylinder -is shown on the dive profile. In addition, start and end pressures for both oxygen -and diluent cylinders are shown in the Equipment Tab.
Equipment-specific information: Equipment-specific information gathered by -Subsurface is shown in the Extra data tab. This may include setup information -or metadata about the dive.
More equipment-specific information for downloading CCR dive logs can be found in Appendix B.
Since Mares utilise proprietary Windows software not compatible with multi-platform applications, these dive logs cannot be directly imported into @@ -1582,33 +1602,33 @@ using www.divelogs.de as a mechanism to extract the dive log informatio
The dive log data from Mares Dive Organiser need to be exported to the user’s -desktop, using - a .sdf file name extension. Refer to Appendix C for more -information. + desktop, using + a .sdf file name extension. Refer to Appendix C for more + information.
Data should then be imported into www.divelogs.de. One needs to create a user -account in -www.divelogs.de, log into that web site, then -select Import Logbook → Dive Organiser from the menu on the left hand side. -The instructions must be carefully followed to transfer the dive information -(in .sdf format) from the Dive Organiser database to www.divelogs.de. + account in + www.divelogs.de, log into that web site, then + select Import Logbook → Dive Organiser from the menu on the left hand side. + The instructions must be carefully followed to transfer the dive information + (in .sdf format) from the Dive Organiser database to www.divelogs.de.
Finally, import the dives -from divelogs.de to Subsurface, using the instructions below. + from divelogs.de to Subsurface, using the instructions below.
The import of dive information from divelogs.de is simple, using a single -dialogue box. The Import→Import form Divelogs.de option should be selected +dialogue box. The Import → Import from Divelogs.de option should be selected from the Main Menu. This brings up a dialogue box (see figure on left [A] below). Enter a user-ID and password for divelogs.de into the appropriate fields and then @@ -1625,167 +1645,208 @@ success status is indicated (see figure on the right [B], below
Sometimes dive computers export dive information as files with -comma-separated values (.CSV). For example, the APD Inspiration and Evolution -closed circuit rebreather (CCR) systems export dive information in a CSV -formatted file that normally contains information for a single dive only. These -files can easily be imported into Subsurface. -CSV files are normally organised into -a single line that provides the headers of the data columns, followed by the -data, one record per line. CSV files can be opened with a normal text editor. -Following is a highly simplified and shortened example of a CSV file from an -APD rebreather:
Dive Time (s) Depth (m) pO₂ - Setpoint (Bar) pO₂ - C1 Cell
-1 (Bar) Ambient temp. (Celsius)
- 0 0.0 0.70 0.81 13.1
- 0 1.2 0.70 0.71 13.1
- 0 0.0 0.70 0.71 13.1
- 0 1.2 0.70 0.71 13.2
- 0 1.2 0.70 0.71 13.1
- 10 1.6 0.70 0.72 12.7
- 20 1.6 0.70 0.71 12.6
- 30 1.7 0.70 0.71 12.6
- 40 1.8 0.70 0.68 12.5
- 50 1.6 0.70 0.68 12.5
- 60 2.4 0.70 0.69 12.5
- 70 3.5 0.70 0.69 12.4
- 80 4.2 0.70 0.72 12.5
- 90 4.0 0.70 0.71 12.4
-Note that each title may comprise more than one word; for instance -Dive Time (s) in the above data example. Before being able to import the data -to Subsurface one first needs to know:
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 +simplified format that allows for easy information exchange between different computers or +software packages. For an introduction to CSV-formatted files see A Diver’s +Introduction To CSV Files. Subsurface dive logs can also be exported in CSV format to +other software that reads this format. See APPENDIX D: Exporting a spreadsheet +to CSV format for information that may be helpful for importing spreadsheet-based data +into Subsurface.
One can view a CSV file by using an ordinary text editor. It is normally organised into +a single line that provides the headers (or field names or column headings) of the data +columns, followed by the data, one record per line.
There are two types of CSV dive logs that can be imported into Subsurface:
-Which character separates the different columns within a single line of -data? This field separator should be either a comma (,) or a TAB character. -This can be determined by opening the file with a text editor. If it is -comma-delimited, then the comma -characters between the values are clearly visible. If no commas are evident and -the numbers are aligned in columns, -the file is probably TAB-delimited (i.e. it uses a TAB as a field separator, as -in the above example). +CSV dive details: This dive log format contains similar information to that of a + typical written dive log, e.g. dive date and time, dive depth, dive duration, names of + buddy and dive master and perhaps some information about cylinder pressures before and + after the dive, as well as a comment or two about the dive. All the data for a single + dive go on a single line of text, following the order of the column headings.
-Which data columns need to be imported into Subsurface? The Dive Time and -Depth columns are always required. Open the file using a text editor and note -the titles of the columns to be imported and their column positions. For -instance for the above example: +CSV dive profile: This dive log format includes much more information about a single + dive. For instance there may be information at 30-second intervals, indicating depth, water + temperature at that depth, and cylinder pressure at that moment in time. Each line contains + the information for a single instant in time during the dive, 30 seconds after that + of the previous instant. Many lines + are required to complete the depth profile information for a single dive. This is a common + export format used by closed-circuit rebreather (CCR) dive equipment and many software + packages that handle dive computer data and/or dive logs.
-Time: column 1
-Depth: column 2
-Temperature: column 5
-pO₂: column 4
-Armed with this information, importing the data into Subsurface is -straightforward. Select -Import→Import Log Files from the main menu. In the resulting file -selection menu, select CSV files, after which a common configuration dialog -appears for all the -files with a CSV extension:
There are pre-configured definitions for some dive computers, e.g. the APD -rebreathers. If the user’s dive computer is on this list, it should be selected -using the dropdown -box labeled Pre-configured imports. Select the button at the bottom right -to indicate whether the dive data are in metric of imperial units. -Finally OK should be clicked and -the dive will be imported and listed in the Dive List tab of Subsurface.
If the dive computer is not on the pre-configured list, the user must -select the Field -Separator (TAB or comma) for the particular CSV file, using the appropriate -dropdown list. and indicate which columns in the CSV file -contain which data -variables. For each data column used for import, the user must check the -appropriate check box -and indicate in which column these data are found. For instance, the image above -corresponds to the dialogue that would apply to the CSV data set described above -the image. After completing the column specification, select the OK button -and the dive will be imported and listed in the Dive List tab of Subsurface.
If one keeps dive logs in a spreadsheet, there is an option to import -those dives as well. Spreadsheet data, exported as a CSV file, can -be imported to Subsurface. When importing manually -kept log files, the information needed is quite different as we are -importing only metadata, not profile samples.
Similarly to importing dives in CSV format (see above), one needs to -know the internal format -of the CSV data to import.
Before being able to import the CSV data to Subsurface one needs to know a few +things about the data being imported:
Which character separates the different columns within a single line of -data? This -should be either a comma (,), semicolon (;) or a TAB -character, and could be determined by opening the file with a text -editor. If it is comma-delimited, then the comma -characters between the values are clearly visible. If no commas are evident and -the data -are in clear columns, the file -is probably TAB-delimited (i.e. it uses a TAB as a field separator, as in the -above example). -A recommended field separator for the export is tab, as commas might be part of -the -field values themselves. Therefore the use of an appropriate field separator -in very important. + data? This field separator should be either a comma (,) or a TAB character. + This can be determined by opening the file with a text editor. If it is + comma-delimited, then the comma + characters between the values are clearly visible. If no commas are evident and + the numbers are aligned in columns, + the file is probably TAB-delimited (i.e. it uses a TAB as a field separator).
-Which columns need to be imported into Subsurface? We do not -currently have any mandatory input fields, but some, e.g. dive duration -are crucial for the log file to make any sense. Possible options -can be seen in the image below and one should include all the -fields available in both your log file and in the Subsurface -import. +Which data columns need to be imported into Subsurface? Is it a CSV dive details + file or a CSV dive profile file? Open the file using a text editor and note + the titles of the columns to be imported and their column positions.
-Units used for depth, weight and temperature. We consider depth to be -either feet or meters, weight kilograms or pounds and temperature either -Celsius or Fahrenheit. However, the users can select Metric or -Imperial in the Preferences tab of Subsurface. No mixture of unit -systems is allowed for the different fields. +Is the numeric information (e.g. dive depth) in metric or in imperial unis?
Importing manually kept CSV log files is quite straight forward, but -there might be many fields and counting the field numbers is error -prone. Therefore validation of the data to be imported is critical.
To import the dives, select Import→Import Log Files from the menu -bar. If the CSV option in the dropdown list is selected and the file list -includes file names ending with .CSV, one can select the -Manual dives tab that will bring up the following configuration dialog:
Armed with this information, importing the data into Subsurface is +straightforward. Select +Import → Import Log Files from the main menu. In the resulting file +selection menu, select CSV files (towards the bottom right). This shows all .CSV files in the selected +directory. Select the file that needs to be imported. A configuration panel +appears as depicted below:
Notice that, at the top left, there is a dropdown list containing pre-configured +settings for some of the more common dive computers and software packages +encountered by divers. If the CSV file being imported originated from any of +these pre-configured items, then select it. Otherwise use the Manual Import +option. The configuration panel also has dropdown lists for the specification of the appropriate +field separator (Tab, comma or semicolon), the date format used in the CSV file, +the time units (seconds, minutes or minutes:seconds), as well as the unit system +(metric or imperial). Selecting the appropriate options among these is critical for +the successful import of the data.
The last remaining task is to ensure that all the data columns have the appropriate +column headings. The top line of the white part of the data table contains the column +headings found in the CSV data file. The blue row of cells immediately above these +contains the names understood by Subsurface. The white area below the dropdown +lists contains all the field names that Subsurface recognises. These names are +in blue balloons and can be moved using a drag-and-frop action. For +instance, Subsurface expects the column heading for Dive number (" # ") to be "Dive # ". If +the column heading that Subsurface expects is not in the blue cells, then drag the +appropriate column heading from the upper area and drop it in the appropriate blue +cell at the top of the table. To indicate the correct column for "Dive #", drag +the ballooned item labelled "Dive # " and drop it in the blue +cell immediately above the white cell containing " # ". This is depicted in +the image below.
Continue in this way to ensure that all the column headings in the blue row of +cells correspond to the headings listed in the top part of the dialogue. Having +completed this task, select the OK button to the bottom right og the dialogue. +The data from the CSV file are imported and shown in the Dive List panel.
+ + | +The CSV import has a couple of caveats. One should avoid some special characters +like ampersand (&), less than (<), greater than (>) and double quotes (") as part +of the numbers or text within a cell. The +file should use UTF-8 character set, if using non-ASCII characters. Also the +size of the CSV file might cause problems. Importing 100 dives at a time +(CSV dive details) works, but larger files might exceed +limits of the parser used. When encountering problems with CSV imports, first try with +a smaller file to make sure everything works. | +
The input fields can be configured as appropriate, and when everything is done -the OK button should be selected to perform the import. New dives should -appear in the Dive List area of Subsurface.
Using the Subsurface Companion App on an Android device with a GPS, the coordinates +
Using the Subsurface Companion App on an Android device with a GPS or +iPhone, the coordinates for the diving location can be automatically passed to the Subsurface dive log. The Companion App stores the dive locations on @@ -1793,49 +1854,49 @@ a dedicated Internet-based file server. Subsurface, in turn, can collec the localities from the file server.
To do this:
Register on the Subsurface companion web page. -A confirmation email with instructions and a personal DIVERID will be sent, -a long number that gives access to the file server and Companion App capabilities. + A confirmation email with instructions and a personal DIVERID will be sent, + a long number that gives access to the file server and Companion App capabilities.
Download the app from -Google Play Store -or from -F-Droid. + Google Play Store + or from + F-Droid.
On first use the app has three options:
Create a new account. Equivalent to registering in Subsurface companion -page using an Internet browser. One can request a DIVERID using this option, -but this is supplied via email and followed up by interaction with the -Subsurface companion web page in order to -activate the account. + page using an Internet browser. One can request a DIVERID using this option, + but this is supplied via email and followed up by interaction with the + Subsurface companion web page in order to + activate the account.
Retrieve an account. If users forgot their DIVERID they will receive an email -to recover the number. + to recover the number.
Use an existing account. Users are prompted for their DIVERID. The app saves -this DIVERID and does not ask for it again unless one uses the Disconnect menu -option (see below). + this DIVERID and does not ask for it again unless one uses the Disconnect menu + option (see below).
Current: A prompt for a place name (or a request to activate the GPS if it is turned -off) will be displayed, after which the current location is saved. + off) will be displayed, after which the current location is saved.
Use Map: This option allows the user to fix a position by searching a world map. A -world map is shown (see B below) on which one should indicate the desired position -with a long press on the touch -sensitive screen (if the marked location is erroneous, simply indicate a new location) -and select the check symbol in the upper right. A dialog is shown allowing to enter the -name of the dive location and the date-time of the dive (see C below). In order to import this -dive location in Subsurface it’s advisable to set the time to agree with the time of -that dive on the dive computer. + world map is shown (see B below) on which one should indicate the desired position + with a long press on the touch + sensitive screen (if the marked location is erroneous, simply indicate a new location) + and select the check symbol in the upper right. A dialog is shown allowing to enter the + name of the dive location and the date-time of the dive (see C below). In order to import this + dive location in Subsurface it’s advisable to set the time to agree with the time of + that dive on the dive computer.
Import local GPX file: The android device searches for .gpx files and located -archives will be shown. The selected .gpx file is opened and the stored -locations shown. Now one needs to select the appropriate locations, then select the -tab in the upper right, after which the locations will be sent to the web service -and added to the list on the Android device. + archives will be shown. The selected .gpx file is opened and the stored + locations shown. Now one needs to select the appropriate locations, then select the + tab in the upper right, after which the locations will be sent to the web service + and added to the list on the Android device.
User ID. The DIVERID obtained by registering as described above. The easiest way to -obtain it is simply to copy and paste from the confirmation email but, of -course, users can also type this information. + obtain it is simply to copy and paste from the confirmation email but, of + course, users can also type this information.
Synchronize on startup. If selected, dive locations in the Android device and those -on the web service synchronise each time the app is started. + on the web service synchronise each time the app is started.
Upload new dives. If selected, each time the user adds a dive location it is -automatically sent to the server. + automatically sent to the server.
Min duration. In minutes. The app will try to get a location every X minutes -until stopped by the user. + until stopped by the user.
The iPhone interface is quite simple. One needs to type the user ID (obtained +during registration) into the space reserved for it, then select "Dive in" +(see left part of the image below) and start collecting dive location information.
Dives can be added automatically or manually. In manual mode, a dive location or waypoint is added to the GPS input stream. In automatic mode, a continuous path of GPS locations is created from which, much later, after import, subsurface can select the appropriate GPS locations based on the times of dives. The default mode for the iphone is automatic. When one adds a dive, the +location service is started automatically and a red bar appears at the bottom +of the screen. After the dive one can click on the red +bar to end the location service. While the location +service is running one can only add dives using the manual mechanism.
One can edit the site name afterwards by selecting the dive +from the dive list and clicking on the site name. There are no other +editable fields. The dive list is automatically uploaded from the iphone +to the webservice and there is not an option to +trigger upload manually.
Download dive(s) from a dive computer or enter them manually into Subsurface before obtaining the GPS coordinates from the server. The download dialog can be reached via Ctrl+G or from the Subsurface Main Menu Import @@ -2121,43 +2203,43 @@ downloading GPS data.
Background service, being a very powerful tool, may fill the location list with -many unnecessary locations not corresponding to the exact dive point but reflecting the boat’s route. -Currently these locations are difficult to delete from the server. In some situations it -is therefore prudent to clean up the list on the Android device before sending the dive points to the web -server by simply deleting the inappropriate locations. This might be necessary, for -instance, if one wants to keep the location list clear to see dives in the web service map display (see above). + many unnecessary locations not corresponding to the exact dive point but reflecting the boat’s route. + Currently these locations are difficult to delete from the server. In some situations it + is therefore prudent to clean up the list on the Android device before sending the dive points to the web + server by simply deleting the inappropriate locations. This might be necessary, for + instance, if one wants to keep the location list clear to see dives in the web service map display (see above).
It may also make sense to give informative names to the locations sent to the web server, or at least -to use an informative name in the Name Template setting while running the background service, -especially on a dive trip with many dives and dive locations. + to use an informative name in the Name Template setting while running the background service, + especially on a dive trip with many dives and dive locations.
Many (if not most) divers take a camera with them and take photographs during a dive. One would like to associate each photograph with a specific dive. Subsurface allows one to load photos into a dive. Photos are superimposed on the dive profile, from where they can be viewed.
Left-lick on a dive or on a group of dives on the dive list. Then right-click on this dive or group of dives and choose the option Load Images:
The system file browser appears. Select the folder and photographs that need to be loaded into Subsurface and click the Open button.
This brings one to the time synchronisation dialog, shown below. The @@ -2172,42 +2254,42 @@ the dive profile.
Manually: If the user wrote down the exact camera time at the start of a dive, the -difference in time between the two devices can be determined. Actually, as long as the device -settings for time has not been changed in either device, one could write down the times of -both devices after the dive or even at the end of the day. One can then manually set the time -difference in the Time shift dialog. Towards the top of the dialog is a time setting tool -immediately under the heading Shift times of image(s) by, evident in figure A below. -If the camera time is 7 minutes later than that of the dive computer, set the time setting -tool to a value of 00:07. Select either the earlier or later radio button. -In the above example, the earlier option is appropriate, since the photos need to be shifted -7 minutes earlier (camera is 7 minutes ahead of dive computer). Ignore any "AM" or "PM" suffix -in that tool. Click the OK button and synchronisation is achieved. + difference in time between the two devices can be determined. Actually, as long as the device + settings for time has not been changed in either device, one could write down the times of + both devices after the dive or even at the end of the day. One can then manually set the time + difference in the Time shift dialog. Towards the top of the dialog is a time setting tool + immediately under the heading Shift times of image(s) by, evident in figure A below. + If the camera time is 7 minutes later than that of the dive computer, set the time setting + tool to a value of 00:07. Select either the earlier or later radio button. + In the above example, the earlier option is appropriate, since the photos need to be shifted + 7 minutes earlier (camera is 7 minutes ahead of dive computer). Ignore any "AM" or "PM" suffix + in that tool. Click the OK button and synchronisation is achieved.
By photograph: There is a very slick way of achieving synchronisation. If one takes a -photograph of the face of the dive computer showing the time, then Subsurface can obtain -the exact time the photograph was taken, using the metadata that the camera stores within -each photo. In order to do this, use the bottom half of the Time shift_ dialog. If one uses -the bottom part, the top part of the dialog is ignored. Click on -the horizontal bar entitled "Select image of divecomputer showing time. This brings up -a file browser with which one can select the photograph of the dive computer. Select the -photograph using the file browser and click on OK. This photograph of the dive computer -appears in the bottom panel of the Shift times dialog. Now Subsurface knows exactly -when the photograph has been taken. Now set the date-time dialog to the left of the photo -so that this tool reflects the date and time of the dive computer in the photo. When the -date-time tool has been set, Subsurface knows exactly what the time difference between -camera and dive computer is, and synchronisation is achieved. There is a -photograph with the face of the dive computer and with the date-time tool set to the -date-time on image B above. + photograph of the face of the dive computer showing the time, then Subsurface can obtain + the exact time the photograph was taken, using the metadata that the camera stores within + each photo. In order to do this, use the bottom half of the Time shift_ dialog. If one uses + the bottom part, the top part of the dialog is ignored. Click on + the horizontal bar entitled "Select image of divecomputer showing time. This brings up + a file browser with which one can select the photograph of the dive computer. Select the + photograph using the file browser and click on OK. This photograph of the dive computer + appears in the bottom panel of the Shift times dialog. Now Subsurface knows exactly + when the photograph has been taken. Now set the date-time dialog to the left of the photo + so that this tool reflects the date and time of the dive computer in the photo. When the + date-time tool has been set, Subsurface knows exactly what the time difference between + camera and dive computer is, and synchronisation is achieved. There is a + photograph with the face of the dive computer and with the date-time tool set to the + date-time on image B above.
In order to view the photos added to a dive, activate the show-photos button in the tool bar to the left of the dive profile:
After the images have been loaded, they appear in two places:
If one hovers with the mouse over any of the photo icons, then a thumbnail photo is shown of the appropriate photo. See the image below:
Clicking on the thumbnail brings up a full size @@ -2258,12 +2340,12 @@ is required when clicking on a thumbnail. Images can also be deleted using the Photos tab (see text below).
Photographs associated with a dive are shown as thumbnails in the Photos tab of the Dive Notes panel. Photos taken in rapid succession during a dive (therefore sometimes with large overlap on the dive profile) can easily be accessed in the Photos tab. This tab serves as @@ -2275,7 +2357,7 @@ it (single-click) and then by pressing the Del key on the keyboard. Thi from the Photos tab as well as the dive profile.
Most underwater photographers store their photos on an external drive. If such a drive can be mapped (almost always the case) the photos can be directly accessed by Subsurface. This facilitates the interaction between Subsurface and an external repository of photos. When associating a dive profile with photos from an @@ -2287,13 +2369,202 @@ In addition the Photos tab only shows the file names of the photos. Thi If, later, the external drive with the photos is connected again, the photos can be seen in the normal way.
Subsurface easily handles dives involving more than one cylinder. Sidemount dive logging involves +three steps:
+During the dive, recording cylinder switch events. Since sidemount diving normally involves two + cylinders with air or with the same gas mixture, Subsurface distinguishes among these different + cylinders. In contrast, most dive computers that allow gas switching only distinguish among different + gases used, not among different cylinders used. This means that when sidemount dives are downloaded + from these dive computers, the events of switching between cylinders with the same gas are not downloaded. This may mean + that one may have to keep a written log of cylinder switch times using a slate, or (if the dive computer + has this facility) marking each cylinder switch with a bookmark that can be retrieved later. Returning + from a dive with the information about cylinder changes is the only tricky part of logging sidemount dives. +
++Within Subsurface describe the cylinders used during the dive. The diver needs to provide the + specifications of the different cylinders, using the Equipment tab of the Dive Info Panel (see + image below where two 12 litre cylinder were used). +
++Indicate cylinder change events on the Subsurface dive profile. Once the dive log has been imported + from a dive computer into Subsurface, the cylinder switch events need to be indicated on the dive profile. + Cylinder changes are recorded by right-clicking at the appropriate point on the dive profile and then + selecting Add gas change. A list of the appropriate cylinders is shown with the + currently used cylinder greyed out. In the image below Tank 1 is greyed out, leaving only Tank 2 + to be selected. Select the appropriate cylinder. The cylinder change is then indicated on the dive + profile with a cylinder symbol. If the Tank Bar is activated using the toolbar to the left of the + profile, then the cylinder change is also indicated on the Tank Bar (see image below). After all + the cylinder change events have been recorded on the dive profile, the correct cylinder pressures + for both cylinders are shown on the dive profile, as inthe image below. +
+This section gives an example of the versatility of Subsurface as a give logging tool.
+ + | +Closed system rebreathers use advanced technology to recirculate +gas that has been breathed while doing two things to maintain a +breathable oxygen concentration: +a) remove carbon dioxide from the gas that has been exhaled +b) regulate the oxygen concentration to remain within safe diving limits. +Currently, within Subsurface, the Poseidon MkVI Discovery is the best +supported CCR dive computer. The CCR interface of Subsurface is currently experimental +and under active development. In contrast to a conventional recreational +dive computer, a CCR system computer does not allow the download of a log +containing multiple dives. Rather, each dive is stored independently. This +means that Subsurface cannot download a dive log directly from a CCR +dive computer, but that it imports CCR dive logs in the same way that it +imports dive log data from other digital databases. | +
See the section dealing with Importing dive information from other +digital sources. From the main menu of Subsurface, select Import → Import +log files to bring up the universal import dialogue. As +explained in that section, the bottom right +hand of the import dialogue contains a dropdown list of appropriate devices +that currently includes an option for (Poseidon) MkVI files (import for other +CCR equipment is under active development). Having selected the appropriate CCR format and +the directory where the original dive logs have been stored from the CCR dive +computer, one can select a particular dive log file (in the case of the MkVI +it is a file with a .txt extension). After selecting the appropriate dive log, +activate the Open button at the bottom right hand of the universal import dialogue.
Partial pressures of gases: The graph of oxygen partial pressure shows the +information from the oxygen sensors of the CCR equipment. In contrast to recreational +equipment (where pO2 values are calculated based on gas composition and dive depth), +CCR equipment provide actual measurements of pO2, derived from oxygen sensors. +In this case the graph for oxygen partial pressure +should be fairly flat, reflecting the setpoint settings during the dive. The mean +pO2 is NOT the mean oxygen partial pressure as given by the CCR equipment, but +a value calculated by Subsurface as follows:
+For TWO O2 sensors the mean value of the two sensors are given. +
++For THREE-sensor systems (e.g. APD), the mean value is also used. However + differences of more than 0,1 bar in the simultaneous readings of different sensors are + treated as spurious. If one of the three sensors provides spurious data, it is ignored. +
++If no sensor data is available, the pO2 value is assumed to be equal to the setpoint. +
+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 checkboxes in the Preferences panel (accessible by +selecting File → Preferences → Graph). This part of +the Preferences panel look like this, representing two checkboxes that modify +the display of pO2 when the appropriate toolbar button on the Dive Profile +has been activated.
Checking any of the check boxes allows the display of additional oxygen-related +information whenever the pO2 toolbar button on the Profile panel is activated. +The first checkbox allows the display of setpoint information. This is a red line +superimposed on the green oxygen partial pressure graph and allows a comparison of the +mean measured oxygen partial pressure and the setpoint values, as in the image below.
The second checkbox allows the display of the data from each individual oxygen sensor +of the CCR equipment. The data for each sensor is colour-coded as follows:
+Sensor 1: grey +
++Sensor 2: blue +
++Sensor 3: brown +
+The mean oxygen pO2 is indicated by the green line. This allows the direct comparison +of data from each of the oxygen sensors, useful for detecting abnormally low or erratic +readings from a particular sensor.
The setpoint data can be overlaid on the oxygen sensor data by activating both of the above +check boxes. Partial pressures for nitrogen (and helium, if applicable) are shown in the +usual way as for open circuit dives.
Events: Several events are logged, e.g. switching the mouthpiece to open circuit. +These events are indicated by yellow triangles and, if one hovers over a triangle, +a description of that event is given as the bottom line in the Information Box.
Cylinder pressures: Some CCR dive computers like the Poseidon MkVI record the +pressures of the oxygen and diluent cylinders. The pressures of these two cylinders +are shown as green lines overlapping the depth profile. In addition, start and +end pressures for both oxygen and diluent cylinders are shown in the Equipment Tab. +Below is a dive profile for a CCR dive, including an overaly +of setpoint and oxygen sensor data, as well as the cylinder pressure data. In this +case there is good agreement from the readings of the two oxygen sensors.
Equipment-specific information: Equipment-specific information gathered by +Subsurface is shown in the Extra data tab. This may include setup information +or metadata about the dive.
More equipment-specific information for downloading CCR dive logs for +Poseidon MkVI and APD equipment can be found in Appendix B.
The Dive Info tab gives some summary information about a particular dive that has been selected in the Dive List. Useful information here includes the surface interval before the dive, the maximum and mean depths of the dive, the @@ -2312,7 +2583,21 @@ Users should refer to Appendix D for more informa
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 +a dive, battery levels, no fly times, or gradient factors used during the dive. When +possible, this information is presented in the Extra Data tab. Below is an +image showing extra data for a dive using a Poseidon rebreather.
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 @@ -2324,7 +2609,7 @@ water temperature and surface air consumption (SAC). It also shows the depth of shallowest and deepest dives of those selected.
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). Partial pressures of oxygen are indicated in green, those of nitrogen in black, and those of helium in dark red. These +reported deco ceilings (only visible for deep, long, or repetitive dives). +Partial pressures of oxygen are indicated in green, those of nitrogen in black, +and those of helium in dark red. These partial pressure graphs are shown below the profile data.
+ + | +By selecting this icon, the different cylinders used during a dive can be represented as a coloured bar at the bottom +of the Dive Profile. In general oxygen is represented by a green bar, nitrogen with a yellow bar and helium with a +red bar. The image below shows a dive which first uses a trimix cylinder (red and green), followed by a switch to a nitrox cylinder +(yellow and green) after 23 minutes. Cylinders with air are shown as a light blue bar. | +
Display inert gas tissue pressures relative to ambient inert gas pressure (horizontal grey line).
@@ -2595,21 +2898,26 @@ during the dive. For more information external to this manual see:
-
5.4. The Dive Profile context menu+6.5. The Dive Profile context menuThe context menu for the Dive Profile is accessed by right-clicking while the mouse cursor is over the Dive Profile panel. The menu allows the creation of -Bookmarks or Gas Change Event markers other than the ones that might have been +Bookmarks or Gas Change Event markers or manual CCR set-point changes other than the ones that might have been imported from a Dive Computer. Markers are placed against the depth profile line and with the time of the event set by where the mouse cursor was when the right mouse button was initially clicked to bring up the menu. Gas Change events -open a further selection of which gas is being switched to, the list based on -the available gases defined in the Equipment Tab. By right-clicking while over -an existing marker, the menu extends adding options to allow deletion of the +involve a selection of which gas is being switched to, the list of choices being based on +the available gases defined in the Equipment Tab. Set-point change +events open a dialog allowing to choose the next set-point value. As +in the planner, a set-point value of zero indicates the diver is +breathing from an open circuit system while any non-zero value +indicates the use of a closed circuit rebreather (CCR). +By right-clicking while over +an existing marker a menu appears, adding options to allow deletion of the marker or to allow all markers of that type to be hidden. Hidden events can be restored to view by selecting Unhide all events from the context menu.
- 5.5. The Information Box+6.6. The Information BoxThe Information box displays a large range of information pertaining to the dive profile. Normally the Information Box is located to the top left of the Dive Profile panel. If the mouse points outside of the Dive Profile panel, then @@ -2702,7 +3010,7 @@ air diving at a depth equalling the END. |
@@ -4026,7 +4561,7 @@ On a Mac users sometimes have to manually hunt for the correct
- 13.2. How to Find the Device Name for USB devices and set its write permission+15.2. How to Find the Device Name for USB devices and set its write permission
|