From a721550a3ae1b44d3bbbb8868b22c50cabd80506 Mon Sep 17 00:00:00 2001 From: Dirk Hohndel Date: Sat, 13 Jul 2019 18:44:49 -0700 Subject: user manual: update the bundled html version And fix the date to say July. Signed-off-by: Dirk Hohndel --- Documentation/user-manual.html.git | 681 +++++++++++++++++++++++-------------- Documentation/user-manual.txt | 4 +- 2 files changed, 436 insertions(+), 249 deletions(-) (limited to 'Documentation') diff --git a/Documentation/user-manual.html.git b/Documentation/user-manual.html.git index 42cf4b793..1a28417a2 100644 --- a/Documentation/user-manual.html.git +++ b/Documentation/user-manual.html.git @@ -446,7 +446,7 @@ asciidoc.install(3);

Manual authors: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg, Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Pedro Neves, Stefan Fuchs

-

Version 4.8, September 2018

+

Version 4.9, July 2019

Welcome as a user of Subsurface, an advanced dive logging program with extensive infrastructure to describe, organize, interpret and print scuba and free dives. Subsurface offers many advantages over other similar @@ -587,7 +587,7 @@ another survey, just launch Subsurface with the --survey optio

3. Start Using the Program

The Subsurface window is usually divided into four panels with a Main -Menu (File Edit Import Log View Share Help) at the top of the window (for Windows +Menu (File Edit Import Log View Help) at the top of the window (for Windows and Linux) or the top of the screen (for Mac and Ubuntu Unity). The four panels are:

  1. @@ -633,7 +633,7 @@ of the Info panel (maximum, minimum and average depths, duratio temperatures and SAC; total time and number of dives selected).

-The Main Window +The Main Window

Decide which of the four panels are displayed by selecting the @@ -728,21 +728,24 @@ in the figure below. Each of these tabs will now be explained for data entry.

-

When you edit a field in Notes or Equipment panels, Subsurface enters Editing Mode, -indicated by the message in the blue box at the top of the Notes panel (see the image below). This message is -displayed in all the panels under Notes and Equipment when in Editing Mode.

+

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

Blue edit bar
-

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

+

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

+

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

+

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

5.1.1. Creating a Dive Profile

The Dive Profile (a graphical representation of the depth of the dive as a @@ -859,13 +862,13 @@ The dive computer should be placed into PC Communication mode.

In Subsurface, from the Main Menu, select Import → Import From Dive Computer. - Dialogue A in the figure below appears: + dialog A in the figure below appears:

-FIGURE: Download dialogue 1 +FIGURE: Download dialog 1

Dive computers tend to keep a certain number of dives in memory, even @@ -877,7 +880,7 @@ of the dive computer (at least for those not charging while connected via USB).<

  • -The dialogue has two drop-down lists, Vendor and Dive Computer. On the +The dialog has two drop-down lists, Vendor and Dive Computer. On the vendor drop-down list select the make of the computer, e.g. Suunto, Oceanic, Uwatec, Mares. On the Dive Computer drop-down list, the model name of @@ -952,17 +955,17 @@ Then select the Download button. With communication established, you can see how the data are retrieved from the dive computer. Depending on the make of the dive computer and/or number of recorded dives, this - could take some time. Be patient. The Download dialogue + could take some time. Be patient. The Download dialog shows a - progress bar at the bottom of the dialogue. Remember for some dive computers + progress bar at the bottom of the dialog. Remember for some dive computers progress information could be inaccurate since Subsurface doesn’t know how much downloadable data there are until the download is complete. After the dives have been downloaded, they appear in a tabular format on the right-hand - side of the dialogue (see image B, above). Each dive comprises a row in the table, showing the date, duration + side of the dialog (see image B, above). Each dive comprises a row in the table, showing the date, duration and depth. Next to each dive is a checkbox: check all the dives that need to be transferred to the Dive List. In the case of the image above, the last six dives are checked and will be transferred to the Dive List. Then - click the OK button at the bottom of the dialogue. All the imported dives appear + click the OK button at the bottom of the dialog. 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. @@ -1024,11 +1027,11 @@ On Unix-like operating systems, does the user have write permission to the

If the Subsurface computer does not recognize the USB adapter 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 +possibility the cable or USB adapter is faulty. A faulty cable is the most 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:

+two boxes checked in the download dialog discussed above:

Save libdivecomputer logfile
@@ -1090,9 +1093,9 @@ Ensure Subsurface is paired with the Bluetooth-enabled dive computer.
-

Select the Download dialogue by selecting +

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

+box labelled "Choose Bluetooth download mode", the dialog below appears.

On Linux or MacOS:
@@ -1118,10 +1121,10 @@ Bluetooth device. Ensure the Bluetooth driver is installed correctly on the 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 +Select the Scan button towards the bottom left of the dialog above. After searching, the dive computer should be listed (perhaps as one of a number of Bluetooth devices) in the main list box on the -lefthand side of the dialogue (see image above). If this does not work, select +lefthand side of the dialog (see image above). If this does not work, select the Clear button, then scan again for Bluetooth devices using the Scan button. After taking these actions Subsurface should see the dive computer. On the left hand side, if the @@ -1164,10 +1167,10 @@ Request PIN code [agent] Enter PIN code: 0000
-

After the devices are paired, press the Save button of the dialogue. -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.

+

After the devices are paired, press the Save button of the dialog. +This closes the Bluetooth dialog. Now select Download in the Download from +dive computer dialog which should still be open. The downloaded dives are +shown on the righthand side of the download dialog.

On Windows:
@@ -1189,7 +1192,7 @@ the download process. If the devices have never been paired the system will ask permission and put a message on the right side of the screen: Add a device, Tap to set up your DC device. Always allow this pairing. After a discovered item is selected, select the Save button. -Finally select the Download button on the Download dialogue and wait for the process to complete.

+Finally select the Download button on the Download dialog and wait for the process to complete.

@@ -1204,13 +1207,26 @@ will not work. However, Bluetooth hardware/dongles from these manufacturers

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

+ +
Important The Subsurface support for BLTE dive computers on Windows is EXPERIMENTAL and only +supported on Windows 10. +Please make sure that you have the latest version of Windows 10. +Version 1803 is a minimum +requirement. Also make sure that you have installed the latest drivers for your +motherboard and/or BTLE dongle.
+
+
+ + -

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 given. If a name has been found, it is +based on the coordinates that were given. If a name is found, it is automatically inserted into the tags box. The list box (Titled Dive sites on same coordinates") at the bottom of the dive site panel contains the names of other dives sites used at the @@ -1428,9 +1461,10 @@ cave, etc. the tags that correspond to the typing. For instance, by typing cav, the tags cave and cavern are shown to choose from.

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

-

The Apply changes and Discard changes buttons are used to save all the information for tabs -in the Info panel and in the Dive Profile panel. Use them -when ALL other information has been added. The image at the beginning of this section +

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

+

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

@@ -1447,11 +1481,11 @@ message in the blue box at the top of the panel:

Subsurface and the information on cylinders and gases (entered here) determines the behavior of the Dive profile (top right-hand panel).

-

Cylinders: The cylinder information is entered through a dialogue that looks +

Cylinders: The cylinder information is entered through a dialog that looks like this:

-FIGURE: Initial cylinder dialogue +FIGURE: Initial cylinder dialog

For hand-entered dives, this information needs to be typed in. For dive computers, @@ -1474,7 +1508,7 @@ cylinders:

for this dive, or just start typing in the box which shows the available options for the entered characters. The Size of the cylinder as well as its working pressure (Work.press) will -automatically be shown in the dialogue.

+automatically be shown in the dialog.

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

@@ -1494,12 +1528,12 @@ 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 -the + button on the top right of the weights dialogue, the table looks like +using a dialog similar to that of the cylinder information. If you click +the + button on the top right of the weights dialog, the table looks like this:

-FIGURE:The Weights dialogue +FIGURE:The Weights dialog

By clicking on the Type field, a drop-down list becomes accessible through a @@ -1645,18 +1679,19 @@ beginning time of the dives to be significantly different) Subsurface will not create duplicate entries. Below is more specific information to import data to Subsurface.

-

5.3.1. Using the universal import dialogue

+

5.3.1. Using the universal import dialog

Importing dives from other software is done through a universal interface activated by selecting Import from the Main Menu, then clicking on -Import Log Files. This brings up dialogue A, below.

+Import Log Files to bring up dialog A, below. The exact appearance +of this dialog differs between operating systems.

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

Towards the bottom right is a dropdown selector with a default label of Dive Log Files which accesses different types of direct imports -available, as in dialogue B, above. Currently these are:

+available, as in dialog B, above. Currently these are:

  • @@ -1739,17 +1774,30 @@ CSV (text-based and spreadsheet-based) dive logs, including APD CCR logs

-

Selecting the appropriate format and then the specific log file in the large window -containing the file list on the right of the dialogue, opens -the imported dive log in the Subsurface Dive List. Some other formats not -accessible through the Import dialogue are also supported, as explained below.

+

Selecting the appropriate format from the dropdown list and then the specific log file in the main window +containing the file list. Then select the Open button near the bottom right.

+

If the dive log being imported is in CSV format, the user is given the +opportunity to perform manual edits to the column headers before it is imported +to Subsurface (see image below).

+
+
+FIGURE: Import dialog: step 2 +
+
+

For more information on configuring a CSV import, see +Importing data in CSV format. +In many cases changes to the column headers are not required because +they are pre-configured for the specific type of import and +the CSV import screen can be bypassed by selecting the OK button. +This opens the imported dive log in the Subsurface Dive List.

+

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

5.3.2. Importing from OSTCTools

OSTC Tools is a Microsoft-based suite of dive download and dive management tools for the OSTC family of dive computers. OSTC Tools downloads dive data from the dive computer and stores it as a binary file with file extension .dive . Subsurface can directly import these files when using -the universal import dialogue. From the dropdown list at the bottom right select +the universal import dialog. From the dropdown list at the bottom right select OSTCTools Files (.dive .DIVE). This makes the OSTC Tools dive logs visible in the file list panel. Select one or more dive, then click the Open button. The OSTC dives are shown in the Dive List panel.

@@ -1799,7 +1847,7 @@ Finally, import the dives

5.3.4. Importing Scubapro SmartTrak divelogs

SmartTrak stores the raw data from a Uwatec/Scubapro dive computer along with a plethora of other data manually added by the user, ranging from dive points to buddies data or DAN survey -info. However, this is Microsoft Windows-based propietary software by Uwatec (today Scubapro) +info. However, this is Microsoft Windows-based proprietary software by Uwatec (today Scubapro) using Microsoft Access databases, preventing the integration the importer into the Subsurface core application.

A stand alone tool for Linux has been developed to import the .slg files @@ -1809,7 +1857,7 @@ as a Windows installer or a Linux AppImage. The application is not currently supported on Mac.

It can also be built for Linux systems. Two dependencies need to be met in your system before building: glib2.0 and mdbtools (see below).

-

In addition, a web service is available for divelog convertions from SmartTrak to Subsurface (see below).

+

In addition, a web service is available for divelog conversions from SmartTrak to Subsurface (see below).

Feel free to contact the Subsurface development team on our mailing list for assistance in importing SmartTrak dive logs.

@@ -1838,7 +1886,7 @@ You can run it from this directory, copy it to another one, e.g. ~/bin

  • -The script has some options mostly useful for development pourposes. If you +The script has some options mostly useful for development purposes. If you think you may need them, please read comments on script header itself.

    • @@ -1916,13 +1964,13 @@ the dives for instructions on this topic.

    5.3.5. Importing dives from divelogs.de

    Importing dive information from divelogs.de is simple, using a single -dialogue box. The Import → Import from Divelogs.de option should be selected +dialog box. The Import → Import from Divelogs.de option should be selected from the Main Menu. This -brings up a dialogue box (see image A below). Enter a +brings up a dialog box (see image A below). Enter a user-ID and password for divelogs.de and then select the Download button. Download from divelogs.de starts immediately, -displaying a progress bar in the dialogue box. At the end of the download, the +displaying a progress bar in the dialog box. At the end of the download, the success status is shown (see image B, below). The Apply button should then be selected, after which the imported dives appear in the Subsurface Dive List panel.

    @@ -2007,7 +2055,7 @@ directory. Select the file that needs to be imported. A configuration panel appears as depicted below:

    -FIGURE: CSV download dialogue 1 +FIGURE: CSV download dialog 1

    At the top left, there is a dropdown list containing pre- configured @@ -2032,12 +2080,12 @@ cell immediately above the white cell containing " # ", depicted in the image below.

    -FIGURE: CSV download dialogue 2 +FIGURE: CSV download dialog 2

    Continue in this way to ensure all the column headings in the blue row of -cells correspond to the headings listed in the top part of the dialogue. -When finished, select the OK button on the bottom right of the dialogue. +cells correspond to the headings listed in the top part of the dialog. +When finished, select the OK button on the bottom right of the dialog. The data from the CSV file are imported and shown in the Dive List panel.

    @@ -2130,20 +2178,116 @@ a smaller file to make sure everything works.
    -

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

    +

    5.4. Manipulating Dive Site Information

    +

    The dive site information of all dives is managed as a separate entity independent of the dive information. +Selecting the rightmost tab of the Notes panel, +labelled "Dive sites" brings up the dive sites management panel (image below). +Linking a dive to a dive site is performed from within the Notes tab showing the information for +that dive (see the section on Locations). On the other hand the dive sites management panel allows +dive-independent data to be managed. A new dive site can be created either while editing a dive (within the Notes tab, +see Locations) or it could be created within the dive sites management panel (image below).

    +
    +
    +FIGURE: Dive sites tab +
    +
    +

    If a description for a dive site has previously been entered, this is shown in the panel +as well as the number of dives at each site. The list of sites can be ordered by clicking +on any of the three headings. A dustbin and an edit icon are on the left of each dive site name. +The following actions are possible for managing the collection of dive sites:

    +
    +

    5.4.1. Filter the list of dive sites

    +

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

    +
    +
    +

    5.4.2. Edit a dive site

    +

    The information for each dive site can be edited either from from within the Notes tab or +within the Dive sites tab. In order to edit the dive site information, select the +Edit icon to the left of the dive site name (see image above). Editing dive site information +from within the Notes tab is discussed in the section on Locations where +each of the fields in the dive site edit panel is explained.

    +
    +
    +FIGURE: Dive site edit +
    +
    +

    Add any desirable information to the tab. Editing of coordinates is explained in the +section dealing with Locations. Having finished editing the dive site information, +select the Done button at the top. This returns you to the dive sites management panel.

    +
    +
    +

    5.4.3. Merge dive sites

    +

    Merging two or more dives is achieved in the dive site edit panel (see image above). We assume that the dive +sites that need merging are not far apart. Merging is performed by selecting a dive site and then merging +other dives with this selected dive site. In the edit panel, above, select the text box labelled "Show dive sites +in the range of:" and provide a critical distance that would include the site that needs to be merged with the present site. +A list of sites within this range is presented (see image below).

    +
    +
    +FIGURE: Dive sites merge +
    +
    +

    Select the dive site to be merged by right-clicking it. A confirmation +message is presented (see image above). Clicking the confirmation message merges the selected dive with +the dive named at the top of the panel and returns you to the dive sites management panel.

    +
    +
    +

    5.4.4. Add a dive site

    +

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

    +
    +
    +FIGURE: Add dive site +
    +
    +
    +
    +

    5.4.5. Delete a dive site

    +

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

    +
    +
    +FIGURE: Delete a dive site +
    +
    +
    +
    +

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

    +

    Since the dive sites list is managed separately from the dive list, it is possible to add dive sites to the list +even though these sites have not been used for any dives. In this case the column labelled "# of dives" shows a zero. +This makes it possible for divers to share dive sites and sites can be created before any of them are dived. Alternatively +a site can be created with a useful description such as "Ann dived this site last summer and she saw huge numbers of +bumphead parrotfish. She said Jan - Apr is the best time. I hope to dive there myself". In this way the dive sites +list becomes a repository of useful information outside of the dive list.

    +
    +
    +

    5.4.7. Delete unused dive sites

    +

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

    +
    +
    +
    +

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

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

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

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

    -

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

    +

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

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

    -

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

    +

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

    Install Subsurface-mobile

    Find Subsurface-mobile on Google Play and install it on an Android device. The app @@ -2226,7 +2370,7 @@ synchronising this information.

    -

    5.5. Adding photographs or videos to dives

    +

    5.6. Adding photographs or videos to dives

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

    -

    5.5.1. Loading media and synchronizing between dive computer and camera

    +

    5.6.1. Loading media and synchronizing between dive computer and camera

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

    -

    5.5.2. Viewing the media

    +

    5.6.2. Viewing the media

    Ensuring that thumbnails are created for video files

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

    -

    5.5.3. The Media tab

    +

    5.6.3. The Media tab

    Media associated with a dive are shown as thumbnails in the Media tab of the Notes Panel. Media taken in rapid succession during a dive (therefore sometimes with large overlap on the dive profile) can easily be accessed in the Media tab. This tab serves as @@ -2407,9 +2551,20 @@ the Media panel to select a photo/video. Double-click a thumbnail to vi or play the video, overlaying the Subsurface window. Delete media from the Media panel by selecting it (single-click) and then by pressing the Del key on the keyboard. This removes it BOTH from the Media tab as well as the dive profile.

    +

    By right-clicking on a video and selecting the "Save dive data as subtitles" option, a subtitles +file with the same name as the video but with an ".ass" extension is created that contains +time dependent dive data (runtime, depth, temperature, NDL, TTS, surface GF) to be overlayed +with the video. The VLC video player automatically finds this file upon playing the video +and overlays the dive data. Alternatively, the ffmpeg video encoder can be used to create a +new video file with the dive data encoded in the video stream. To do so run

    +
    +
    +
    ffmpeg -v video.mp4 -vf "ass=video.ass" video_with_data.mp4
    +
    +

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

    -

    5.5.4. Media on an external hard disk

    +

    5.6.4. Media on an external hard disk

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

    -

    5.5.5. Finding out which dives have associated media.

    +

    5.6.5. Finding out which dives have associated media.

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

    -

    5.5.6. Moving media among directories, hard disks or computers

    +

    5.6.6. Moving media among directories, hard disks or computers

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

    -

    5.6. Logging special types of dives

    +

    5.7. Logging special types of dives

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

    -

    5.6.1. Multicylinder dives

    +

    5.7.1. Multicylinder dives

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

    -

    5.6.2. Sidemount dives

    +

    5.7.2. Sidemount dives

    Sidemount diving is just another form of multi-cylinder diving, often with both or all cylinders having the same gas mixture. Although it’s a popular configuration for cave divers, sidemount diving can be done by recreational divers who have completed the appropriate training. See the comments in the @@ -2555,7 +2710,7 @@ logging of cylinder pressures during sidemount involves three steps, exactly as

    -

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

    +

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

    +Important + IN CASE OF PROBLEMS: If the Bluetooth adapter from the Subsurface computer gets stuck and the Download process fails repeatedly, unpair the devices and then repeat the above steps. If this is not successful, @@ -1262,13 +1278,10 @@ the Notes and the Equipment tabs on the top le

    To have a more complete dive record, the user needs to add additional information by hand. The procedure below is virtually identical for hand-entered dives and for dives downloaded from a dive computer.

    -

    In some cases, -you must provide the date and time of the dive, for example when entering a dive by hand or when a -dive computer doesn’t provide the date and time of the dive. -(Usually the date and time of the dive, gas mixture and water temperature are -shown as obtained from the dive computer) -If the contents of the Notes tab is changed or edited in any way, the message in a blue box at -the top of the panel shows the dive is being edited. If you +

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

    @@ -1277,12 +1290,32 @@ visible (left hand image, below):

    The right hand image, above, shows a Notes tab filled with dive information. -The Date and Time fields reflects the date and time of the dive. By clicking +The Date and Time fields reflect the date and time of the dive. By clicking 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.

    +

    How to UNDO information that has been typed. While editing a dive log you frequently +replace or modify existing information. Sometimes this is unintended. Let’s say, for the moment, +the time of your dive computer was set incorrectly and the dive time in the +Notes tab is therefore incorrect. You wish to correct the time indicated in the Notes tab +to reflect the true dive time. The example in the images below reflect a small part +of the Notes tab where the dive time was changed from +8:44 (image a) to 7:44 (image b). Now, for some reason, you wish to return +to the initial time (08:44). Click on the Edit heading in the main menu and +an option appears to undo the change in time (image c). Select this undo option +and the time is again shown as 8:44. This can also be achieved by typing Ctrl-Z (or CMD-Z on a Mac). +Having undone the change, a new option appears under +the Edit heading: Redo the change (image d). If this option is selected, the change in +time is redone. The undo facility applies to the majority of information typed into the text +areas of Subsurface and facilitates easy and accurate data entry. Multiple changes +to a specific dive and changes to multiple dives can be undone.

    +
    +
    +FIGURE:Performing an undo +
    +

    Air/water temperatures: Air and water temperatures during the dive are shown in text boxes to the right of the Start time. Many dive computers supply water temperature information and this box may have information. @@ -1298,7 +1331,7 @@ be used).

    		 Warning Dive locations are managed as a separate part of the dive log. +Dive locations are managed as a separate part of the dive log (See the section entitled Manipulating Dive Site Information). The dive information in the Notes and Equipment tabs can therefore NOT be edited at the same time as the dive site information. Save all the other dive information (e.g. divemaster, buddy, protective gear, notes about the dive) by selecting Apply changes on the @@ -1311,14 +1344,14 @@ If several dives are made at the same location, the site information for the first dive is re-used. Therefore, if a dive site has been used before, the name of that site (and sometimes the names of similar sites) appears below the dive site text box (image below). Double-click on -the appropriate dive site name and the dive location will be associated with the -dive being entered. Then select Apply Changes (image below) to save the geolocation for this dive site.

    +the appropriate dive site name with associated coordinates and that site will be associated with the +dive being entered.

    FIGURE:Location choice panel
    -

    Entering a new dive location: On the other hand, having dived at a new dive location, +

    Entering a new dive location: On the other hand, having dived at a new dive site, a new record needs to be created that could be used for the new and for later dives at this new site. Type the name of the new dive site into the text box (image A below).

    @@ -1363,7 +1396,7 @@ by dragging it on the map, zooming in on the appropriate part of the map and pla the marker at an appropriate position (image B below). The coordinates of the dive location are automatically inserted into the appropriate text box in the dive location information window (image A below). Enter any other contextual information about the dive site (Description and Notes), -then select Apply Changes to save the geolocation for this dive site. +then select Done to save the geolocation for this dive site. The dive site information can later be edited by clicking the globe icon to the right of the dive site name in the Notes tab.

    @@ -1391,7 +1424,7 @@ same).
    -
    -

    5.6.4. Closed circuit rebreather (CCR) dives

    +

    5.7.4. Closed circuit rebreather (CCR) dives

    @@ -2616,7 +2771,7 @@ indicates the "pO2 drop over the mouthpiece". Much of pSCR diving inv Note pSCR and bailout: Gases used in pSCR often yield very low pO2 values in shallow water. For this reason the diver +pSCR and bailout: Gases used in pSCR often yield very low pO2 values in shallow water. For this reason one often completes the shallow sections of a dive using open circuit (OC) rather than the rebreather. In this case parts of the dive are performed OC, while the rest of the dive is performed on the pSCR loop. To indicate such changes in divemode, @@ -2637,7 +2792,7 @@ differs from the OC-pO2 (orange line).
    @@ -2669,15 +2824,15 @@ provided when purchasing CCR dive equipment. See the section dealing with and 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 +log files to bring up the universal import dialog. As explained in that section, the bottom right -hand of the import dialogue contains a dropdown list (labeled Filter:) of appropriate devices +hand of the import dialog contains a dropdown list (labelled Filter:) of appropriate devices 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 it is a file with a .txt extension). After selecting the appropriate dive log, -click the Open button at the bottom right hand of the universal import dialogue. +click the Open button at the bottom right hand of the universal import dialog. The selected dive is imported to the Subsurface dive list.

    @@ -2829,7 +2984,7 @@ Poseidon and APD equipment can be found in

    6.1. Using the Dive Map to obtain more dive information

    -

    The Dive Map has a number of buttons useful for manipulation several aspects of a dive. These are:

    +

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

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

    6.2. The Info tab (for individual dives)

    -

    The Info tab gives some summary information about a particular dive that +

    6.2. The Information tab (for individual dives)

    +

    The Information tab gives some summary information about a particular dive that has been selected in the Dive List. Useful information here includes the surface interval before the dive, the maximum and mean depths of the dive, the gas volume consumed, the surface air consumption (SAC) and the number of oxygen toxicity units (OTU) incurred.

    +
    + + + +
    +Note +The text box Atm. pressure allows one to specify +the altitude or the atmospheric pressure of the dive site while diving. If this text box +contains a value, dive calculations take into account altitude. The dropbox on the +right allows two ways of expressing atmospheric pressure: mbar or m/ft above sea level. +The altitude unit (metric/imperial) is taken from the settings in the Preferences screen. A +third option is to use the atmospheric pressure provided by the dive computer. In order to specify +the pressure/altitude, first select the appropriate unit (in the case of the image on the left +these are "mbar/m/use dc", then type an appropriate value into the text box. In the case +of m/ft the altitude typed into the text box is automatically converted to the +mean expected atmospheric pressure (mbar) at the specified altitude. +In the case of "use dc", no value is required in the text box. Atmospheric pressure provided by a dive +computer does not need any editing.
    +
    @@ -3031,7 +3205,9 @@ 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, also as gas density in g/l), decompression requirements at that -instant in time (Deco), time to surface (TTS), the calculated ceiling, as well +instant in time (Deco), the surface GF (a measure of inert gas loading of the diver’s body defined as the excess +over the surface pressure normalized such that the maximally allowed over pressure at the surface, the +M-value, corresponds to 100%), the 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:

    @@ -3065,6 +3241,17 @@ TTS longer than 2 hours is not accurately calculated and Subsurface only indicat
    + +
    +Note +Show Deco information. When enabled, the information box shows the surface GF and the momentary +ceilings for the individual tissue compartments. The surface GF is an indication of to what degree +the partial pressure of nitrogen in the blood exceeds the partial pressure required for safely +reaching the surface. Surface GF > 100% means that it is unsafe to surface.
    +
    +
    + + - @@ -5799,17 +5994,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives.
    -

    16.6. Share on

    -
      -
    • -

      -Facebook - Share the currently selected dive on your Facebook timeline. -

      -
      • -
    -
    -
    -

    16.7. Help

    +

    16.6. Help

    • @@ -6302,18 +6487,18 @@ stored on the dive computer.

    +from the console as follows:
    Note Show the Surface Air Consumption (SAC), an indication of the surface-normalized respiration @@ -3336,7 +3523,7 @@ and amount of data available (and other factors taken into consideration at the of the calculation) it’s unlikely that ceilings from dive computers and from Subsurface are the same, even if the same algorithm and gradient factors (see below) are used. It’s also quite common that Subsurface calculates a ceiling for -non-decompression dives when the dive computer stayed in non-deco mode during +non-decompression dives when the dive computer stayed in no-deco mode during the whole dive (represented by the dark green section in the profile at the beginning of this section). This is because Subsurface’s calculations describe the deco obligation at each moment during a dive, @@ -3345,6 +3532,12 @@ ascent some excess nitrogen (and possibly helium) are already breathed off so even though the diver technically encountered a ceiling at depth, the dive still does not require a specific deco stop. This feature lets dive computers offer longer non-stop bottom times.

    +

    Strictly speaking, the green calculated ceiling is a direct representation of +the inert gas loadings of the simulated tissues only and is independent of +any assumed ascent velocities. It indicates the deco model’s minimal allowed +depth at this instant of time given the inert gas loadings and is not a statement +about a possible ascent schedule in the remaining dive. To obtain the latter, +use the "Edit dive in planner" option from the Log menu.

    @@ -5359,8 +5550,9 @@ pO2 values are shown in the pO2 graphs. The volumes of gas FIGURE: Planning a pSCR dive: setup -

    In the case of a pSCR dive plan for open water, the worst-case scenario is probably bailout at the end of the deepest part of the dive. -Create a 1-minute segment at the end of the deepest part of the dive plan. This +

    In the case of a pSCR dive plan for open water, the worst-case scenario is probably bailout at the end of the deepest part of the dive +and this could be achieved using the Bailout checkbox of the planner. +Alternatively create a 1-minute segment at the end of the deepest part of the dive plan. This last segment (represented by the bottom row of the Dive planner points table) is then manipulated using the Dive mode and Used gas columns, as in the cave example, above. See the example of bailout for a CCR dive, below, that uses this approach.

    @@ -5397,8 +5589,11 @@ so gas consumptions of 0 liters are the norm.

    Note +surface, taking into account decompression. This is done by 1) checking the Bailout checkbox of the dive planner +(bailout will be calculated starting at the last segment of the dive specified in the Dive planner points table); +2) defining a 1-minute segment at the end of the bottom part +of the dive, as in the image on the left where a CCR dive to 40m for 21 minutes is planned; +3) changing to an OC-gas during any segment in the Dive planner points table.
    @@ -3470,7 +3663,7 @@ The central range in B includes the colors from black to light

  • -The top range in B (marked Off-gassing) includes colors from light green to red and white, repesenting tissue gas +The top range in B (marked Off-gassing) includes colors from light green to red and white, representing tissue gas pressures above that of the total ambient pressure (top of light green area of A). The measurement unit is the % of inert gas pressure above ambient pressure, relative to the Bühlmann M-value gradient (bottom of red area in A). These tissue pressures are normally reached while ascending to a shallower depth. @@ -3502,7 +3695,7 @@ not relative to any specific gradient factor. For more information external to t 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.

    +Both profiles have the same total decompression time, but the VPM-B model requires deeper stops early in the ascent 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, @@ -3541,6 +3734,70 @@ 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.

    +
    +

    6.6. Filtering the dive list

    +

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

    +

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

    +
    +
    +Figure: Filter Window Bar +
    +
    +

    When opened, the filter contains default values that include all the dives in the Dive list. Filter the +Dive list by either changing some of the default values in the panel, or by typing specific +values or words in any of the text boxes. For instance, in the image below the open circuit dives using +a drysuit at a specific location (Simonstad) are shown in the Dive list. There is no button to +activate the filter action: the action of typing text into a textbox or specifying a range +in any of the fields automatically performs the filtering.

    +

    During filtering the Dive Mode (Open circuit, CCR, pSCR, Freedive) is added to the tag list of a dive, allowing +only specific types of dive (e.g. CCR) to be selected in the tag attribute of the filter. This is +useful for rebreather divers and free divers who also do some open circuit diving.

    +
    +
    +Figure: Filter panel +
    +
    +

    The filter criteria can be any of the following:

    +

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

    +

    2) Within a single attribute the "All of" criterion implements an AND operator. For the People attribute in + the image below, the filtered dive list contains the dives for which BOTH Bob Smith AND Stefan Schultz + were listed as dive buddies/divemaster based on the People information in the Info Panel.

    +

    3) The "Any of" criterion implements an OR operator. For the Location attribute in the image below, + the filtered dive list contains dives performed EITHER at Simonstad OR at Hout Bay.

    +

    4) The "None of" criterion implements a NOT function. For the Suit attribute in the image below, + the dive list EXCLUDES all the dives during which a drysuit was used.

    +

    5) Empty field. For the Tags and Notes attributes in the image below, an empty text box results + in these attributes being not being considered during filtering.

    +
    +
    +Figure: Filter options +
    +
    +

    At the top of the Filter Panel the yellow up-arrow is used for resetting the filter to show all dives, +and a red button with white cross closes the filter panel.

    +
    + + + +
    +Important +The filter action can only be stopped by using the Reset Filter button (yellow up-arrow) or +by manually clearing all the filter text boxes. Closing the Filter Panel does not terminate +filtering: the filtered dive list remains unchanged. This is obvious from the top bar of the Subsurface +window indicating that only some of all the dives are shown. Closing the Filter Panel activates the Map Panel, +allowing viewing the map locations of the filtered dive list. For instance one might wish to filter on +Bob Smith as a buddy. Closing the Filter Panel allows viewing the map locations where Bob Smith was a buddy. +To re-open the Filter Panel in this case, select Log → Filter divelist from the Main Menu.
    +
    +
    @@ -3753,99 +4010,12 @@ To do this after performing any of these actions, from the Main MenuEdit. This brings up the possibility to Undo or Redo an action.

    -
    -

    7.5. Filtering the dive list

    -

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

    -

    To open the filter, select Log → Filter divelist from the main menu. This opens the -Filter Panel at the top of the Subsurface window. Three icons are located at the top -right hand of the filter panel (see image below). The Filter Panel can be reset -(i.e. all current filters cleared) by selecting the yellow angled arrow. The Filter Panel may also be -minimized by selecting the green up-arrow. When minimized, only these three icons are shown. -The panel can be maximized by clicking the same icon that minimized it. The filter may also be -reset and closed by selecting the red button with the white cross.

    -
    -
    -Figure: Filter panel -
    -
    -

    Four filter criteria may be used to filter the dive list: dive tags, person (buddy / divemaster), dive site -and dive suit. Each of these is represented by a check list with check boxes. Above -each check list is a second-level filter tool, allowing the listing of only some -attributes within that check list. For instance, typing "ca" in the filter -text box above the tags check list, results in the list being reduced -to "cave" and "cavern". Filtering the check list helps to rapidly find -search terms for filtering the dive list.

    -

    To activate filtering of the dive list, check at least one check box in one of -the four check lists. The dive list is then shortened to include -only the dives that pertain to the criteria specified in the check lists. -The four check lists work as a filter with AND operators. Subsurface -filters therefore for cave as a tag AND Joe Smith as a buddy. But the -filters within a category are inclusive - filtering for cave and boat -shows those dives that have either one OR both of these tags.

    -

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

    -

    There are two ways to export dive information from Subsurface:

    -
    -
    -

    8.1. Exporting dive information to Facebook

    -

    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. -From the Main Menu, select Share on → Connect to → Facebook (image A below) -A Facebook login screen appears (image B below). Provide a Facebook userID and password. -From the Subsurface window it’s easy to determine whether Subsurface has a valid connection to Facebook: -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).

    -

    Once logged into to Facebook , a panel is shown with a message: -"To disconnect Subsurface from your Facebook account, use the Share on menu entry." -Close this message panel.

    -
    -
    -Figure: Facebook login -
    -
    -

    Having established a login to Facebook, transferring a dive profile to a Facebook timeline is easy. -In the Subsurface Dive List panel, highlight the dive to be transferred. -Then, from the Main Menu, select Share on → Facebook. A dialogue box -is shown, determining the amount of additional information to be transferred -with the dive profile (image A, below). To transfer a dive profile to Facebook, the name of a -Facebook album is needed. The checkboxes on the left hand side determine how much -additional information is added to the dive profile, shown in the text box -on the right hand side of the panel (image A, below). Customise the message that will be posted -with the dive profile by editing any of the information. After specifying additional information -and verifying the text, select the OK button that triggers the transfer to Facebook. After the transfer -is done, an acknowledgement dialogue appears, indicating it was successful.

    -

    Both the album created and the post to your timeline are marked as -private. In order for friends to be able to see the post, -log into Facebook using a browser or Facebook app and change its permissions.

    -
    -
    -Figure: Facebook data submission -
    -
    -

    If required, then close the Facebook connection by selecting, from the Main Menu, -Share on → Disconnect from → Facebook (image B above).

    -
    -
    -

    8.2. Export dive information to other destinations or formats

    -

    For non-Facebook exports, the export function can be found by selecting File → Export, which brings up +

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

    @@ -3898,6 +4068,18 @@ Universal Dive Data Format (UDDF). Refer to http://uddf.org fo

  • +Dive profile, which enables easy sharing of the dive profile using social media. + This option writes the image of the dive profile(s) in a .png graphics + format to the folder specified in the File save dialog. The saved image + looks exactly like the on-screen profile, so ensure that all the appropriate + profile toolbar options are activated. If several dives are + selected, the images are written as separate graphics files. Selecting the + Dive profile option opens a window to name the file(s) to which the profile(s) + is written. Provide a filename and select Save to create the graphics output. +

    +
    • +
  • +

    HTML format, in which the dive(s) are stored in HTML files, readable with an Internet browser. Most modern web browsers are supported, but JavaScript must be enabled. The HTML export cannot be changed or edited. @@ -3947,6 +4129,12 @@ Universal Dive Data Format (UDDF). Refer to http://uddf.org fo

    • +LaTeX. Write the dive(s) to a LaTeX document of which the typesetting is done automatically + using TeX. LaTeX handles page content and layout while TeX handles typesetting. +

      +
      • +
    • +

      Image depths, which creates a text file that contains the file names of all photos or videos attached to any of the selected dives in the Dive List, together with the depth underwater where @@ -3998,7 +4186,6 @@ Under Style Options some style-related options are available like font instance www.divelogs.de.

    -

    9. Keeping a Subsurface dive log in the Cloud

    @@ -4182,11 +4369,11 @@ If the dive profiles are printed, what gas partial pressure information should b

    • -

    If File → Print is selected from the Main menu, the dialogue below (image A) appears. Three +

    If File → Print is selected from the Main menu, the dialog below (image A) appears. Three specifications are needed to get the desired information and page layout:

    -FIGURE: Print dialogue +FIGURE: Print dialog
      @@ -4215,7 +4402,7 @@ Under Print options select:

    1. Printing only the dives selected from the dive list before - activating the print dialogue by checking the box Print only selected dives. If this + activating the print dialog by checking the box Print only selected dives. If this check box is not checked ALL dives in the Dive List panel are printed.

      @@ -4285,10 +4472,10 @@ Under Template select a template to be used as the page layout. There a

    You can Preview the printed page by selecting the Preview button on the -dialogue (see image A at the start of this section). After preview, you can change -the options in the print dialogue, so the layout fits personal taste.

    +dialog (see image A at the start of this section). After preview, you can change +the options in the print dialog, so the layout fits personal taste.

    Next, select the Print button (see image A at the start of this section). This activates the regular print -dialogue used by the operating system, +dialog used by the operating system, letting you choose a printer and set its properties (see image below):

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

    11.1. Writing a custom print template (advanced)

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

    @@ -4321,7 +4508,7 @@ Cobra, Gekko and Zoop) family of dive computers are supported. A large number of can be read and changed to different values. To begin, be sure the appropriate hardware driver is installed for the dive computer (also required for downloading dives) and the device name of the dive computer is known. See APPENDIX A for information on how to do this.

    -

    Once the dive computer is connected to the Subsurface computer, select File → Configure dive +

    Once the dive computer is connected to the Subsurface computer, select File → Change settings on dive 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 @@ -4599,7 +4786,7 @@ CCR Options: These options determine oxygen management for CCR dives:

  • -Bühlmann: Set the gradient factors (GFLow and GFHigh) for calculcating the deco ceiling following +Bühlmann: Set the gradient factors (GFLow and GFHigh) for calculating the deco ceiling following the ZH-L16 algorithm. GF_Low is the gradient factor at depth and GF_High is used at the surface. At intermediate depths gradient factors between GF_Low and GF_High are used. Gradient factors add conservatism to nitrogen and helium exposure during a dive, in a @@ -4675,7 +4862,7 @@ services such as Cloud storage, or when you want to communicate through a proxy. FIGURE: Preferences Network page

    • -

    This dialogue has three sections:

    +

    This dialog has three sections:

    • @@ -4806,7 +4993,7 @@ any warning messages about the dive plan are printed.

    • -Towards the center bottom of the planner (circled in blue in the image above) is a dropbox with three options. Select the appropriate one of these: +Towards the center bottom of the planner (circled in blue in the image above) is a dropdown list with three options. Select the appropriate one of these:

      • @@ -4847,8 +5034,8 @@ In the table labelled Available Gases, add the information of the cylin double clicking the cylinder type and using the dropdown list, then specify the start pressure of this cylinder. By leaving the oxygen concentration (O2%) field empty, the cylinder is assumed to contain air. Otherwise enter the oxygen and/or helium - concentration in the boxes provided in this dialogue. Add additional cylinders by using the - "+" icon to the top right-hand of the dialogue. + concentration in the boxes provided in this dialog. Add additional cylinders by using the + "+" icon to the top right-hand of the dialog.

      • @@ -4997,7 +5184,7 @@ To build additional safety into the dive plan (over and above those of recreatio duration of the dive. This is the price of a larger safety margin. Reasons for using gradient factors less than 100 may be the age of the diver, the health of a diver, or unusual conditions such as cold water or strong currents. Realistic conservative values for the gradient factors are GFLow=40% and GFHigh=80%. This allows you to - create a cusom dive plan, suited to yourself as well as the dive conditions. + create a custom dive plan, suited to yourself as well as the dive conditions.

      @@ -5132,7 +5319,7 @@ Add new waypoints until the main features of the dive have been completed, e.g. bottom time segment and deep stops (if these are implemented). In most cases Subsurface computes additional way points in order to fulfill decompression requirements for that dive. A waypoint can also be moved by selecting it and by using the arrow keys. -The waypoints listed in the Dive Planner Points dialogue can be edited by hand in +The waypoints listed in the Dive Planner Points dialog can be edited by hand in order to get a precise presentation of the dive plan. In fact, it is sometimes more easy to create the whole dive profile by editing the Dive Planner Points dialog.

    Show any changes in gas cylinder used by indicating gas changes as explained @@ -5196,12 +5383,12 @@ where the dive duration is indicated. The information is intended to be used if modify the ascent "on the fly" in the case of unexpected deviations from the dive plan during the dive. For example, if it says "Runtime: 123min, Stop times + 2:49 /m + 1:30 /min" this means: if you dive deeper than planned, you should add almost 3 minutes per meter you go deeper to your decompression (and -you can substract 3 minutes per meter that you stay shallower). If you overstay your bottom +you can subtract 3 minutes per meter that you stay shallower). If you overstay your bottom time, you need to add one and a half minutes to the stops for each minutes you overstay and similarly, you can shorten your deco time by one and a half minute for each minute you stay shorter. These variations of depth and time are based on the last manually entered segment of the dive (not necessarily the deepest). The additional minutes should be distributed -over the differnent stops in a way proportional to the stop length, i.e. add more of the +over the different stops in a way proportional to the stop length, i.e. add more of the additional minutes to the longer, shallower stops. The given times refer to the duration of the decompression phase and do not include the extended bottom time! This way of altering dive plans becomes inaccurate for large deviations from the original @@ -5331,9 +5518,13 @@ in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment.<

    		Open circuit diving is often part of a pSCR dive because, at shallow depths, the pO2 in the loop is often too low for breathing and the shallow parts of a pSCR dive are often done on OC. The change -from rebreather mode to OC or vice versa is indicated using bailout events. The image on the +from rebreather mode to OC or vice versa is indicated using bailout events. There are two ways to plan +bailout in rebreather dives: 1) Check the Bailout checkbox in the Dive mode section of the planner. In this +case, bailout requirements will be calculated starting at the last segment of the dive specified in the Dive planner points table. 2) If +bailout takes place at another point in the dive (see example of cave dive below) then bailout is planned +by manipulating the Dive mode column of the Dive planner points table. The image on the left shows a pSCR dive plan (using three cylinders) where the shallow parts of the dive are performed using EAN50 in -order to have a sufficient pO2. The bottom part of the dive is perfomed with EAN31 (Cyl. 2 in the +order to have a sufficient pO2. The bottom part of the dive is performed with EAN31 (Cyl. 2 in the Available gases table, also indicated in the Dive planner points table). The third cylinder, also EAN31, is a bailout cylinder which is, initially, not used. In this case the plan is for a cave dive with a bottom time of 20 minutes @@ -5343,12 +5534,12 @@ the dive and the green pO2 indicates the estimated pO2 in whole dive being performed in rebreather mode. We wish to plan for a worst-case scenario with bailout at the turning point (i.e. the furthest point into the cave). In the Dive planner points table, change the Dive mode of the last two segments -to OC (indicated in the left-hand image, labled A, below). In this case the existing EAN31 +to OC (indicated in the left-hand image, labelled A, below). In this case the existing EAN31 cylinder (Cyl.2 in the Dive planner points table is used for bailout (i.e. the bailout cylinder [Cyl. 3] has not been used yet). Note that the pO2 graph now indicates the appropriate pO2 values, since the gas breathed now has the pO2 of an OC configuration. In order to switch to the bailout cylinder (Cyl. 3), indicate this by selecting the appropriate cylinder in the Dive planner points table as -indicated in the image on the right, below (labeled B). The icon on the depth profile +indicated in the image on the right, below (labelled B). The icon on the depth profile now shows an overlapping bailout event with cylinder change. As in the graph on the left, the appropriate pO2 values are shown in the pO2 graphs. The volumes of gas required can be obtained at the bottom of the Dive plan details panel. It is often necessary to plan for a worst-case bailout event in order to ensure sufficient bailout gas to reach the -surface, taking into account decompression. This is done by defining a 1-minute segment at the end of the bottom part -of the dive, as in the image on the left where a CCR dive to 40m for 21 minutes is planned.
    @@ -5406,8 +5601,8 @@ of the dive, as in the image on the left where a CCR dive to 40m for 21 minutes
    		Note In the dive planner points -table, change the Dive mode of this 1-minute segment to OC. This signifies bailout. In this case there is bailout to +In the Dive planner points +table, change the Dive mode of this 1-minute segment to OC. This signifies bailout. In this case there is bailout to the existing diluent cylinder (assuming this cylinder has sufficient gas). The appropriate pO2 and cylinder pressure graphs are shown in the dive profile, as in the image on the left. Note that the setpoint drops to zero after bailout, since this value does not apply to breathed bailout gas. The Uwatec Galileo dive computers use infra red (IrDA) communication between the dive computer and Subsurface. The Uwatec hardware uses a USB dongle based on the serial infra-red (SIR) protocol and the -MSC7780 IrDA controller manufactured by MosChip +MCS7780 IrDA controller manufactured by MosChip and marketed by Scubapro and some electronics companies. -Under Linux, the kernel +Under current Linux, the kernel already provides for communication using the IrDA protocol. However, the user additionally needs to load a driver for the IrDA interface with the dive computer. The easiest way is to load the irda-tools package from the Linux IrDA Project. After the installation of the irda-tools, the root user can specify a device name -from the console as follows: -irattach irda0
    +

    irattach irda0

    After executing this command, Subsurface will recognize the Galileo dive computer and download dive information.

    Under Windows, a similar situation exists. Drivers for the MCS7780 are @@ -6321,8 +6506,10 @@ available from some Internet web sites e.g. www.drivers-download.com. Windows-based IrDA drivers for the Uwatec can also be downloaded from the ScubaPro web site, with drivers located on the download page for the ScubaPro SmartTrak software.

    -

    For the Apple Mac, IrDA communication via the MCS7780 link is not -available for OSX 10.6 or higher.

    +

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

    18.3. Importing from Heinrichs Weikamp DR5

    @@ -6455,18 +6642,18 @@ Copy the contents of the clipboard into the text editor and save the text file

  • -Within Subsurface, select Import → Import log files to open the universal import dialogue. +Within Subsurface, select Import → Import log files to open the universal import dialog.

  • -In the dropdown list towards the bottom right of the dialogue (labeled Filter:), select "APD log viewer". +In the dropdown list towards the bottom right of the dialog (labelled Filter:), select "APD log viewer".

  • On the list of file names select the .apd file created. An import - dialogue opens showing the default settings for the data in the + dialog opens showing the default settings for the data in the .apd file. If changes are required, do this as for CSV imports.

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

    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 +the dialog 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. @@ -6853,7 +7040,7 @@ In Libreoffice Calc the time format should be set to minutes:seconds - [mm]:ss a FIGURE: Spreadsheet data

    -

    To export the data as a .CSV file from within LibreOffice click File → Save As. On the dialogue that comes up, select the Text CSV (.csv) as the file type and select the option Edit filter settings.

    +

    To export the data as a .CSV file from within LibreOffice click File → Save As. On the dialog that comes up, select the Text CSV (.csv) as the file type and select the option Edit filter settings.

    FIGURE: Save as options @@ -6920,13 +7107,13 @@ Click OK twice. FIGURE: Excel save as option
    -

    Click on the left-hand part of the Save as option, NOT on the arrow on the right-hand. This brings up a dialogue for saving the +

    Click on the left-hand part of the Save as option, NOT on the arrow on the right-hand. This brings up a dialog for saving the spreadsheet in an alternative format. From the dropdown list at the -bottom of the dialogue, marked Save as Type:, select CSV(Comma delimited) (*.CSV). Be sure the appropriate folder has been +bottom of the dialog, marked Save as Type:, select CSV(Comma delimited) (*.CSV). Be sure the appropriate folder has been selected to save the CSV file into.

    -FIGURE: Excel save CSV dialogue +FIGURE: Excel save CSV dialog

    Select the Save button. The CSV-formatted file is saved into the @@ -6942,21 +7129,21 @@ explained on the section Importing CSV dives.

    Subsurface has a way to create or modify templates for printing dive logs to produce customized printouts of them. Templates written in HTML, as well as a simple Grantlee instruction set, are rendered to the print device by Subsurface.

    -

    Templates are accessed using the print dialogue (see image B below).

    +

    Templates are accessed using the print dialog (see image B below).

    -FIGURE: Print dialogue +FIGURE: Print dialog

    The buttons under the Template dropdown box lets you Edit, Delete, Import and Export templates (see image A above). New or modified templates are stored as HTML files in the same directory as the dive log being processed. In order to create or modify -a template, select one of the templates from the template dropdown list in the print dialogue +a template, select one of the templates from the template dropdown list in the print dialog (see image B above). Choose an existing template that resembles the final desired printout. Then select Edit.

    The Edit Panel has three tabs:

    -FIGURE: template edit dialogue +FIGURE: template edit dialog

    1) The Style tab (image A above) controls the font, line spacing and color template used for printing the dive log. @@ -6979,7 +7166,7 @@ a template, select one of the templates from the template dropdown list in the p

    You can adapt any of the existing templates and save it to the dive log directory. The standard templates (e.g. One dive, Six dives, Table) can be modified in this way. After completing the edits, use the Export button in the print -dialogue to save the new template using a new template name.

    +dialog to save the new template using a new template name.

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

    21.1. Main dive loop

    @@ -7446,7 +7633,7 @@ cannot be salvaged after being overwritten by new dives.

    diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 37595e546..b77890066 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -4,7 +4,7 @@ // Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Willem // Ferguson, Salvador Cuñat, Pedro Neves // :revnumber: 4.9 -// :revdate:June 2019 +// :revdate:July 2019 :icons: :toc2: :toc-placement: manual @@ -19,7 +19,7 @@ image::images/Subsurface4Banner.jpg["Banner",align="center"] Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Pedro Neves, Stefan Fuchs -[blue]#_Version 4.9, June 2019_# +[blue]#_Version 4.9, July 2019_# Welcome as a user of _Subsurface_, an advanced dive logging program with extensive infrastructure to describe, organize, interpret and print scuba -- cgit v1.2.3-70-g09d2