From 97be5fda2c9ed3cf135c31a0e2c77107ab2d7eb1 Mon Sep 17 00:00:00 2001
From: Dirk Hohndel
PREVIOUS/NEXT LINK. Move between links (underlined words that jump to specific sections in the user manual) by right-clicking on the text of the manual. -This brings up a context menu to previous links selected. -(see image above). For instance if a link has been selected, then the option -to Go Back shows the text at the last link selected +This brings up a context menu to PREVIOUS links selected. +(see image below). For instance if a link has been selected, then the option +to Go Back shows the text at the previous link selected (similar to the Previous Page button in a browser). Conversely the Go Forward option jumps to the text seen before selecting the Go Back option. The Reload @@ -544,6 +548,11 @@ option reloads the complete user manual into the window.
The Dive Map on the bottom right, showing the user’s dive sites on a world map -and centered on the site of the last dive selected in the Dive List. +and centered on the site of the last dive selected in the Dive List. The map +scale can be increased or decreased.
The Dive Profile on the top right, showing a graphical dive profile of the -selected dive in the Dive List. +selected dive in the Dive List. You can zoom +into the dive profile for a more detailed view.
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. -1) If the user has a handwritten divelog, a spreadsheet or another form of +Subsurface allows several ways of adding dive data to a logbook.
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 useful if the diver didn’t - use a dive computer and dives were recorded in a written logbook. See: - Entering dive information by hand
+Enter dive information by hand. This is useful if the diver didn’t + use a dive computer and dives were recorded in a written logbook. See: + Entering dive information by hand +
+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 a dive is recorded using a dive computer, the depth profile -and a large amount of additional information can be accessed. -These dives can be imported from:
2) If a dive is recorded using a dive computer, the depth profile +and a large amount of additional information can be accessed. +These dives can be imported from:
-The dive computer itself. See: Importing new dive information from a Dive Computer or +The dive computer itself. See: Importing new dive information from a Dive Computer;
The Apply changes 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 Apply changes button, a local copy of the information -for this specific dive is saved in memory. The Apply changes button should ONLY be selected after all parts -of a dive have been entered. When you close Subsurface, the program will +before applying the information. By selecting the Apply changes button, a local copy of the information +for this specific dive is saved in memory but NOT written to disk. +The Apply changes button should ONLY be selected after all parts +of a dive have been entered. When closing Subsurface, the program will ask again, this time whether the complete dive log should be saved on disk or not.
Then click the OK button. -The checked dives are transferred 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 + message is shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares (Puck Pro)". Refer to the text in the box below.
If the Subsurface computer does not recognize the USB adaptor by showing an appropriate device name next to the Mount Point, then there is a possibility the cable or USB adaptor is faulty. A faulty cable is the most -common cause of communication failure between a dive computer and Subsurface -computer. It’s also possible the Subsurface computer cannot interpret +common cause of communication failure between a dive computer and Subsurface. +It’s also possible Subsurface cannot interpret the data. Perform a download for diagnostic purposes with the following two boxes checked in the download dialogue discussed above:
-Be sure Bluetooth is activated on the host computer running Subsurface. +Ensure Bluetooth is activated on the host computer running Subsurface.
-Be sure Subsurface sees the Bluetooth adapter on the host computer. +Ensure Subsurface sees the Bluetooth adapter on the host computer.
-Be sure the Bluetooth-enabled dive computer is Bluetooth-discoverable and in PC upload mode. +Ensure the Bluetooth-enabled dive computer is Bluetooth-discoverable and in PC upload mode.
-Be sure Subsurface is paired with the Bluetooth-enabled dive computer. +Ensure Subsurface is paired with the Bluetooth-enabled dive computer.
Select the Download dialogue by selecting -Import → Import from dive computer from the Main Menu. If you check the -box labelled "Choose Bluetooth download mode", the dialogue below appears. -===== On Linux or MacOS:
On the Linux or MacOS platforms the name of the Subsurface computer and its Bluetooth address are shown on the right hand side, On the left hand side, if the -computer has connected more than one local Bluetooth devices the user can use +computer has connected more than one local Bluetooth devices you can use the list box to indicate which one needs to connect to Subsurface. The power state (on/off) of the Bluetooth adapter is shown below the address and can be changed by checking the Turn on/off box. If the Bluetooth address is not shown, then Subsurface does not see the local -Bluetooth device. Be sure the Bluetooth driver is installed correctly on the +Bluetooth device. Ensure the Bluetooth driver is installed correctly on the Subsurface computer and check if it can be used by other Bluetooth utilities like -bluetoothctl or bluemoon. This finishes the first two steps above. -Be sure the Bluetooth-enabled dive computer is in PC-upload mode and it +bluetoothctl or bluemoon. This completes the first two steps above. +Ensure the Bluetooth-enabled dive computer is in PC-upload mode and it is discoverable by other Bluetooth devices. Consult the manual of the dive computer for more information. Now the third item in the list above has been finished. Select the Scan button towards the bottom left of the dialogue above. After @@ -1114,6 +1128,7 @@ Request PIN code This closes the Bluetooth dialogue. Now select Download in the Download from dive computer dialogue which should still be open. The downloaded dives are shown on the righthand side of the download dialogue.
The pairing step is checked and done automatically during the download process. If the devices have never been paired the system will ask -for your permission and put a message on the right side of the screen: Add a +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 dialogue and wait for the process to complete.
The right hand image, above, shows a Notes tab filled with dive information. The Time field reflects the date and time of the dive. By clicking -the date, a calendar is displayed from which -you can choose the correct date. Press ESC to close the calendar. +the date, a calendar is displayed for selecting +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.
Location:
Location:
@@ -1276,15 +1291,15 @@ Use the world map in the bottom right hand part
-Use the Subsurface Companion app if you - have an Android or iPhone device with GPS and if the dive site coordinates - were stored using it. +Use eiher the Subsurface-Mobile App or the Subsurface Companion App on an + Android or iPhone device with GPS and if the dive site coordinates + were stored using one of these apps. Click here for more information -Enter by hand if the coordinates are known, using one of +Enter coordiantes by hand if they are known, using one of four formats with latitude followed by longitude:
@@ -1308,7 +1323,7 @@ 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).
-Dive site name lookup: If coordinates have been typed into the appropriate + Dive site name lookup: If you typed coordinates into the appropriate text box, you can do an automated name lookup based on the coordinates. This is done when Subsurface uses the Internet to find the name of the dive site based on the coordinates that were typed. If a name has been found, it is @@ -1337,17 +1352,15 @@ offered. Rating: You can provide a subjective overall rating of the dive on a + Rating: Provide a subjective overall rating of the dive on a 5-point scale by clicking the appropriate star on the rating scale. Visibility: You can provide a rating of visibility during the -dive on a -5-point scale by clicking the appropriate star. 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.
-Subsurface has many built-in tags. If you starts typing a tag, the
-program
-will list the tags that correspond to the typing. For instance, by typing
+Subsurface has many built-in tags. By starting to type a tag, Subsurface lists
+the tags that correspond to the typing. For instance, by typing
Notes: Any additional information for the dive can be entered here. The Apply changes and Discard changes buttons are used to save all the information for tabs @@ -1357,7 +1370,7 @@ shows an example of a Notes tab after completing the dive infor Equipment-The Equipment tab lets you enter information about the type of + 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:
@@ -1365,7 +1378,7 @@ message in the blue box at the top of the panel:
shows the dive is being edited. This is a highly interactive part of + shows the equipment is being edited. 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). For hand-entered dives, this information needs to be typed in. For dive computers, Subsurface often gets the gas used from the dive computer and automatically inserts the gas composition(% oxygen or % helium) in the table. The + button -at the top right lets you add more cylinders for this dive. The dark -dust bin icon on the left lets you delete information for a cylinder. +at the top right allows adding more cylinders for this dive. The dark +dustbin icon on the left allows you to delete information for a cylinder. Note that it is not possible to delete a cylinder if it is used during the dive. A cylinder might be implicitly used in the dive, even without a gas change event. Start by selecting a cylinder type on the left-hand side of the @@ -1401,14 +1414,14 @@ automatically be shown in the dialogue. Finally, provide the gas mixture used. If air was used, the
-value of 21% can be entered or this field can be left blank. If nitrox or
+value of 21% can be entered into the oxygen box or this field can be left blank. If nitrox or
trimix were used, their percentages of oxygen and/or helium should be entered.
Any inappropriate fields should be left empty. After typing the
information for the cylinder, save the data
either by pressing ENTER on the keyboard or by clicking outside the cell
containing
-the cursor. Information for any additional cylinders can be added by using the
@@ -1416,8 +1429,7 @@ for a dive using two cylinders (air and EAN50):
Weights: Information about the weight system used can be entered -using a dialogue similar to that of the cylinder information. If you -click +using a dialogue similar to that of the cylinder information. If you click the + button on the top right of the weights dialogue, the table looks like this:
@@ -1433,7 +1445,7 @@ down-arrow:
This can be used to select the type of weight system -used during the dive or just may start typing in the box +used during the dive. You may start typing in the box to specify a different weighting mechanism that will be saved by Subsurface. In the Weight field, type in the amount of weight used during the dive. After @@ -1537,37 +1549,36 @@ 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-If you’ve been diving for some time, it’s possible several dives were -logged using other dive log software. These dive logs can probably be -imported into Subsurface. Subsurface will import dive logs from a range of -other -dive log software. While some software is supported natively, for -others you will need to -export the logbook(s) to an intermediate format so they can then be imported -by Subsurface. + 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, +others require +export of the the dive log to an intermediate format that can then be imported +into Subsurface. Currently, Subsurface supports importing CSV log files from several sources. -APD LogViewer, XP5, Sensus and Seabear files are +Dive log import from APD LogViewer, XP5, Sensus and Seabear files are preconfigured, but because the import is flexible, users can configure their own imports. Manually kept log files (e.g. a spreadsheet) can also be imported by configuring the CSV import. Subsurface can also import UDDF and UDCF files used by some dive log software and some dive computers, like the Heinrichs & Weikamp DR5. Finally, -for some dive log software like Mares Dive Organizer we currently recommend you -import the logbooks first into a web service like divelogs.de and then import +for some dive log software like Mares Dive Organizer we currently recommend +importing the logbook first into a web service like divelogs.de and then import from there with Subsurface. Divelogs.de supports a few additional logbook formats that Subsurface currently cannot handle. If the format of other software is supported natively on Subsurface, select 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 +of many dive computers, including Suunto, Shearwater and some CCR equipment. When importing dives, Subsurface tries to detect multiple records for the same dive and merges the information as best as it can. If 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. Below is more specific information -to import data to Subsurface. -==== Using the universal import dialogue
+
+5.3.1. Using the universal import dialogueImporting dives from other software is done through a universal interface activated by selecting Import from the Main Menu, then clicking on Import Log Files. This brings up dialogue A, below. -divelog.de logs +divelogs.de logs -Suunto Dive Manager (DM3 and DM4) +Suunto Dive Manager (DM3, DM4, DM5)
- 5.3.1. Importing from OSTCTools+5.3.2. Importing from OSTCToolsOSTC 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 @@ -1657,13 +1669,13 @@ panel. Select one or more dive, then click the Open button. The OSTC di All H&W devices supported by OSTCTools can be imported to Subsurface. This includes OSTC, OSTC Mk2, OSTC 2N/2C, OSTC3, OSTC Sport, and probably although untested, Frog, OSTC2 and OSTC CR. Please remember that OSTCTools is not a true diving log software, but rather a useful set of tools + Please remember that OSTCTools is not true diving log software, but rather a useful set of tools for analysis and management of OSTC devices. Only raw dive computer data will be -imported to Subsurface; you have to manually complete the rest of the -data you want (buddies, equipment, notes, etc).
-
5.3.2. Importing from Mares Dive Organizer V2.1+5.3.3. Importing from Mares Dive Organizer V2.1Since Mares uses proprietary Windows software not compatible with multi-platform applications, these dive logs cannot be directly imported into @@ -1680,9 +1692,9 @@ Export the dive log data from Mares Dive Organizer to your -Data should then be imported into www.divelogs.de. You will first need to create a user +Data should then be imported into www.divelogs.de. First, create a user account in - www.divelogs.de. Log into that web site, then + www.divelogs.de and Log into that web site, then select Import Logbook → Dive Organizer 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 Organizer database to www.divelogs.de. @@ -1697,7 +1709,7 @@ Finally, import the dives
-
5.3.3. Importing dives from divelogs.de+5.3.4. Importing dives from divelogs.deImporting dive information from divelogs.de is simple, using a single dialogue box. The Import → Import from Divelogs.de option should be selected from the Main Menu. This @@ -1716,7 +1728,7 @@ success status is shown (see image B, below). The
- 5.3.4. Importing data in CSV format+5.3.5. Importing data in CSV formatA 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 @@ -1728,9 +1740,12 @@ to CSV format for information that may be helpful for importing spreadsheet- into Subsurface. Importing dives in CSV format from dive computers or other dive log software-You can view a CSV file by using an ordinary text editor. It’s normally organized 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:
Before being able to import the CSV data to Subsurface you needs to know a few
+ Before being able to import the CSV data to Subsurface you need to know a few
things about the data being imported: Complete this by ensuring that all the data columns have the appropriate column headings. The top blue row of the data table contains the column headings found in the CSV data file. The blue row of balloons immediately above these @@ -1809,9 +1824,9 @@ contains the names understood by Subsurface. These balloons can be move instance, Subsurface expects the column heading for Dive number (" # ") to be "Dive # ". If the column heading that Subsurface expects is not in the blue row, drag the appropriate balloon 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 +cell at the top of the table. For example, 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 +cell immediately above the white cell containing " # ", depicted in the image below.
@@ -1831,7 +1846,7 @@ The data from the CSV file are imported and shown in the Dive L
|
CSV is an abbreviation for a data file format: Comma-Separated Values. It is a
-file format that lets you view or edit information using a text editor like
+file format that allows you to view or edit information using a text editor like
Notepad (Windows), gedit (Linux) or TextWrangler (OS/X). There are two main advantages of
the CSV format. First, the data are easily editable as text without any proprietary software.
Second, all information is human-readable, not obscured by any custom or
@@ -1869,7 +1884,7 @@ Wismar Baltic 2012-12-01 10:13 35:27 15.4 Dieter Albrecht
Pulau Weh 2012-12-20 09:46 55:56 38.6 Karaeng Bontonompo
It is clear why many people prefer the TAB-delimited format to the comma-delimited format. The -disadvantage is that one cannot see +disadvantage is that you cannot see the TAB characters. For instance, the space between Dive and date in the top line may be a SPACE character or a TAB character (in this case it is a SPACE character: the tabs are before and after Dive date). If the field names in the first line are long, the alignment with data in the other lines @@ -1913,7 +1928,131 @@ a smaller file to make sure everything works. |
Creating new dive locations
Now you are ready to get a dive position and send it to the server. The Android -display will look like the left hand image (A) below, but without any dives.
Touch the "+" icon on the top right to add a new dive site, a menu -shows with 3 options:
Touch the + icon at the top right to add a new dive site. A menu +with 3 options shows:
-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. +Current: A prompt for a place name is shown (or a request to activate the GPS if it is turned + off), after which the current location is saved.
-Use Map: This option lets you fix a position by searching a world map. A - world map is shown (see B below) on which you can show the desired position +Use Map: This option allows you to fix a position by searching a world map. A + world map is shown (see B below). Specify the desired position with a long press on the touch sensitive screen (if the marked location is wrong, simply choose a new location) - and select the check symbol in the upper right. A dialog is shown letting you enter the + and select the check symbol in the upper right. A dialog is shown allowing you to enter the name of the dive location and the date and time of the dive (see C below). In order to import this - dive location in Subsurface you should set the time to agree with the time of + dive location in Subsurface, 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 +Import local GPX file: The Android device searches for .gpx files and located + archives will be shown. The selected .gpx file is opened and its locations shown. Now 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. + tab in the upper right, afterAndroid device.
Dive lists of dive locations
The main screen shows a list of dive locations, each with a name, date and time (see A below). Some locations may have an arrow-up icon over the selection box to the left showing they need to be uploaded to the server. You @@ -2036,7 +2171,7 @@ are performed on several selected locations.
When you select a dive (not selecting the check box), the -name given to it, date/time and GPS coordinates will be shown, with two options at the top +
Upon selecting a dive (not selecting the check box), the +name given to it, date/time and GPS coordinates are shown with two options at the top of the screen:
Uploading dive locations
There are several ways to send locations to the server. The easiest is simply selecting the locations (See A below) and then touching the right arrow at the @@ -2085,13 +2218,9 @@ it deletes the selected dive location(s).
After a dive trip using the Companion App, all dive locations are ready to be downloaded to a Subsurface dive log (see below).
Settings on the Companion App
Selecting the Settings menu option results in the right hand image above (B).
Server and account
@@ -2102,9 +2231,11 @@ downloaded to a Subsurface dive log (see below).
User ID. The DIVERID obtained by registering as described above. The easiest way to get it is to copy and paste from the confirmation email or just type it in. -===== Synchronisation
+Synchronisation
Synchronize on startup. If selected, dive locations in the Android device and those @@ -2118,11 +2249,9 @@ downloaded to a Subsurface dive log (see below).
Background service
Instead of entering an unique dive location, you can leave the service running -in the background of your Android device, allowing a continuous collection of GPS locations.
The settings below define the behavior of the service:
Other
@@ -2178,31 +2305,22 @@ Subsurface mailing list.
Search
Search the saved dive locations by name or by date and time.
Start service
Starts the background service following the previously defined settings.
Disconnect
This is admittedly a badly named option that disconnects the app from the server. It resets the user ID in the app, showing the first screen where an account can be created, retrieve the ID for an existing account or use the users own -ID. The disconnect option -is useful if your Android device was used to download the dive locations +ID. The Disconnect option +is useful if the Android device was used to download the dive locations of another registered diver.
Send all locations
This option sends all locations stored in the Android device to the server.
The iPhone interface is quite simple. 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.
You 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 web service. There isn’t an option to +to the web service. There is no option to trigger upload manually.
Downloading dive locations to the Subsurface divelog
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 @@ -2240,18 +2356,18 @@ which the screen on the right (B) below appears:
Note that the Apply button is now active. By clicking on it, you can update the locations -of the newly entered or uploaded dives in Subsurface. That applies the +
Note that the Apply button is now active: selecting it updates the locations +of the newly entered or uploaded dives in Subsurface, i.e. it applies the coordinates and names entered on the app to all the new dives that match the -date-times of the uploaded GPS localities. If you have entered the name of the dive -location in Subsurface before downloading the GPS coordinates, this name will take -precedence over downloaded one.
Since Subsurface matches GPS locations from the Android device and dive information from the +date-times of the uploaded GPS localities. The names of dive +locations entered within Subsurface (i.e. before downloading the GPS coordinates) have +precedence over downloaded dive locations.
Since Subsurface matches GPS locations from the mobile device and dive information from the dive computer based on date-time data, automatic assignment of GPS data to dives depends on agreeing date-time information between the two devices. Although Subsurface has -a wide range tolerance, it may not be able to identify the appropriate dive if there’s -a large difference between the time in the dive computer and that of the Android device. -That results in no updates.
Similar date-times may not always be possible and there may be many reasons for this (e.g. time zones). Subsurface may also be unable to decide which is the correct position for a dive (e.g. on repetitive dives while running background service there may be several locations that would be @@ -2273,14 +2389,14 @@ downloading GPS data.
-It may also make sense to give informative names to the locations sent to the web server, or at least +It may also be useful 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.
@@ -2288,36 +2404,31 @@ It may also make sense to give informative names to the locations sent to the we +Many (if not most) divers take a camera with them and take photographs -during a dive. To match each photograph with a specific -dive, Subsurface lets you load photos into a dive. Photos are superimposed -on the dive profile, from where they can be viewed.
Many (if not most) divers take photographs +during a dive. Subsurface allows the storage and display of photographs for each dive. Photos are +superimposed on the dive profile at the times during the dive when they were taken. They can also be viewed +from the dive profile.
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.
Left-lick on a dive or on a group of dives on the dive list, bringing up the Dive list context Menu. Right-click the appropriate +option to import images either from +file or from the Internet. The system file browser appears. Select the folder and +photographs that need to be loaded into Subsurface and click the Open button.
This brings up the time synchronization dialog, shown below. But be -aware that the time +
This brings up the time synchronization dialog, shown below. The time synchronization is not perfect between the dive computer used during a dive, and the camera used during that same dive. These two devices -often differ by several minutes. If Subsurface can synchronize, -then the exact times of photographs can be used to position photographs on +often differ by several minutes. Subsurface attempts to synchronize these two devices +so that the exact times of photographs can be used to position photographs on the dive profile.
Subsurface synchronizes in three ways:
Subsurface synchronizes camera with dive computer in three ways:
@@ -2327,15 +2438,15 @@ the dive profile.
-Manually: If you wrote down the exact camera time at the start of a dive, the - difference in time between the two devices can be determined. As long as the device - settings for time has not been changed in either device, you could write down the times of - both devices after the dive or even at the end of the day. You 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, shown in figure A below. +Manually: Writing down the exact camera time at the start of a dive allows using the + difference in time between the two devices. As long as the device + settings for time has not been changed in either device, the times of + both devices after the dive or even at the end of the day allows manually setting the time + difference in the Time shift dialog (see image below). Towards the top of the dialog is a time + setting tool immediately under the heading Shift times of image(s) by, in the image 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 + tool to a value of 00:07 and select the Earlier radio button. + This 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 synchronization is done.
@@ -2343,32 +2454,37 @@ the dive profile.-By photograph: There is a very slick way of synchronizing. If you take a - photograph of the face of the dive computer showing the time, then Subsurface can get +By photograph: There is a very slick way of achieving synchronization, requiring a + photograph of the face of the dive computer showing the time. Subsurface gets the exact time the photograph was taken, using the metadata the camera stores within - each photo. To do this, use the bottom half of the Time shift dialog. If you use - the bottom part, the top part of the dialog is ignored. Click on - the horizontal bar called "Select image of dive computer showing time. This brings up - a file browser letting you select the photograph of the dive computer time. Select the + each photo and compares this with the time visible on the photo. To do this, use the + bottom half of the Time shift dialog. In this case the top part of the dialog is ignored. Click on + the horizontal bar called Select image of dive computer showing time. This brings up + a file browser for selecting the photograph of the dive computer time. 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 + when the photograph was taken. Now set the date-time dialog to the left of the photo so it 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 it can synchronize. - Image B above shows a photograph of the face of the dive computer and with the date-time tool set to the + camera and dive computer is, and it can synchronize the devices. The image below shows + a photograph of the face of the dive computer and with the date-time tool set to the date-time.
If the timestamp of a photograph is more than 30 minutes before or after the dive, it is not placed on -the dive profile.
-the Photos tab of the Notes panel. +the Photos tab of the Notes panel (left part of image below).
If you hover the mouse over any of the photo icons, a thumbnail photo +
Hover the mouse over any of the photo stubs. A thumbnail photo is shown of the appropriate photo. See the image below:
Clicking on the thumbnail brings up a full size -photo overlaid on the Subsurface window. This allows good viewing of -the added photographs. (see the image below). Note that the thumbnail +photo overlaid on the Subsurface window, allowing a good view of +the photographs (see the image below). Note that the thumbnail has a small dustbin icon in the bottom right hand corner (see image above). Selecting the dustbin removes the image from the dive. Be careful when clicking on a thumbnail. Images @@ -2425,9 +2541,8 @@ can also be deleted using the Photos tab (see text below).
After a photograph has been loaded into Subsurface and associated with a specific dive, the directory - where the photo lies is stored, letting Subsurface find the photograph when the dive is - opened again. If the photo or the whole photo collection is moved to another drive or to a different - machine, the directory structure will be different to that of the original uploaded - photo. When this happens, Subsurface looks for the photos at their original location before they were moved, - cannot find them and cannot display them. Because after moving photos, large numbers of photos - may need to be deleted and re-imported from the new location, Subsurface has a mechanism that eases the - process of updating the directory information for each photo: automatic updates using fingerprints.
After a photograph has been loaded into Subsurface and associated with a specific dive, +Subsurface saves the directory path where the photo lies as well as the file name of the photo, +in order to find it when the dive is opened again. +If the photo or the whole photo collection is moved to another drive or to a different + machine, the path to the photo changes. Now, Subsurface looks for the photos at their original location before they were moved, + cannot find them and cannot display them. Because, after moving photos, large numbers of photos + may need to be deleted and re-imported from the new location, Subsurface has a mechanism to ease this inconvenience: automatic updates using fingerprints.
When a photo is loaded into Subsurface, a fingerprint for the image is calculated and stored with the other reference information for that photo. After moving a photo collection (that has already been loaded into Subsurface) to a different directory, disk or computer, Subsurface can:
-look through a particular directory (and all its subdirectories recursively) where photos have been moved -to, +look through a particular directory (and all its subdirectories recursively) where photos have been moved to,
-if there is a match between a calculated fingerprint and the one originally calculated when a photo was - loaded into Subsurface (even if the original file name has changed), automatically update the - directory information so that Subsurface can find the photo in the new moved directory. +if there is a match between a calculated fingerprint and the one calculated when a photo was +originally loaded into Subsurface (even if the original file name has changed), automatically update the directory information so that Subsurface can find the photo in the new moved directory.
This section gives examples of the versatility of Subsurface as a dive logging tool.
Subsurface easily handles dives involving more than one cylinder. Multi-cylinder diving usually happens @@ -2512,7 +2635,7 @@ as Subsurface is concerned, there are only two types of information tha
Describe the cylinders used during the dive This is performed in the Equipment tab of the Info panel, as described above. Enter the cylinders one by one, - specifying each’s characteristics and the gas composition within it. + specifying its size and pressure, as well as the gas composition within it.
When this is complete, Subsurface indicates the appropriate use of cylinders in the dive profile. -Below is a multi-cylinder dive, starting off with EAN28, then changing cylinders to EAN50 after 26 minutes +Below is a two-cylinder dive, starting off with EAN28, then changing cylinders to EAN50 after 26 minutes for decompression.
Sidemount diving is just another form of multi-cylinder diving, often with both or all cylinders having -the same gas mixture. Although it’s a popular configuration for cave divers, Sidemount -diving can be done by recreational divers who’ve completed the appropriate training. sidemount +the same gas mixture. Although it’s a popular configuration for cave divers, sidemount +diving can be done by recreational divers who’ve completed the appropriate training. Sidemount dive logging involves three steps, exactly as with multi-cylinder dives above:
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 Info Panel (see - image below where two 12 litre cylinder were used). + image below where two 12 litre cylinders were used).
This section gives an example of the versatility of Subsurface as a dive logging tool.
See the section dealing with Importing dive information from other -digital sources. From the main menu of Subsurface, select Import → Import +digital sources. CCR dive data are currently obtained from the proprietary software +provided when purchasing CCR dice equipment. See Appendix B +for more complete information. Use that software to download the dive data into +a known directory. From the main menu of Subsurface, select Import → Import log files to bring up the universal import dialogue. As explained in that section, the bottom right hand of the import dialogue contains a dropdown list (labled Filter:) of appropriate devices -that currently include(Poseidon) MkVI or APD log viewer files. Import for other +that currently include (Poseidon) MkVI or APD log viewer 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, select a particular dive log file (in the case of the MkVI @@ -2754,7 +2880,7 @@ readings from a particular sensor.
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, +These events are indicated by yellow triangles and, if you hover 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 @@ -2814,7 +2940,7 @@ toxicity units (OTU) incurred.
Of all the panels in Subsurface, the Dive Profile contains the most detailed -information about each dive. The Dive Profile has a button bar on the left hand side -that lets you control several display options. The functions of these +information about each dive. The Dive Profile has a button bar on the left hand side, +allowing control of several display options. The functions of these buttons are described below. The main item in the Dive Profile is the graph of dive depth as a function of time. In addition to @@ -2915,8 +3041,199 @@ panel. Clicking the Scale button in the toolbar on the left of increases the size of the dive profile to fill the area of the panel.
Water temperature is displayed with its own blue line with temperature values +
Water temperature is shown as a blue line with temperature values placed adjacent to significant changes.
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. If the mouse points outside of the Dive Profile panel, then +only the top line of the Information Box is visible (see left-hand part of +figure (A) below). The Information Box can be moved around in the Dive Profile +panel by click-dragging it with the mouse so that it is not obstructing +important detail. The position of the Information Box is saved and used again +during subsequent dive analyses.
When the mouse points inside the Dive Profile panel, the information box expands and +shows many data items. In this situation, the data reflect the time point along +the dive profile shown by the mouse cursor (see right-hand part of figure (B) above +where the Information Box reflects the situation at the position of the cursor +[arrow] in that image). Moving the cursor horizontally lets the Information Box show information for any point +along the dive profile. It gives extensive statistics about depth, gas +and ceiling characteristics of the particular dive. These include: Time period +into the dive (indicated by a @), depth, cylinder pressure (P), temperature, +ascent/descent rate, surface air consumption (SAC), oxygen partial pressure, +maximum operating depth, equivalent air depth (EAD), equivalent narcotic depth +(END), equivalent air density depth (EADD), decompression requirements at that +instant in time (Deco), time to surface (TTS), the calculated ceiling, as well +as of the statistics in the Information Box, shown as four +buttons on the left of the profile panel. These are:
+ + | +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 → Graph 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. | +
+ + | +Show either the No-deco Limit (NDL) or the +Total Time to Surface (TTS). NDL is the time duration that a diver can continue with a +dive, given the present depth, that does not require decompression (that is, before an +ascent ceiling appears). Once a diver has exceeded the NDL and decompression is required (that +is, there is an ascent ceiling above the diver) then TTS gives the number of minutes +required before the diver can surface. TTS includes ascent time as well as decompression +time. TTS is calculated assuming an ascent surface air consumption (SAC) for +the gas currently used. Even if the profile contains several gas +switches, TTS at a specific moment during the dive is calculated using the current gas. +TTS longer than 2 hours is not accurately calculated and Subsurface only indicates TTS > 2h. | +
+ + | +Show the Surface Air Consumption (SAC), an indication of the surface-normalized respiration +rate of a diver. The value of SAC is less than the real +respiration rate because a diver at 10m uses breathing gas at a rate roughly double that of +the equivalent rate at the surface. SAC gives an indication of breathing gas consumption rate +independent of the depth of the dive, so the respiratory rates of different dives +can be compared. The units for SAC is liters/min or cubic ft/min. | +
+ + | +Show the Equivalent Air Depth (EAD) for +nitrox dives as well as the Equivalent +Narcotic Depth (END) for trimix dives. These are +important to divers breathing gases other than air. Their +values are dependent on the composition of the breathing gas. The EAD +is the depth of a hypothetical air dive that has the same partial +pressure of nitrogen as the current depth of the nitrox dive at +hand. A nitrox dive leads to the same decompression obligation as an +air dive to the depth equalling the EAD. The END is the depth of a +hypothetical air dive that has the same sum of partial pressures of +the narcotic gases nitrogen and oxygen as the current trimix dive. A +trimix diver can expect the same narcotic effect as a diver breathing +air diving at a depth equalling the END. | +
Figure (B) above shows an information box with a nearly complete set of data.
On the left of the Information Box is a vertical bar graph showing the +pressures of the nitrogen (and other inert gases, e.g. helium, if applicable) that the diver +was inhaling at a particular instant during the dive, shown by the position +of the cursor on the Dive Profile. The drawing on the left below indicates the +meaning of the different parts of the Gas Pressure Bar Graph.
+The light green area indicates the gas pressure, with the top margin of the light green + area showing the total gas pressure of ALL gases inhaled by the diver and measured from the bottom + of the graph to the top of the light green area. This pressure has a relative value in the graph + and does not indicate absolute pressure. +
++The horizontal black line underneath the light green margin indicates the equilibrium pressure + of the INERT gases inhaled by the diver, usually nitrogen. In + the case of trimix, it is the pressures of nitrogen and helium combined. In this example, + the user is diving with EAN32, so the equilibrium inert gas pressure is 68% of the distance from the + bottom of the graph to the total gas pressure value. +
++The dark green area at the bottom of the graph represents the pressures of inert gas in each + of the 16 tissue compartments, following the Bühlmann algorithm, with fast tissues on the + left hand side. +
++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 Graph tab of the Preferences + Panel of Subsurface. +
++The bottom margin of the red area in the graph indicates the Bühlman-derived M-value. That is the + pressure value of inert gases at which bubble formation is expected to be severe, resulting + in a significant risk of decompression sickness. +
+These five values are shown on the left in the image above. The way the Gas Pressure Bar Graph changes +during a dive can be seen on the right hand side of the above figure for a diver using EAN32.
+Graph A indicates the start of a dive with the diver at the surface. The pressures in all + the tissue compartments are still at the surface equilibrium pressure because no diving has taken place. +
++Graph B indicates the situation after a descent to 30 meters. Few of the tissue compartments have had + time to respond to the descent, so their gas pressures are far below the equilibrium gas pressure. +
++Graph C represents the pressures after 30 minutes at 30 m. The fast compartments have attained + equilibrium (i.e. they have reached the height of the black line indicating the equilibrium pressure). The + slower compartments (towards the right) have not reached equilibrium and are in the process of slowly + increasing in pressure. +
++Graph D shows the pressures after ascent to a depth of 4.5 meters. Since during ascent the total + inhaled gas pressure has decreased strongly from 4 bar to 1.45 bar, the pressures in the different tissue + compartments now exceed that of the total gas pressure and approach the gradient factor value (i.e. + the top black horizontal line). Further ascent will result in exceeding the gradient + factor value (GFHigh), endangering the diver. +
++Graph E indicates the situation after remaining at 4.5 meters for 10 minutes. The fast compartments + have decreased in pressure. As expected, the pressures in the slow compartments have not changed much. + The pressures in the fast compartments do not approach the GFHigh value any more and the diver is safer + than in the situation indicated in graph D. +
+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). @@ -2928,7 +3245,7 @@ partial pressure graphs are shown below the profile data.
The air consumption graph displays the tank pressure and its change during the dive. The air consumption takes depth into account so that even when manually entering the start and end pressures the graph, is not a straight line. -Like the depth graph, the slope of the tank pressure gives you information +Like the depth graph, the slope of the tank pressure provides information about the momentary SAC rate (Surface Air Consumption) when using an air integrated dive computer. Here the color -coding is not relative to some absolute values but relative to the average -normalized air consumption during the dive. So areas that are red or orange +coding is not relative to some absolute values but relative to the mean +normalized air consumption during the dive. So areas in red or orange indicate times of increased normalized air consumption while dark green reflects times when the diver was using less gas than average.
It is possible to zoom into the profile graph. This is done either by using -the scroll wheel / scroll gesture of your mouse or trackpad. By default +the scroll wheel / scroll gesture of the mouse or trackpad. By default Subsurface always shows a profile area large enough for at least 30 minutes -and 30m - (100ft) – this way short or shallow dives are easily recognizable; -something free divers won’t care about. - - -
@@ -3044,303 +3362,185 @@ shown as a red area by checking Dive computer reported ceiling | - | If the Calculated ceiling button on the Profile Panel is clicked, then a ceiling, -calculated by Subsurface, is shown in green if it exists for -a particular dive (A in figure below). This setting can be modified in two ways: | -
- - | -If, in addition, the show all tissues button on the Profile Panel is clicked, the ceiling is shown for the tissue -compartments following the Bühlmann model (B in figure below). | -
- - | -If, in addition, the 3m increments button on the Profile Panel is clicked, then the ceiling is indicated in 3 m increments -(C in figure below). | -
- - | -By selecting this icon, the different cylinders used during a dive can be represented as a colored bar at the bottom -of the Dive Profile. In general oxygen is represented by a green bar, nitrogen a yellow bar and helium 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). -Tissue pressures are calculated using the Bühlmann ZH-L16 algorithm and are displayed as lines ranging from -green (faster tissues) to blue (slower tissues). -The black line, graphed above the ambient pressure, is the maximum allowable tissue supersaturation (pressure limit) derived -from the gradient factors specified in the Preferences. For -divers doing planned decompression diving, efficient rates of offgassing are obtained with tissue pressures -between the ambient inert gas pressure (grey line) and the pressure limit (black line). This display is a representation -of the tissue pressures during the whole dive. In contrast, the Gas Pressure Graph in the Information Box -on the Dive Profile is an instantaneous reflection of tissue pressures at the moment in -time, at the position of the cursor on the dive profile. | -
Gradient Factor settings strongly affect the calculated ceilings and their depths. -For more information about Gradient factors, see the section on Gradient Factor Preference settings. The -currently used gradient factors (e.g. GF 35/75) are shown above the depth profile if the appropriate toolbar buttons are activated. -N.B.: The indicated gradient factors are NOT the gradient factors in use by the dive computer, -but those used by Subsurface to calculate deco obligations -during the dive. For more information external to this manual see:
The context menu for the Dive Profile is accessed by right-clicking while the -mouse cursor is over the Dive Profile panel. The menu lets you create -Bookmarks, 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, -with the time of the event set by where the mouse cursor was when the right -mouse button was first clicked to bring up the menu. Gas Change events -involve a selection of which gas is being switched TO. The list of choices is based on -the available gases defined in the Equipment Tab. Setpoint change -events open a dialog letting you choose the next setpoint value. As -in the planner, a setpoint value of zero shows the diver is -breathing from an open circuit system while any non-zero value -shows 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.
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. If the mouse points outside of the Dive Profile panel, then -only the top line of the Information Box is visible (see left-hand part of -figure (A) below). The Information Box can be moved around in the Dive Profile -panel by click-dragging it with the mouse so that it is not obstructing -important detail. The position of the Information Box is saved and used again -during subsequent dive analyses.
When the mouse points inside the Dive Profile panel, the information box expands and -shows many data items. In this situation, the data reflect the time point along -the dive profile shown by the mouse cursor (see right-hand part of figure (B) above -where the Information Box reflects the situation at the position of the cursor -[arrow] in that image). Moving the cursor horizontally lets the Information Box show information for any point -along the -dive profile. -In this mode, the Information Box gives extensive statistics about depth, gas -and ceiling characteristics of the particular dive. These include: Time period -into the dive (indicated by a @), depth, cylinder pressure (P), temperature, -ascent/descent rate, surface air consumption (SAC), oxygen partial pressure, -maximum operating depth, equivalent air depth (EAD), equivalent narcotic depth -(END), equivalent air density depth (EADD), decompression requirements at that -instant in time (Deco), time to surface (TTS), the calculated ceiling, as well -as the calculated ceiling for several Bühlmann tissue compartments.
The user has control over the display of some statistics, shown as four -buttons on the left of the profile panel. These are:
- - | -Clicking this button causes the Information Box to display 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 → Graph_ and edit the text box Max pO2 when showing MOD. -Below the MOD there is a markedly increased -risk of exposure to the dangers of oxygen toxicity. | -
- - | -Clicking this button causes the Information Box to display either the No-deco Limit (NDL) or the -Total Time to Surface (TTS). NDL is the time duration that a diver can continue with a -dive, given the present depth, that does not require decompression (that is, before an -ascent ceiling appears). Once a diver has exceeded the NDL and decompression is required (that -is, there is an ascent ceiling above the diver) then TTS gives the number of minutes -required before the diver can surface. TTS includes ascent time as well as decompression -time. TTS is calculated assuming an ascent surface air consumption (SAC) for -the gas currently used. Even if the profile contains several gas -switches, TTS at a specific moment during the dive is calculated using the current gas. -TTS longer than 2 hours is not accurately calculated and Subsurface only indicates TTS > 2h. | +If the Calculated ceiling button on the Profile Panel is clicked, then a ceiling, +calculated by Subsurface, is shown in green if it exists for +a particular dive (A in figure below). This setting can be modified in two ways: |
- + | -Clicking this button causes the Information Box to display the Surface Air Consumption (SAC). -SAC is an indication of the surface-normalized respiration rate of a diver. The value of SAC -is less than the real -respiration rate because a diver at 10m uses breathing gas at a rate roughly double that of -the equivalent rate at the surface. SAC gives an indication of breathing gas consumption rate -independent of the depth of the dive, so the respiratory rates of different dives -can be compared. The units for SAC is liters/min or cubic ft/min. | +If, in addition, the show all tissues button on the Profile Panel is clicked, the ceiling is shown for the tissue +compartments following the Bühlmann model (B in figure below). |
- + | -Clicking this button displays the Equivalent Air Depth (EAD) for -nitrox dives as well as the Equivalent -Narcotic Depth (END) for trimix dives. These are -important to divers breathe gases other than air. Their -values are dependent on the composition of the breathing gas. The EAD -is the depth of a hypothetical air dive that has the same partial -pressure of nitrogen as the current depth of the nitrox dive at -hand. A nitrox dive leads to the same decompression obligation as an -air dive to the depth equalling the EAD. The END is the depth of a -hypothetical air dive that has the same sum of partial pressures of -the narcotic gases nitrogen and oxygen as the current trimix dive. A -trimix diver can expect the same narcotic effect as a diver breathing -air diving at a depth equalling the END. | -
Figure (B) above shows an information box with a nearly complete set of data.
On the left of the Information Box is a vertical bar graph showing the -pressures of the nitrogen (and other inert gases, e.g. helium, if applicable) that the diver -was inhaling at a particular instant during the dive. It is shown by the position -of the cursor on the Dive Profile. The drawing on the left below indicates the -meaning of the different parts of the Gas Pressure Bar Graph.
If, in addition, the 3m increments button on the Profile Panel is clicked, then the ceiling is indicated in 3 m increments +(C in figure below).
Gradient Factor settings strongly affect the calculated ceilings and their depths. For more information about Gradient factors, see the section on Gradient Factor Preference settings. The currently used gradient factors (e.g. GF 35/75) are shown above the depth profile if the appropriate toolbar buttons are activated. N.B.: The indicated gradient factors are NOT the gradient factors in use by the dive computer, but those used by Subsurface to calculate deco obligations during the dive. For more information external to this manual see:
-The light green area indicates the total gas, with the top margin of the light green - area showing the total gas pressure inhaled by the diver and measured from the bottom - of the graph to the top of the light green area. This pressure has a relative value in the graph - and does not indicate absolute pressure. -
--The horizontal black line underneath the light green margin indicates the equilibrium pressure - of the inert gases inhaled by the diver, usually nitrogen. In - the case of trimix, it is the pressures of nitrogen and helium combined. In this example, - the user is diving with EAN32, so the inert gas pressure is 68% of the distance from the - bottom of the graph to the total gas pressure value. -
--The dark green area at the bottom of the graph represents the pressures of inert gas in each - of the 16 tissue compartments, following the Bühlmann algorithm, the fast tissues being on the - left hand side. -
--The top black horizontal line indicates 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 Graph tab of the Preferences - Panel of Subsurface. +Understanding M-values by Erik Baker, Immersed Vol. 3, No. 3.
-The bottom margin of the red area in the graph indicates the Bühlman-derived M-value. That is the - pressure value of inert gases at which bubble formation is expected to be severe, resulting - in decompression sickness. +Gradient factors for dummies, by Kevin Watts
These five values are shown on the left in the graph above. The way the Gas Pressure Bar Graph changes -during a dive can be seen on the right hand side of the above figure for a diver using EAN32.
+ + | +By selecting this icon, the different cylinders used during a dive can be represented as a colored bar at the bottom +of the Dive Profile. In general oxygen is represented by a green bar, nitrogen a yellow bar and helium 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 the tissue heat-map. The heat map summarises, for the duration of the dive, the inert gas tissue pressures +for each of the 16 tissue compartments of the Bühlmann model. Blue colours mean low gas pressures in a tissue compartment +and thus on-gassing, green to red means excess gas in the tissue and thus off-gassing. Fast to slow tissues are indicated from +top to bottom. The figure below explains in greater detail how the heat map can be interpreted.
+
+
+
+
+Image A on the left shows the Gas Pressure Graph in the +Information box, representing a snapshot of inert gas pressures at a particular point in time +during the dive. The inert gas pressures of 16 tissue compartments are shown as dark green vertical +bars with the quick tissue compartments on the left and the slow tissue compartments +on the right. Refer to the section on the Gas Pressure Graph +for more details on the different elements of this graph. Image B shows a gradient of unique colours, spanning the whole range of inert gas pressures. +It is possible to map the height of each of the dark green vertical bars of A to a +colour in B. For instance, the fastest (leftmost) dark green verical bar in A has +a height corresponding to the medium green part of B. The height of this bar can therefore be summarised +using a medium green colour. Similarly, the highest dark green bar in A is as high +as the yellow part of B. The 14 remaining tissue pressure bars in A can also be +translated to colours. The colours represent three ranges of tissue inert gas pressure:
Image C shows the colour mapping of each of the vertical bars in A, the fast +tissues (on the left in A) depicted at the top +and the slow tissue compartments at the bottom of C. The highest vertical bar in A +(vertical bar 3rd from the left) is presented as the yellow rectangle 3rd from the top +in C. The 16 vertical bars in A are now presented as a vertical +column of 16 coloured rectangles, representing a snapshot of tissue compartment gas pressures +at a particular instant during the dive. Image D is a compilation of similar colour mappings of 16 tissue compartments +during a 10-minute period of a dive, the colours representing the +inert gas loading of a tissue compartment at a point in time during the dive. Faster tissues +are shown at the top and slower tissues at the bottom, with time +forming the horizontal axis of the graph. The column of rectangles in C can be found +on the horizontal axis between 9 and 10 minutes. The colours of the heat map are not affected by the gradient factor settings. +This is because the heat map indicates tissue pressures relative to the Bühlmann M-value gradient, and +not relative to any specific gradient factor. For more information external to this manual see: Since the colours of the heat map are not affected by the gradient factor(s), the heat map is also +applicable when using the VPM-B decompression model. The image below compares the profiles and heat maps for two planned decompression dives to 60m: +the first using the Bühlmann decompression model, the second using the VPM-B decompression model. +Both profiles have the same total decompression time, but the VPM-B model requires deeper stops early in the acent phase. In both profiles, the inert gas pressures in the faster tissues rise much more rapidly than the slower tissues during +the descent and bottom phase, with the colors transitioning from light blue through blue and purple to black. +Similarly, the inert gas pressure in the fast tissues reduces more rapidly than the slow tissues at each decompression stop, +with colors transitioning from red, orange and yellow to green and black. The comparison of the two profiles and heatmaps shows that by including deep stops, the oversaturation gradient in the +faster tissues early in ascent phase is reduced. +However, on-gassing of slower tissues continues during the deep stops, which leads to greater oversaturation gradient +in slower tissues at the end of the dive.
+
+
+
+
+ |
+
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 +other than the ones that might have been +imported from a Dive Computer. Markers are placed against the depth profile line, +with the time of the event determined by the mouse cursor when the right +mouse button was clicked to bring up the menu. Gas Change events +involve a selection of which gas is being switched TO. The list of choices is based on +the available gases defined in the Equipment Tab. Setpoint change +events open a dialog letting you choose the next setpoint value. As +in the planner, a setpoint value of zero shows the diver is +breathing from an open circuit system while any non-zero value +shows 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.
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.
The default information in the Dive List includes, for each dive, Dive_number, Date, Rating, Dive_depth, Dive_duration and Dive_location. This information can be controlled and changed by right-clicking on the header bar of the Dive List. For instance, a right-click on the Date header brings up a list of items -that can be shown in the dive list (see above). Select an item to be shown in the Dive List or be +that can be shown in the dive list (see above). Select an item to be included in the Dive List or to be deleted (reflected by the check symbols) and the list is immediately updated. Preferences for information shown in the Dive List are saved and used when Subsurface is re-opened.
You can also renumber a few selected dives in the dive list. Select the dives that +for all the dives in the Dive List panel.
Renumber a few selected dives in the dive list by selecting only the dives that need renumbering. Right-click on the selected list and use the Dive List Context Menu to perform the renumbering. A popup window appears letting the user specify the starting number for the process.
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 in time by more than two days, so creating +date/times not separated by more than two days and creating a single heading for each diving trip represented in the dive log. Below is an ungrouped dive list (A, on the left) as well as the corresponding grouped dive list of five dive trips (B, on the right):
Grouping into trips allows a rapid way of accessing individual dives without having to scan a long lists of dives. To group the dives in a dive list, -(from the Main Menu) select Log → Autogroup. The Dive List panel +(from the Main Menu) select Log → Auto group. The Dive List panel now shows only the titles for the trips.
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 from +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 you can add or edit information about the date/time, the trip location and any other general comments about the trip as a whole (e.g. the dive @@ -3424,8 +3624,8 @@ edited information.
Once the dives have been grouped into trips, you can expand one or more -trips by clicking the arrow-head on the left of each trip title. This expands -the selected trip, revealing individual dives done during the trip.
Sometimes a dive is briefly interrupted, for example, if a diver returns to the surface
-for a few minutes. That results in two or more dives being recorded by the dive
-computer and appearing as different dives in the Dive List panel. You can
-merge these dives onto a single dive by selecting the appropriate dives,
+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.
+Merge these dives onto a single dive by selecting the appropriate dives,
right-clicking them to bring up the context menu and then selecting Merge selected
dives. It may be necessary to edit the dive information in the Notes
panel to reflect events or conditions that apply to the merged dive. The figure
@@ -3518,7 +3718,7 @@ To do this after performing any of these actions, from the Main Menu
The dives in the Dive List panel can be filtered, so you can select only some
+ The dives in the Dive List panel can be filtered, selecting only some
of the dives based on their attributes, e.g. dive tags, dive site, dive master, buddy or protective
clothing. For instance, filtering lets you list the deep dives at a particular
dive site, or otherwise the cave dives with a particular buddy.7.5. Filtering the dive list
-
Export of dives to Facebook is handled differently from other types of export because a connection to Facebook is required, needing a Facebook userID and password. -If, from the Main Menu, you select File → Preferences → Facebook, a login screen comes up. +If, from the Main Menu, you select Share on → Connect to → Facebook, a login screen comes up. (image A to the left, below). Provide a Facebook userID and password. Once logged into to Facebook , the panel in image B, below is shown, including a Disconnect from Facebook button to close the @@ -3582,10 +3782,10 @@ in image B, below is shown, including a Disconnect from Fac
From the Subsurface window it’s easy to determine whether Subsurface has a valid connection to Facebook -From the Main Menu, select Share on → Facebook (image A, below). Normally, the Facebook option is greyed out. But +From the Main Menu, select Share on (image A, below). Normally, the Facebook option is greyed out. But if there is a connection to Facebook, this option is active (i.e. in black color and can be selected).
Having established a login to Facebook, transferring a dive profileto a Facebook timeline is easy. -Be sure the dive to be transferred to the timeline is shown in the Subsurface Dive Profile panel. If, from the Main Menu, you +Ensure that the dive to be transferred to the timeline is shown in the Subsurface Dive Profile panel. If, from the Main Menu, you select Share on → Facebook (see image A below), a dialogue box is shown, determining the amount of additional information transferred along with the dive profile (image B, below). To transfer a dive profile to Facebook, the name of a Facebook album is needed. The checkboxes on the left hand side let you decide how much @@ -3617,7 +3817,7 @@ radio button (see images below).
A dive log or part of it can be saved in three formats:
A dive log or part of it can be saved in several formats:
@@ -3665,13 +3865,13 @@ Universal Dive Data Format (UDDF). Refer to http://uddf.org fo 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. calculated cylinder pressure, gas + 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 one’s + 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. That is useful for dive companies that wish to verify the dive history of a diver, - often doing away with the need to carry an original logbook + 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.
For each diver, dive log information is highly important. Not only is it a record
-of diving activities for one’s own pleasure, but it’s important information required
+of diving activities for your pleasure, but it’s important information required
for admission to training courses or sometimes even diving sites. The
security of the dive log is critical. To have a dive log that is
resistant to failure of a home computer hard drive, loss or theft of equipment, the
@@ -3838,7 +4038,7 @@ including some cylinder pressures, deco ceilings and O2/He/N2
If you prefers not to use the integrated cloud storage of dive logs (and
+ 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
Internet.
@@ -3928,14 +4128,14 @@ Under Print options select:
Printing only the dives selected from the dive list before
- activating the print dialogue by checking the box Print only
- selected dives. If this check box is not checked ALL dives in
+ activating the print dialogue by checking the box Print only selected dives. If this
+ check box is not checked ALL dives in
the Dive List panel are printed.
-Printing in color, done by checking the box with _Print in color. If this check box
+Printing in color, done by checking the box with Print in color. If this check box
is not checked, printing is in black and white.
Once the dive computer is connected to the Subsurface computer, select File → Configure dive
-computer from the Main Menu. Provide the appropriate device name in the text box at the
+computer from the Main Menu. Select the appropriate device name (or mount point) in the
+dropdown list at the
top of the configuration panel and select the appropriate dive
computer model from the panel on the left-hand (see image below). There are several user-definable settings within Subsurface, found by selecting
-File → Preferences. The settings are in
-seven groups: Defaults, Units, Graph, Language and Network, Facebook and Georeference.
-All operate on the same principles: the user must specify settings that are to be changed, then
-save them using the Apply button. After applying all the new settings users can then
-leave the settings panel by selecting OK. If Discard is selected, changes to the preferences
-are not saved. There are several settings in the Defaults panel: There are several headings in the Defaults panel:
-Lists and tables: Here you can specify the font type and font size of the
- Dive Table panel: By decreasing the font size of the Dive Table, you can see more dives on a screen.
+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 File you need to specify the directory and
+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:
@@ -4118,8 +4321,7 @@ are not saved.
-Local default file: When checked, Subsurface automatically loads a dive log from the local hard disk
- as described above.
+Local default file: When checked, Subsurface automatically loads a dive log from the local hard disk.
-Default cylinder: Specify the default cylinder listed in
+Default cylinder: From the dropdown list, select the default cylinder to be used in
the Equipment tab of the Notes panel.
Here you can choose between metric and imperial units of depth, pressure,
+ Choose between metric and imperial units of depth, pressure,
volume, temperature and mass. By selecting the Metric or Imperial radio button
at the top, you can specify that all units are in the chosen measurement system.
Alternatively, if you select the Personalize radio button, units can be selected
@@ -4183,80 +4385,111 @@ Choose the appropriate option. This panel has three sections: This panel allows two type of selections:
-Show: Here you can specify the amount of information shown as part of
- the dive profile:
+Gas pressure display setup. Even though nitrogen and helium pressures are also included here, these items mainly pertain to oxygen management:
-Thresholds: Subsurface can display the nitrogen, oxygen and the helium partial pressures during
- the dive, done by using the toolbar on the left hand side of the Dive Profile
- panel. For each of these graphs you can specify a threshold value on the right-hand side of the
- Preferences panel. If any of the graphs go above the specified threshold level, the graph is
+Thresholds: Subsurface can display graphs of the nitrogen, oxygen and the helium
+ partial pressures during
+ the dive, activated using the toolbar on the left of the Dive Profile
+ panel. For each of these graphs, specify a threshold value. If any of the graphs go
+ above the specified threshold, the graph is
highlighted in red, indicating the particular partial pressure threshold has been exceeded.
+ The pO2 threshold is probably the most important one and a value of 1.6 is commonly used.
-_Max pO2 is used for calculating the MOD when displaying the maximum operative depth (MOD)
- for a dive. Specify an appropriate partial pressure. A value of 1.4 is commonly used.
+pO2 in calculating MOD is used for calculating the maximum operative depth for a particular
+ nitrox or trimix gas mixture. A value of 1.4 is commonly used.
-Draw dive computer reported ceiling red: This checkbox does exactly what it says. By default
- the computer reported ceiling is shown in white.
- Not all dive computers report ceiling values. If the dive computer does report it, it may differ
- from the ceilings calculated by Subsurface because of the different algorithms and
- gradient factors, as well as the dynamic way a
- dive computer calculates ceilings during a dive.
+CCR Options: These options determine oxygen management for CCR dives:
+
+Dive planner default setpoint: Specify the O2 setpoint for a
+ CCR dive plan. This determines the pO2 maintained
+ during a particular dive. Setpoint changes during the dive can be added via the
+ profile context menu.
-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.
+CCR: Show setpoints when viewing pO2: With this checkbox activated, the pO2
+ graph on the dive profile has an overlay in red which indicates the CCR setpoint
+ values. See the section on Closed Circuit Rebreather dives.
-Show average 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.
+CCR: Show individual O2 sensor values when viewing pO2: Show the pO2
+ values associated with each of the individual oxygen sensors of a CCR system.
+ See the section on Closed Circuit Rebreather dives.
-Misc:
+Ceiling display setup. These settings mostly deal with nitrogen and helium management
+ by determining how the decompression ceiling (ascent ceiling) is calculated and displayed:
+Draw dive computer reported ceiling red: This checkbox does exactly what it says. By default
+ the computer reported ceiling is shown in white.
+ Not all dive computers report ceiling values. If the dive computer does report it, it may differ
+ from the ceilings calculated by Subsurface because of the different algorithms and
+ gradient factors, as well as the dynamic way a
+ dive computer calculates ceilings during a dive.
+
+Algorithm for calculating ceiling. Choose between the Bühlmann Z1H-L16
+ decompression model and the VPM-B model:
+
+VPM-B: Provide a conservatism level for calculating the VPM-B ceiling. Values between 0
+ (least conservative) and 4 (most conservative) are valid.
+
-Gradient Factors (GFLow and GFHigh):* Set the gradient factors used while diving. GF_Low is
- the gradient factor at depth and GF_High is used just below the surface.
+Bühlmann: Set the gradient factors (GFlow and GFHigh) for calculcating the deco ceiling following
+ the ZH-L16 algorithm. GF_Low is the gradient factor at depth and GF_High is used at the surface.
At intermediate depths gradient factors between GF_Low and GF_High are used.
- Gradient factors add conservatism to nitrogen exposure during a dive, in a
- similar way that many dive computers have a conservative setting. The lower
+ Gradient factors add conservatism to nitrogen and helium exposure during a dive, in a
+ similar way that many dive computers have a conservatism setting. The lower
the value of a gradient factor, the more conservative the calculations are with
- respect to nitrogen loading and the deeper the ascent ceilings are. Gradient
+ respect to inert gas loading and the deeper the ceilings are. Gradient
factors of 20/60 are considered conservative and values of 70/90 are considered
- harsh. Checking the GFLow at max depth box causes GF_Low to be used at the
- deepest depth of a dive. If this box is not checked, GF_Low is applied at
- all depths deeper than the first deco stop. For more information see:
+ harsh.
+ In addition decide whether to check the GFLow at max depth box. If checked, GF_Low is used for the
+ deepest dive depth and linearly increased up to the GF_High value at the surface. If unchecked,
+ GF_Low is used between the deepest dive depth and the first deco stop, after which the
+ gradient factor linearly increases up to the GF_High value at the surface. For more information see:
Understanding M-values by Erik Baker, Immersed Vol. 3, No. 3.
@@ -4271,45 +4504,44 @@ Gradient Factors (GFLow and GFHigh):* Set the gradient factors used whi
-CCR: Show setpoints when viewing pO2: With this checkbox activated, the pO2
- graph on the dive profile has an overlay in red which indicates the CCR setpoint
- values. See the section on Closed Circuit Rebreather dives.
+pSCR options. These preferences determine how passive semi-closed circuit (pSCR) dives
+ are planned and how the pSCR deco ceiling is calculated:
+
+Metabolic rate: this is the
+ volume of oxygen used by a diver during a minute. Set this value for pSCR dive planning
+ and decompression calculations.
-CCR: Show individual O2 sensor values when viewing pO2: Show the pO2
- values associated with each of the individual oxygen sensors of a CCR system.
- See the section on Closed Circuit Rebreather dives.
+pSCR ratio: The dilution ratio (or dump ratio) is the ratio of gas released to the
+ environment to that of the gas recirculated to the diver. A 1:10 ratio is commonly used.
-Configuring dive planning using rebreather equipment:
+Misc
-Default CCR setpoint for dive planning: Specify the O2 setpoint for a
- CCR dive plan. This determines the pO2 maintained
- during a particular dive. Setpoint changes during the dive can be added via the
- profile context menu.
-
-pSCR O2 metabolism rate: For a semi-closed rebreather (pSCR) system, this is the
- volume of oxygen used by a diver during a minute. Set this value for pSCR dive planning
- and decompression calculations.
+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.
-pSCR ratio: For pSCR equipment the dump ratio is the ratio of gas released to the
- environment to that of the gas recirculated to the diver. Set this value for a
- pSCR dive plan. A 1:10 ratio is commonly used.
+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.
Choose a language that Subsurface will use. A checkbox lets you use the System Default language which in most cases
-will be the correct setting; with this Subsurface simply runs in the same
-language / country settings as the underlying operating system.
+ 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
-lists similar languages. For instance there are several system variants of English
+to list similar languages. For instance there are several system variants of English
or French. This particular preference requires a restart of Subsurface to take
effect. In this section also specify appropriate date an time formats for showing dive details. This dialogue has three sections: This panel lets you log into a Facebook account in order to transfer information
-from Subsurface to Facebook. If you provide a valid Facebook userID and password, a
-connection to Facebook is created. That connection is closed when one
-closing down Subsurface. Currently the checkbox labelled "Keep me logged in to Subsurface",
-on the login screen has no effect.
-See the section Exporting dive profiles to Facebook
-for more information. 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 Companion app). A search on the Internet is done to find
@@ -4415,7 +4631,7 @@ Internet connection. The preference of the dive site name can be configured, e.g
or City/State/Country (see image below). Dive planning is an advanced feature of Subsurface, accessed by selecting
Log → Plan Dive from the main menu. It allows calculation of
-nitrogen load during a dive by using the Bühlmann ZH-L16 algorithm with the addition
+inert gas load during a dive by using the Bühlmann ZH-L16 algorithm with the addition
of gradient factors as implemented by Erik Baker. In addition, there is the option "Save new". This keeps the original
-planned dive and adds a (possibly modified) copy to the dive list. If
+planned dive and adds a (possibly modified, - earlier dives are now taken into account -) copy to the dive list. If
that copy is saved with the same start time as the original, the two
dives are considered two versions of the same dive and do not
influence other each during decompression calculation (see next section). If you have just completed a long/deep dive and are planning
-another dive, then highlight, in the Dive List, the dive that has just been done
+another dive, then highlight, in the Dive List, the dive that has just been logged
then activate the planner. Depending on the start time of the planned dive,
the planner takes into account the gas loading during the completed dive
and plans accordingly.
-Open cloud storage - Open the dive log previously saved in Cloud storage.
+Save - Save the dive logbook currently open.
-Save - Save the dive logbook currently open.
+Save as - Save the current logbook under a different file name.
+
+Open cloud storage - Open the dive log previously saved in Cloud storage.
-Save as - Save the current logbook under a different file name.
+Take cloud storage online -
9.4. Other cloud services
-12. Setting user Preferences for Subsurface
12.1. Defaults
-
12.2. Units
12.3. Graph
+
+
+
+
+
+
+
+
12.5. Network
@@ -4342,7 +4574,7 @@ connection to the Internet and by the Internet Service Provider (ISP) used.
Your ISP should provide the appropriate information.12.6. Facebook Access
-12.7. Georeference
+12.6. Georeference
+The Edit option allows one to undo or redo an action, e.g. deleting dives. +
+@@ -4997,7 +5255,7 @@ dealing with the appropriate operations.
@@ -5056,7 +5314,7 @@ dealing with the appropriate operations.
@@ -5108,7 +5366,7 @@ dealing with the appropriate operations.
@@ -5118,7 +5376,7 @@ dealing with the appropriate operations.
@@ -5262,10 +5520,14 @@ the import settings as /dev/ttyUSB3
which directs Subsurface to the
USB port.
Ensuring the user has write permission to the USB serial port:
On Unix-like operating systems the USB ports can only be accessed by users who
-are members
-of the dialout
group. If one is not root, one may not be a member of
+are members special group that can be e.g.
+dialout
or uucp
. This can be verified by listing the appropriate
+device permissions e.g. by ls -l /dev/ttyUSB0
. Note that the number in
+the file name depends on how many USB devices you have connected, and
+must be adjusted appropriately.
+If you are not root, you may not be a member of
that group and
-won’t be able to use the USB port. Let us assume one’s username is johnB.
@@ -5286,13 +5548,13 @@ among the different IDs.
Under some circumstances this change takes only effect (eg. on Ubuntu) after -one logs out and then logs in again. +you log out and then log in again.
With the appropriate device name (e.g. dev/ttyUSB3
) and with write permission
to the USB
-port, the dive computer interface can connect and one should be able to import
+port, the dive computer interface can connect and you should be able to import
dives.
sudo hciconfig hci1 down
Next step is to trust and pair the dive computer. On distros with Bluez 5, such as Fedora 22,
-one can use a tool called blutootctl
, which will bring up its own command prompt.
blutootctl
, which will bring up its own command prompt.
bluetoothctl
@@ -5488,7 +5750,7 @@ Scanning ...
If one omits it, channel 1 is assumed. Based on a limited number of user reports, +
If you omit it, channel 1 is assumed. Based on a limited number of user reports, the appropriate channel for the dive computer is probably:
otu
(string) OTU value for the dive
sumWeight
(string) the summed weight of all used weight systems
startPressure
(string) the start pressure
endPressure
(string) the end pressure
firstGas
(string) first used gas