Audience: Recreational Scuba Divers, Free Divers, Tec Divers, Professional -Di vers
One can enter the coordinates by hand if they are known, using one of -three formats with latitude followed by longitude: +four formats with latitude followed by longitude:
Degrees and decimal minutes, e.g: N30° 13.49760' , E30° 49.30788'
+ISO 6709 Annex D format e.g. 30°13'28.9"N 30°49'1.5"E
+Degrees and decimal minutes, e.g. N30° 13.49760' , E30° 49.30788'
Degrees minutes seconds, e.g. N30° 13' 29.8" , E30° 49' 1.5"
Decimal degrees, e.g. 30.22496 , 30.821798
The + button at the top right allows you to add more cylinders for this dive. The dark dustbin icon on the left allows you to delete information for a cylinder.
Start by selecting a cylinder type. The AL80 cylinder is shown as the default -cylinder type (you can change this default in the preferences if you usually -dive with a different type of tank). If you wish to change the tank used on this -dive, click on the AL80. This will bring up a dropdown list, accessible through -a down-arrow:
Start by selecting a cylinder type on the left-hand side of the table. To select +a cylinder click in the cylinder type box. This brings up a list button that can be +used to display a dropdown list of cylinders:
Use the drop-down list to select the cylinder type you used for this dive. The -Size of the cylinder as well as its working pressure (WorkPress) will auto -matically be shown in the dialogue.
Now you need to indicate the starting pressure and the ending pressure of the gas used during your dive. The unit of pressure (metric/imperial) corresponds to the setting you chose in the preferences.
@@ -823,7 +822,7 @@ your brand and type)
In Subsurface, from the Main Menu, select Import → Import From Dive Computer. -The following dialogue appears: +Dialogue A inthe figure below appears:
-Click the OK button. +Click the OK button. Dialogue B in the figure above appears. +
++With communication established, watch how your data is retrieved from your +dive computer! +Depending on your make of computer and/or number of dives, this +could take some time. Please be patient. The Download dialogue shows a +progress bar at the bottom of the dialogue (but for some dive computers the +progress information could be inaccurate as we cannot determine how much downloadable +data there is until all data have been downloaded). When download of the dive information +is complete, all the imported dives appear +in the Dive List, sorted by date and time. Disconnect and switch off the dive +computer to conserve its battery power. +If you select a particular dive, the Dive Profile panel shows an informative +graph of dive depth against time for that particular dive.
If your Subsurface computer does not recognise the USB adaptor by showing an appropriate device name next to the Mount Point, then there is a possibility that the cable or USB adaptor is faulty. A faulty cable is the most common cause of communication failure between dive computer and Subsurface computer. It is also possible that your Subsurface computer is missing required -drivers to interact with the download cable and connected dive computer. - -
If all the above points are in order and there is a failure to download the dive data, then perform a download with the following two check boxes checked in the download dialogue discussed above:
-With communication established, watch how your data is retrieved from your -dive computer! -Depending on your make of computer and/or number of dives, this -could take some time. Please be patient. The Download dialogue shows a -progress bar at the bottom of the dialogue (but for some dive computers the -progress information could be inaccurate as we cannot determine until after all -data was downloaded how much downloadable data there is): -
-
-When download of the dive information is complete, all the imported dives appear -in the Dive List, sorted by date and time. Disconnect and switch off the dive -computer to conserve its battery power. -If you select a particular dive, the Dive Profile panel shows an informative -graph of dive depth against time for that particular dive.
Start by selecting a cylinder type. The AL80 cylinder is shown as the default -cylinder type (you can change this default in the preferences if you usually -dive with a different type of tank). If you wish to change the tank used on this -dive, click on the AL80. This will bring up a drop-down list, accessible through -a down-arrow:
Start by selecting a cylinder type on the left-hand side of the table. To select a +cylinder click in the cylinder type box. This brings up a list button that can be used +to display a dropdown list of cylinders:
@@ -1139,12 +1130,16 @@ the new data should be saved.Maybe you have a lot of dives logged using other dive log software. You don’t have to type all information by hand into Subsurface, because you can probably import your divelog. Subsurface will import divelogs from a range of other -dive log software. Some software is supported natively (e.g. divelogs.de, -JDiveLog, MacDive, and Suunto DM4), for others you have to export your logbook -to XML and then Subsurface can import that XML file (Suunto DM3, DivingLog). +dive log software. Some software is supported natively, for others you have to +export your logbook to XML and then Subsurface can import that XML file. +We do support importing CSV log files, with APD LogViewer, XP5 and Sensus being +preconfigured, but the import being flexible, users can configure their own +imports as well. Manually kept log files (e.g. in spreadsheet) can also be +imported by configuring the CSV import. Subsurface can also import UDDF and UDCF files that are used by some divelog software and even some divecomputers like the Heinrichs & Weikamp DR5. Finally, -for some divelog software we currently suggest to import your logbook first +for some divelog software like Mares Dive Organiser we currently suggest to +import your logbook first into a webservice like divelogs.de and then import them from there with Subsurface, as divelogs.de supports a few additional logbook formats that Subsurface currently cannot parse.
Before you can start importing dives from Suunto Divemanager, you first -have to export the dives you want to import. Subsurface does not import -directly from the Suunto Divemanager log files. The following procedures -can be used for Linux and Windows.
-Start Suunto Divemanager and log in with the name containing the logs -
--Do not start the import wizard to import dives from your computer. -
--In the navigation tree on the left side of the program-window, select your -dives. -
--Within the list of dives, select the dives you would like to import later: -
--To select certain dives: hold ctrl and click the dive -
--To select all dives: Select the first dive, hold down shift and select the -last dive -
--With the dives marked, use the program menu File → Export -
--The export pop-up will show -
--Within this pop-up, there is one field called Export Path. -
--Click the browse button next to the field Export Path -
--A file-manager like window pops up -
--Navigate to the directory where you want to store the Divelog.SDE file -
--Optionally change the name of the file you want to save -
--Click Save -
--You are back in the Export pop-up. Press the button Export -
--Your dives are now exported to the file Divelogs.SDE. -
-The file Divelogs.SDE can now be opened (or imported) in Subsurface.
To import divelog from Suunto DM4, you need to locate the DM4 database -where the dives are stored. You can either look for the original -database or take a backup of the dives. Both methods are described here.
-Start Suunto DM4 -
--Select Help → About -
--Click Copy after text Copy log folder path to clipboard -
--Now open Windows Explorer -
--Paste the address to the path box at the top of the File Explorer -
--The database is called DM4.db -
--Start Suunto DM4 -
--Select File - Create backup -
--From the file menu select the location and name for the backup, we’ll - use DM4 in here with the default extension .bak -
--Click Save -
--Your dives are now exported to the file DM4.bak -
-Importing the logs from DM4 does not require any special steps. You just -do the following:
-Open the following menu File → Import File(s) -
--Browse your directories to the location where your DM4 backup is - stored -
--Select the backup file you want to import and click Open -
-It is also possible to do the importing from command line:
Importing dives from other software is performed through a unified interface that +is activated by selecting Import from the Main Menu, then clicking on +Import Log Files. This brings up the dialogue A below.
subsurface MyDives.xml --import DM4.bak
Towards the bottom right is a dropdown selector with a default lable +of Dive Log Files which gives access to the different types of direct imports +available, as in dialogue B, above. Currently these are:
+XML-formatted dive logs +
++UDDF-formatted dive logs +
++UDCF-formatted dive logs +
++JDiveLog +
++Suunto Dive Manager (DM3 and DM4) +
++MacDive (XML) +
++DivingLog 5.0 (XML) +
++Kenozooid (UDDF) +
++CSV (text-based and spreadsheet-based) dive logs. +
+Selecting the appropriate file in the file list of the dialogue opens +the imported dive log in the Subsurface Dive List. A few other formats, not +accessible through the Import dialogue are also supported, as explained below.
Mares Dive Organiser is a Windows application. The dive log is kept as a -Microsoft SQL Compact Edition data base with a .SDF filename extension. The -data base includes all Dive Organiser-registered divers on the particular -computer and all Mares dive computers used. The safest way to obtain a copy -of this data base is, within Dive Organiser, to select Database → Backup -from the main menu and to back up the data base to your desk top. This -creates a zipped file DiveOrganiserxxxxx.dbf. Rename the file to -DiveOrganiserxxxxx.zip. Inside the zipped directory is a file DiveOrganiser.sdf. -Extract it from the zipped folder to your Desktop.
Then use www.divelogs.de as a mechanism to extract the dive information from -the file. Create a user account in divelogs.de , log into that web site, then -select Import Logbook → Dive Organiser from the menu on the left hand side. +
Mares dive logs need to be imported using a three-step process, +using www.divelogs.de as a mechanism to extract the dive information from +the file.
+Export dive log data from Mares Dive Organiser to your desktop. See +Appendix C for more information. +
++Import the data into www.divelogs.de. Create a user account in +www.divelogs.de, log into that web site, then +select Import Logbook → Dive Organiser from the menu on the left hand side. Follow the instructions carefully to transfer the dive information from the -Dive Organiser data base to divelogs.de.
Then follow the instructions below to import dives from divelogs.de to -Subsurface.
+Then follow the instructions below to import dives from divelogs.de to +Subsurface. +
+The import of dive information from divelogs.de is simple, using a single dialogue box. Select Import→Import form Divelogs.de from the Main Menu. This -brings up a dialogue box (see figure on left [A] below). You need to enter a +brings up a dialogue box (see figure on left [A] below). You need to enter a user-ID and password for divelogs.de into the appropriate fields. Then select the Download button. Download from divelogs.de starts immediately, evident on a progress bar in the dialogue box. At the and of the download, the -successful status is indicated (see figure on the right [B], below). Select the +successful status is indicated (see figure on the right [B], below). Select the Apply button. The imported dives appear in the Dive List panel.
Importing logs from MacDive is as easy as it gets. Do the following -steps in Subsurface:
-Open the following menu File - Import File(s) -
--Browse your directories to the location where your MacDive logs are - stored -
--Select the log file(s) you want to import and click open -
--Click the OK button in the pop-up -
-After a few moments, you see your existing logs in Subsurface. Now you can -edit your dives like explained in the section Updating the Dive Information.
Subsurface imports all the relevant dive information -excluding the used equipment and diver name.
It is also possible to do the import from command line:
subsurface MyDives.xml --import MacDiveDives.xmlBefore you can start importing dives from DivingLog you first have to -export those dives. Unfortunately DivingLog XML files give us no -indication on the preferences set on your system. So in order for -Subsurface to be able to successfully import XML files from DivingLog -you first need to make sure that your copy of DivingLog is configured -to use the Metric system (you can easily change this in File → -Preferences → Units and Language by clicking the Metric -button). Then do the following:
-In Divinglog open the File → Export → XML menu -
--Select the dives that you want to export -
--Click on the export button and select the filename -
-This file can now be opened in Subsurface (as described in the previous -sections).
JDiveLog stores its information in files with the extension of .jlb that contain -all the information except images in XML format.
By using File → Import File(s) from the Main Menu you get a pop-up asking -for the file name. To import your JDiveLog file(s) do the following:
-Open File → Import File(s) on the menu -
--Browse your directories to the location where your *.jlb file is -
--Select your existing *.jlb file and click open -
--Click the OK button in the pop-up -
-After a few moments, you see your existing logs in Subsurface. Now you can -edit your dives like explained in the section Updating the Dive Information.
Information that is imported from JDiveLog into the location field:
-Extended dive location information -
-Information that is merged into the notes field:
-Used amount of weight -
--Used type of suit -
--Used type of gloves -
--Type of dive -
--Dive activity -
-Alternatively, you can start Subsurface with the --import command line -which will have the same effect:
subsurface MyDives.xml --import JDiveLogDives.jlbwill open your divelog (assuming that’s called MyDives.xml) and then -import the dives from JdivelogDives.jlb. You can now save the combined -divelog back as MyDives.xml.
Kenozooid uses UDDF to store dives and is tested to work with Subsurface. -Make sure you are not using compressed files when importing to Subsurface -or uncompress them manually beforehand.
Subsurface supports UDDF as a generic import format. -Some attributes in your file may not get processed properly. Select -Import→Import Files from the Main Menu. Then select the UDDF file to -be imported.
Sometimes dive computers export dive information as files with -comma-separated variables (.CSV). For example, the APD Inspiration and Evolution +comma-separated values (.CSV). For example, the APD Inspiration and Evolution closed circuit rebreather (CCR) systems export dive information in CSV format that normally contains information about a single dive only. These files can easily be imported into Subsurface. CSV files are normally organised into @@ -1582,9 +1291,9 @@ needs to know:
-Which character separates the different colums within a single line of data? This +Which character separates the different columns within a single line of data? This field separator should be either a comma (,) or a TAB character. This could be determined -by opening the file with a text editor. If it is commma-delimited, then the comma +by opening the file with a text editor. If it is comma-delimited, then the comma characters between the values are clearly visible. If no commas are evident, the file is probably TAB-delimited (i.e. it uses a TAB as a field separator, as in the above example).
@@ -1592,7 +1301,7 @@ is probably TAB-delimited (i.e. it uses a TAB as a field separator, as in the abWhich data columns need to be imported into Subsurface?. The Dive Time and -Depth colums are always required. Open the file using a text editor and note the +Depth columns are always required. Open the file using a text editor and note the titles of the columns to be imported and their column positions. For instance for the above example:
@@ -1606,10 +1315,13 @@ ppO2: column 4Armed with this information, the import into Subsurface is straightforward. Select -Import→Import CSV from the main menu. The following dialogue appears:
+
Specify the name of the CSV file or select it from the browser button on the right. @@ -1627,6 +1339,65 @@ the image. Having performed the column specification, select the OK button and the dive will be imported and listed in the Dive List tab of Subsurface.
If one keeps dive logs in a spreadsheet, there is an option to import +those dives as well. Spreadsheet data, exported as a CSV file, can +be imported to Subsurface. When importing manually +kept log files, the information needed is quite different as we are +importing only metadata, not profile samples.
Similarly to importing dives in CSV format (see above), one needs to +know the internal format +of the CSV data to import.
+Which character separates the different columns within a single line of data? This +should be either a comma (,), semicolon (;) or a TAB +character, and could be determined by opening the file with a text +editor. If it is comma-delimited, then the comma +characters between the values are clearly visible. If no commas are evident and the data +are in clear columns, the file +is probably TAB-delimited (i.e. it uses a TAB as a field separator, as in the above example). +A recommended field separator for the export is tab, as comma might be used in the +fields themselves. +
++Which columns need to be imported into Subsurface?. We do not +currently have any mandatory input fields, but some, e.g. dive duration +are crucial for the log file to make any sense. Possible options +can be seen in the image below and one should include all the +fields that are available in both your log file and in the Subsurface +import. +
++Units used for depth, weight and temperature. We consider depth to be +either feet or meters, weight kilograms or pounds and temperature either +Celsius or Fahrenheit. However, you can only select Metric or +Imperial. No mixture of unit systems is allowed for the different fields. +
+Importing manually kept CSV log files is quite straight forward, but +there might be many fields and counting the field numbers is error +prone. Therefore validation of the data to be imported is critical.
To import your dives, select Import→Import Log Files from the menu +bar. If the CSV option in the dropdown list is selected and the file list +includes file names ending with .CSV, one can select the +Manual dives tab that will bring up the following configuration dialog:
+Configure your input fields as appropriate, and when everything is done +select the OK button to perform the import. New dives should appear in +the Dive List area of Subsurface.
Download the app from -Google Play Store or from F-Droid. +Google Play Store or +from F-Droid.
@@ -2018,7 +1790,7 @@ open a further selection of which gas is being switched to, the list based on
the available gases defined in the Equipment Tab. By right-clicking while over
an existing marker, the menu extends adding options to allow deletion of the
marker or to allow all markers of that type to be hidden. Hidden events can be
-restored to view by selecteing Unhide all events from the context menu.
+
The context menu is used in many manipulations described below.
Now you need to select the print options. To do this, select File→Print from the Main menu. The following dialogue appears (see the image on the left [A], -below):
-Under Print type you need to select one of three options:
You can Preview the printed page by selecting the Preview button on the dialogue. After preview, changes to the options in the print dialogue can be made to give a layout that fits personal taste.
+Now, select the Print button in the dialogue. This activates the regular print -dialogue used by your operating system, allowing you to choose a printer and -to set its properties. Remember to set the print resolution of the printer to -an appropriate value by changing the printer properties. Finally, print the -dives. Above on the right (B) is an example of the output for one particular -dive.
+There are four settings in the Defaults panel:
+@@ -2348,6 +2130,11 @@ the Equipment tab of the Dive Notes panel.
+Here you can choose between metric and imperial measures 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 @@ -2357,6 +2144,11 @@ measures.
+This panel allows two type of selections:
+Full Screen - Toggles Full Screen mode. +
+|
@@ -2786,8 +2583,28 @@ ftdi_sio: v1.6.0:USB FTDI Serial Converters Driver
You see that in the third line from the bottom, the USB adapter is
detected and is connected to /dev/ttyUSB3. This directs Subsurface to the correct USB port.
+Ensuring you have 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
With the appropriate device name (e.g. 10.3. Setting up bluetooth enabled devices@@ -2986,11 +2803,254 @@ switch off WiFi while using Bluetooth
+
12. APPENDIX C: Exporting Dive log information from external dive log software.+
+
+The import of dive log data from external dive log software is mostly performed using +the dialogue found by selecting Import from the Main Menu, then clicking on +Import Log Files. This is a single-step process, more information about which can be found +here. +However, in some cases, a two-step process may be required:
This appendix provides some information about approaches to export dive log data from foreign +dive log software. The procedures below mostly apply to Linux and/or Windows.
+
+12.1. Exporting dives from Suunto Divemanager 3 (DM3)+
+
+12.2. Exporting dives from Suunto Divemanager 4 (DM4)+To import divelog from Suunto DM4, you need to locate the DM4 database +where the dives are stored. You can either look for the original +database or take a backup of the dives. Both methods are described here. Locating the Suunto DM4 database:
Backing up Suunto DM4:
+
+12.3. Exporting from Mares Dive Organiser V2.1+Mares Dive Organiser is a Windows application. The dive log is kept as a +Microsoft SQL Compact Edition data base with a .SDF filename extension. The +data base includes all Dive Organiser-registered divers on the particular +computer and all Mares dive computers used. Since +Mares utilise proprietory Windows software not compatible with multi-platform software, +these dive logs cannot be directly imported into Subsurface. The safest way to obtain a copy +these dive data base is to export the information to another compatibale format +which can be imported into Subsurface.
+
+12.4. Exporting dives from DivingLog 5.0+Unfortunately DivingLog XML files give us no +indication on the preferences set on your system. So in order for +Subsurface to be able to successfully import XML files from DivingLog +you first need to make sure that your copy of DivingLog is configured +to use the Metric system (you can easily change this in File → +Preferences → Units and Language by clicking the Metric +button). Then do the following:
|