From f7bb3772879cccd41ebc6a2228a54d73209aa9be Mon Sep 17 00:00:00 2001 From: Dirk Hohndel Date: Fri, 7 Feb 2014 06:53:01 -0800 Subject: User manual: update html file shipped with git repository Every once in a while I need to update this so people building from source who don't have asciidoc installed still have a reasonably current manual. Signed-off-by: Dirk Hohndel --- Documentation/user-manual.html.git | 868 ++++++++++++++++++++----------------- 1 file changed, 464 insertions(+), 404 deletions(-) (limited to 'Documentation') diff --git a/Documentation/user-manual.html.git b/Documentation/user-manual.html.git index 2c0869777..6da2f5429 100644 --- a/Documentation/user-manual.html.git +++ b/Documentation/user-manual.html.git @@ -426,7 +426,7 @@ Please discuss issues with this program by sending an email to software and (if needed) its dependencies please consult the INSTALL file included with the source code.

Audience: Recreational Scuba Divers, Free Divers, Tec Divers, Professional -Di vers

+Divers

Table of Contents
@@ -584,11 +584,12 @@ using that device.

  • 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
    @@ -648,19 +649,17 @@ like this:

    • 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:

    FIGURE:The cylinder drop-down list button

    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.

    +Size of the cylinder as well as its working pressure (WorkPress) will +automatically 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.

    @@ -671,7 +670,7 @@ fields empty. After typing the information for the cylinder then either press ENTER on the keyboard or click outside the cell that contains the cursor. Add information for any additional cylinders by using the + button at the top right hand. Here is an example of a complete description for a -dive using two cylinders (air and EAN40):

    +dive using two cylinders (air and EAN50):

    FIGURE: a completed cylinder dive information table @@ -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:

    • @@ -861,7 +860,23 @@ of your Subsurface computer.

  • -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.

  • @@ -879,21 +894,22 @@ message will be shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares Important -Check the following: -1) Is the dive computer still in PC-communication or Upload mode? +Check the following: 1) Is the dive computer still in PC-communication or Upload mode? 2) Is the battery of the dive computer fully charged? If not then charge or replace the battery. 3) Is the cable faulty? Does the cable work perfectly using other software? Has it worked before, or is this the first time you are using the cable? 4) Consult Appendix A and make sure you specified the correct Mount Point -(see above). If your Subsurface computer does not recognise the USB adaptor by +(see above). +5) On Unix-like operating systems, do you have write permission to the USB port? If not, consult appendix A. + +
    • +

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

    +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:

    @@ -916,29 +932,6 @@ request that the files be analysed, providing your dive computer make and model as well as contextual information about the dives recorded on the dive computer.

    -
      -
    • -

      -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): -

      -
      • -
    -
    -
    -FIGURE: Download dialogue 2 -
    -
    -

    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.

    3.2.2. Updating the dive information imported from your dive computer.

    @@ -1064,11 +1057,9 @@ like this:

    automatically inserts the gas composition(% oxygen) in the table. 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 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:

    FIGURE: The cylinder drop-down list button @@ -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.

    @@ -1154,237 +1149,107 @@ 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.

    -

    3.3.1. Importing dives from Suunto Divemanager 3 (DM3)

    -

    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.

    -
    -
    Export from Suunto Divemanager
    -
      -
    • -

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

      -
      • -
    -
    -
    -
    Reading Suunto Divemanager Export in Subsurface
    -

    The file Divelogs.SDE can now be opened (or imported) in Subsurface.

    +

    3.3.1. Using the universal import dialogue

    +

    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.

    +
    +
    +FIGURE: Import dialogue: step 1
    -
    -

    3.3.2. Importing 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
    +

    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:

    • -Start Suunto DM4 +XML-formatted dive logs

    • -Select Help → About +UDDF-formatted dive logs

    • -Click Copy after text Copy log folder path to clipboard +UDCF-formatted dive logs

    • -Now open Windows Explorer +JDiveLog

    • -Paste the address to the path box at the top of the File Explorer +Suunto Dive Manager (DM3 and DM4)

    • -The database is called DM4.db +MacDive (XML)

      • -
    -
    -
    -
    Backing up Suunto DM4
    -

    • -Start Suunto DM4 -

      -
      • -
    • -

      -Select File - Create backup +DivingLog 5.0 (XML)

    • -From the file menu select the location and name for the backup, we’ll - use DM4 in here with the default extension .bak +Kenozooid (UDDF)

    • -Click Save -

      -
      • -
    • -

      -Your dives are now exported to the file DM4.bak +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.

    -
    -
    Reading Suunto DM4 backup in Subsurface
    -

    Importing the logs from DM4 does not require any special steps. You just -do the following:

    +
    +

    3.3.2. Importing from Mares Dive Organiser V2.1

    +

    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.

    • -Open the following menu File → Import File(s) +Export dive log data from Mares Dive Organiser to your desktop. See +Appendix C for more information.

    • -Browse your directories to the location where your DM4 backup is - stored +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 www.divelogs.de.

    • -Select the backup file you want to import and click Open +Then follow the instructions below to import dives from divelogs.de to +Subsurface.

    -

    It is also possible to do the importing from command line:

    -
    -
    -
    subsurface MyDives.xml --import DM4.bak
    -
    -
    -

    3.3.3. Importing 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. 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. -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.

    -
    -
    -

    3.3.4. Importing dives from divelogs.de

    +

    3.3.3. Importing dives from divelogs.de

    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.

    @@ -1393,165 +1258,9 @@ successful status is indicated (see figure on the right [B], below). Select the
    -

    3.3.5. Importing dives from MacDive

    -

    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.xml
    -
    -
    -
    -

    3.3.6. Importing dives from DivingLog 5.0

    -

    Before 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).

    -
    -
    -

    3.3.7. Importing dives from JDiveLog

    -

    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.jlb
    -
    -

    will 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.

    -
    -
    -

    3.3.8. Importing dives from Kenozooid

    -

    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.

    -
    -
    -

    3.3.9. Importing UDDF Dives

    -

    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.

    -
    -
    -

    3.3.10. Importing dives in CSV format

    +

    3.3.4. Importing dives in CSV format

    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:

    1. -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 ab

    2. Which 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 4

    Armed with this information, the import into Subsurface is straightforward. Select -Import→Import CSV from the main menu. The following dialogue appears:

    +Import→Import Log Files from the main menu. In the appearing file +selection menu, select one or more CSV files. Format is detected by the file +extension, and a common configuration dialog is presented for all the +files with CSV extension. The configuration dialog is following:

    -FIGURE: CSV download dialogue +FIGURE: CSV download dialogue

    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.

    +
    +

    3.3.5. Importing dives from manually kept CSV file

    +

    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.

    +
      +
    1. +

      +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. +

      +
      2. +
    2. +

      +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. +

      +
      3. +
    3. +

      +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. +

      +
      4. +
    +

    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:

    +
    +
    +FIGURE: Download dialog for Manual CSV logs +
    +
    +

    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.

    +

    3.4. Importing GPS coordinates with the Subsurface Companion app for mobile phones

    @@ -1644,7 +1415,8 @@ a long number that gives access to the companion app capabilities.

  • Download the app from -Google Play Store or from F-Droid. +Google Play Store or +from F-Droid.

    • @@ -1822,9 +1594,9 @@ your Android device.

    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 → Import GPS data from Subsurface Service, resulting in the image on the -left (A), below. On first use the DIVERID text box will be blank. Provide the +left (A), below. On first use the DIVERID text box will be blank. Provide the DIVERID. Then select the Download button and the download begins. When this -is completed you see the screen on the right (B), below:

    +is completed you see the screen on the right (B), below:

    FIGURE: Downloading Companion app GPS data @@ -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.

    +restored to view by selecting Unhide all events from the context menu.

    4.5. The Information Box

    @@ -2063,7 +1835,7 @@ mostly to manipulate groups of dives. The context menu is found by selecting a dive or a group of dives and then right-clicking.

    -Figure: Context Menu +Figure: Context Menu

    The context menu is used in many manipulations described below.

    @@ -2184,7 +1956,7 @@ computer and appearing as different dives in the Dive List pane merge these dives onto a single dive by selecting the appropriate dives and right-clicking them to bring up the context menu. Then select Merge selected dives. It may be necessary to edit the dive information in the Dive Notes -panelto reflect events or conditions that apply to the merged dive. The figure +panel to reflect events or conditions that apply to the merged dive. The figure below shows the depth profile two such dives that were merged:

    @@ -2245,12 +2017,7 @@ the appropriate information from the Main Menu: File→Preferences→

    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):

    -
    -
    -FIGURE: Print dialogue -
    -
    +below).

    Under Print type you need to select one of three options:

    • @@ -2295,12 +2062,22 @@ text above the dive profile.

    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.

    +
    +
    +FIGURE: Print dialogue +
    +

    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.

    +dialogue used by your operating system (image [B] in the middle, above), allowing +you to choose a printer and to set its properties (image [C] on the right, above). +Remember to set the print resolution of the printer to an appropriate value by changing +the printer properties. Finally, print the dives. Below is a (rather small) example of +the output for one particular page.

    +
    +
    +FIGURE: Print preview page +
    +
    @@ -2315,6 +2092,11 @@ leave the settings panel by selecting OK.

    8.1. Defaults

    There are four settings in the Defaults panel:

    +
    +
    +FIGURE: Preferences defaults page +
    +

    • @@ -2348,6 +2130,11 @@ the Equipment tab of the Dive Notes panel.

    8.2. Units

    +
    +
    +FIGURE: Preferences Units page +
    +

    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.

    8.3. Graph

    +
    +
    +FIGURE: Preferences Graph page +
    +

    This panel allows two type of selections:

    • @@ -2644,6 +2436,11 @@ year. Next DC - Switch to previous dive computer.

      • +
    • +

      +Full Screen - Toggles Full Screen mode. +

      +
    @@ -2720,7 +2517,7 @@ On a Mac you at times have to manually hunt for the correct
    -

    10.2. How to Find the Device Name for USB devices

    +

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

    @@ -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 ttyUSB3. Now you use this information in -the import settings as /dev/ttyUSB3. Your dive computer interface is -connected and you should be able to import your dives.

    +the import settings as /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 dialout group. If you are not root, the user may not be a member of that group and +will not be able to use the USB port. Let us assume your username is johnB.

    +
      +
    • +

      +As root, type: usermod -a -G dialout johnB (Ubuntu users: sudo -a -G dialout johnB) +This makes johnB a member of the dialout group. +

      +
      • +
    • +

      +Type: id johnB This lists all the groups that johnB belongs to and verifies that +the appropriate group membership has been created. The dialout group should be listed +among the different IDs. +

      +
      • +
    +

    With the appropriate device name (e.g. dev/ttyUSB3) and with write permission to the USB +port, your dive computer interface can connect and you should be able to import your dives.

    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:

    +
      +
    • +

      +Export the forieign dive log data to format that is accessible from Subsurface. +

      +
      • +
    • +

      +Import the accessible dive log data into Subsurface. +

      +
      • +
    +

    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)

    +
      +
    • +

      +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. +

      +
      • +
    +
    +
    +

    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:

    +
      +
    • +

      +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 +

      +
      • +
    +

    Backing up Suunto DM4:

    +
      +
    • +

      +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 +

      +
      • +
    +
    +
    +

    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.

    +
      +
    • +

      +Within Dive Organiser, select +Database → Backup from the main menu and back up the data base to the 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. +

      +
      • +
    +
    +
    +

    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:

    +
      +
    • +

      +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 +

      +
      • +
    +
    +
    +
    -- cgit v1.2.3-70-g09d2