diff options
Diffstat (limited to 'Documentation/user-manual.txt')
| -rw-r--r-- | Documentation/user-manual.txt | 347 |
1 files changed, 249 insertions, 98 deletions
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 78e56cab2..bcfb7d8d0 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -89,7 +89,7 @@ Start Using the Program ----------------------- The _Subsurface_ window is usually divided into four panels with a *Main -Menu* (File Import Log View Filter Help) at the top of the window (for Windows +Menu* (File 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. The *Dive List* to the bottom left containing a list of all the dives in the @@ -102,7 +102,7 @@ between dives. The *Dive List* is an important tool for manipulating a dive log. map and centred on the site of the last dive selected in the *Dive List*. -3. The *Dive Info* to the top left, giving more detailed information on the +3. The *Info* to the top left, giving more detailed information on the dive selected in the *Dive List*, including some statistics for the selected dive or for all highlighted dive(s). @@ -119,7 +119,7 @@ and profile of the _selected dive_ are shown in the respective panels. On the other hand, if one highlights more than one dive the last highlighted dive is the _selected dive_, but summary data of all _highlighted dives_ are shown in the *Stats* tab -of the *Dive Info* panel (maximum, minimum and average depths, durations, water +of the *Info* panel (maximum, minimum and average depths, durations, water temperatures and SAC; total time and number of dives selected). [[S_ViewPanels]] @@ -136,7 +136,7 @@ display: *Profile*: Show only the Dive Profile of the selected dive. -*Info*: Show only the Dive Notes about the last selected dive and statistics for +*Info*: Show only the Notes about the last selected dive and statistics for all highlighted dives. *Globe*: Show only the world map, centred on the last selected dive. @@ -201,7 +201,7 @@ depth, the names of your dive buddy and of the dive master or dive guide, and some remarks about the dive. _Subsurface_ can store much more information than this for each dive. In order to add a dive to a dive log, select _Log -> Add Dive_ from the Main Menu. The program then shows three panels to enter -information for a dive: two tabs in the *Dive Info* panel (*Dive Notes* and +information for a dive: two tabs in the *Info* panel (*Notes* and *Equipment*), as well as the *Dive Profile* panel that displays a graphical profile of each dive. These panels are respectively marked [red]#A#, [red]#B# and [red]#C# @@ -209,9 +209,9 @@ in the figure below. Each of these tabs will now be explained for data entry. image::images/AddDive1_f20.jpg["FIGURE: Add dive",align="center"] -When one edits a field in Dive notes or Equipment panels, _Subsurface_ enters *Editing Mode*, -indicated by the message in the blue box at the top of the _Dive Notes_ panel (see the image below). This message is -displayed in all the panels under Dive notes and Equipment when in *Editing Mode*. +When one edits 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*. image::images/BlueEditBar_f20.jpg["Blue edit bar",align="center"] @@ -221,14 +221,14 @@ before saving the information. By selecting the _Save_ button, a local copy of t for this specific dive is saved in memory. When one closes Subsurface, the program will ask again, this time whether the complete dive log should be saved on disk or not. -==== Dive Notes +==== Notes This panel contains the date, time and place information for a particular dive, environmental conditions, co-divers and buddies, as well as some descriptive -information. If one clicks on the *Dive Notes* tab, the following +information. If one clicks on the *Notes* tab, the following fields are visible: -image::images/AddDive2_f20.jpg["FIGURE: The Dive Notes tab",align="center"] +image::images/AddDive2_f20.jpg["FIGURE: The Notes tab",align="center"] The *Time* field reflects the date and the time of the dive. By clicking the date, a calendar is displayed from which @@ -323,9 +323,9 @@ shown for the user to choose from. The *Save* and *Cancel* buttons are used to save all the information for tabs in the info panel and in the dive profile panel, so there's no need to use them until ALL other information has been added. Here is an example of a completed -Dive Notes panel: +Notes panel: -image::images/CompletedDiveInfo_f20.jpg["FIGURE: A completed Dive Notes tab",align="center"] +image::images/CompletedDiveInfo_f20.jpg["FIGURE: A completed Notes tab",align="center"] ==== Equipment @@ -461,10 +461,10 @@ image::images/DiveProfile4_f20.jpg["FIGURE: Completed dive profile",align="cente ==== Saving the hand-entered dive information -The information entered in the *Dive Notes* tab, the *Equipment* tab as well as +The information entered in the *Notes* tab, the *Equipment* tab as well as the *Dive Profile* can now be saved in the user's logbook by using the two buttons -on the top right hand of the Dive Notes tab. If the _Save_ button is clicked, +on the top right hand of the Notes tab. If the _Save_ button is clicked, the dive data are saved in the current logbook. If the _Cancel_ button is clicked, the newly entered @@ -694,10 +694,10 @@ allowing easy identification of devices. With the uploaded dives in the *Dive List*, the information from the dive computer is not complete and more details must be added in order to have a fuller record of the dives. To do this, -the *Dive Notes* and the *Equipment* tabs on the top left hand of the +the *Notes* and the *Equipment* tabs on the top left hand of the _Subsurface_ window should be used. -==== Dive Notes +==== Notes The date and time of the dive, gas mixture and (often) water temperature are usually shown as obtained from the dive computer, but the user needs to add @@ -705,10 +705,10 @@ additional information by hand in order to have a more complete dive record. In (e.g. APD rebreathers) one also has to provide the date and time of the dive. If the contents of this tab is changed or edited in any way, the message in a blue box at the top of the panel indicates that the dive is being edited. If one -clicks on the *Dive Notes* tab, the following fields are +clicks on the *Notes* tab, the following fields are visible: -image::images/AddDive3_f20.jpg["FIGURE: The Dive Notes tab",align="center"] +image::images/AddDive3_f20.jpg["FIGURE: The Notes tab",align="center"] The *Time* field reflects the date and time of the dive. By clicking the date, a calendar is displayed from which @@ -807,9 +807,9 @@ typed The *Save* and *Cancel* buttons are used to save all the information for tabs in the info panel and in the dive profile panel, so there's no need to use them until ALL other information has been added. Here is an example of a completed -Dive Notes panel: +Notes panel: -image::images/CompletedDiveInfo_f20.jpg["FIGURE: A completed Dive Notes tab",align="center"] +image::images/CompletedDiveInfo_f20.jpg["FIGURE: A completed Notes tab",align="center"] ==== Equipment @@ -901,14 +901,14 @@ image::images/WeightsDataEntry3_f20.jpg["FIGURE: A completed weights information _METHOD 1_: After uploading dives from a dive computer, the dive profiles of the uploaded dives are shown in the *Dive profile* tab, as well as a few items of information -in the *Dive Notes* tab (e.g. water temperature) and in the *Equipment* tab (e.g. gas pressures +in the *Notes* tab (e.g. water temperature) and in the *Equipment* tab (e.g. gas pressures and gas composition). However the other fields remain empty. It may be useful to simultaneously edit some of the -fields in the *Dive Notes* and *Equipment* tabs. For instance, it is possible +fields in the *Notes* and *Equipment* tabs. For instance, it is possible that a diver performed several dives during a single day, using identical equipment while diving at the same dive site or with the same dive master and/or buddy or tags. Instead of completing the information for each of these dives separately, one can select all the dives for that day in the *Dive List* and -insert the same information in the *Dive Notes* and *Equipment* fields that need +insert the same information in the *Notes* and *Equipment* fields that need identical information. This is achieved by editing the dive notes or the equipment for any one of the selected dives. @@ -924,8 +924,8 @@ up the completion of the dive log after several similar dives. [[S_CopyComponents]] _METHOD 2_:There is a different way of achieving the same goal. Select a dive with all the appropriate information -typed into the *Dive Notes* and *Equipment* tabs. Then, from the main menu, select _Log -> Copy dive components_. -A box is presented with a selection of check boxes for most of the fields in the *Dive Notes* and *Equipment* tabs. +typed into the *Notes* and *Equipment* tabs. Then, from the main menu, select _Log -> Copy dive components_. +A box is presented with a selection of check boxes for most of the fields in the *Notes* and *Equipment* tabs. Select the fields to be copied from the currently selected dive, then select _OK_. Now, in the *Dive List*, select the dives into which this information is to be pasted. Then, from the main menu, select _Log -> Paste dive components_. @@ -954,10 +954,10 @@ image::images/Bookmarks.jpg["FIGURE: Bookmark dialog",align="center"] ==== Saving the updated dive information -The information entered in the *Dive Notes* tab and the *Equipment* tab can be +The information entered in the *Notes* tab and the *Equipment* tab can be saved by using the -two buttons on the top right hand of the *Dive Notes* tab. If the _Save_ button +two buttons on the top right hand of the *Notes* tab. If the _Save_ button is clicked, the dive data are saved. If the _Cancel_ button is clicked, then the newly entered dive data are @@ -1026,6 +1026,16 @@ Selecting the appropriate file in the file list 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. +==== Importing from Heinrichs Weikamp OSTC Tools + +_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 _All files_. +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. + + ==== Importing from Mares Dive Organiser V2.1 Since Mares utilise proprietary Windows software not compatible with @@ -1588,7 +1598,7 @@ image::images/icons/ShowPhotos_f20.png["FIGURE:Show photos toolbar button",align After the images have been loaded, they appear in two places: - - the _Photos_ tab of the *Dive Notes* panel. + - the _Photos_ tab of the *Notes* panel. - as tiny icons (stubs) on the dive profile at the appropriate positions reflecting the time each photograph was taken. See below: @@ -1611,7 +1621,7 @@ image::images/LoadImage6_f20.jpg["FIGURE: Full-screen photo on dive profile",ali ==== The _Photos_ tab -Photographs associated with a dive are shown as thumbnails in the _Photos_ tab of the _Dive Notes_ +Photographs associated with a dive are shown as thumbnails in the _Photos_ tab of the _Notes_ panel. Photos taken in rapid succession during a dive (therefore sometimes with large overlap on the dive profile) can easily be accessed in the _Photos_ tab. This tab serves as a tool for individually accessing the photos of a dive, while the stubs on the dive profile @@ -1633,6 +1643,54 @@ program only shows a small white dot where each photo should be on the dive prof In addition the _Photos_ tab only shows the file names of the photos. This is normal behaviour. If, later, the external drive with the photos is connected again, the photos can be seen in the normal way. +[[S_FindMovedImages]] +==== Moving photographs among directories, hard disks or computers + +After a photograph has been loaded into _Subsurface_ and associated with a specific dive, the directory + where the photo lies is stored, allowing _Subsurface_ to find the photograph when the dive is + opened again. If the photo or the whole photo collection is moved to another drive or to a different + machine, it is unlikely that the directory structure will remain identical to that of the original uploaded + photo. When this happens, _Subsurface_ looks for the photos at their original location before they were moved, + cannot find them and therefore cannot display them. Because, after moving photos, large numbers of photos + may need to be deleted and re-imported from the new location, _Subsurface_ has a mechanism that eases the + process of updating the directory information for each photo: automatic updates using fingerprints. + +When a photo is loaded into _Subsurface_, a fingerprint for the image is calculated and stored with the + other reference information for that photo. After moving a photo collection (that has already been loaded + into _Subsurface_) to a different directory, disk or computer, _Subsurface_ can perform the + following steps: + +- look through a particular directory (and all its subdirectories recursively) where photos have been moved + to, + +- calculate fingerprints for all photos in this directory, and + +- if there is a match between a calculated fingerprint and the one originally calculated when a photo was + loaded into _Subsurface_ (even if the original file name has changed), to automatically update the + directory information so that _Subsurface_ can find the photo in the new moved directory. + +This is achieved by selecting from the Main Menu: _File -> Find moved images_. This brings up a window within + which the NEW directory of the photos needs to be specified. Select the appropriate directory and click + the _Scan_ button towards the bottom right of the panel. The process may require several minutes to + complete, after which _subsurface_ will show the appropriate photographs when a particular dive is opened. + + +[[Image_fingerprint_upgrade]] +**** +*Upgrading existing photo collections without fingerprints* +[icon="images/icons/important.png"] +[IMPORTANT] + +Software for the automated update of existing photo collections is under developement. Currently single +dives must be upgraded one at a time. Select the toolbar button on the *Dive profile* panel that enables +the display of images. The thumbnails of images are shown on the dive profile. Then open the dive and +change anything in the *Notes* panel that brings up the blue edit bar at the top of the notes panel +to save the edits. For instance, add a space character at the end of the _Notes_ text box and immediately +delete that space character. Select the optio _Apply changes_ in the blue edit bar to save the dive information. +Fingerprints are calculated while saving this specific dive. + +**** + === Logging special types of dives @@ -1646,7 +1704,7 @@ multicylinder dives are often used by technical divers who dive deep or long. As as _Subsurface_ is concerned, there are only two types of information that need to be provided: - *Describe the cylinders used during the dive* This is performed in the *Equipment tab* of - the *Dive Info* panel, as xref:cylinder_definitions[described above]. Enter the cylinders one by one, + the *Info* panel, as xref:cylinder_definitions[described above]. Enter the cylinders one by one, specifying the characteristics of the cylinder and the gas composition within each cylinder. - *Record the times at which switches from one cylinder to another was done:* This is information @@ -1684,7 +1742,7 @@ dive logging involves, exactly as with multicylinder dives, above, three steps: has this facility) marking each cylinder switch with a bookmark that can be retrieved later. Returning from a dive with the information about cylinder changes is the only tricky part of logging sidemount dives. - *Within _Subsurface_ describe the cylinders used during the dive*. The diver needs to provide the - specifications of the different cylinders, using the *Equipment* tab of the *Dive Info Panel* (see + specifications of the different cylinders, using the *Equipment* tab of the *Info Panel* (see image below where two 12 litre cylinder were used). - *Indicate cylinder change events on the _Subsurface_ dive profile*. Once the dive log has been imported from a dive computer into _Subsurface_, the cylinder switch events need to be indicated on the dive profile. @@ -1718,7 +1776,7 @@ breathing gas is released continuously from the back cylinder. To log pSCR dives, no special procedures are required, just the normal steps outlined above: -- Select pSCR in the _Dive Mode_ dropdown list on the *Dive Info* panel. +- Select pSCR in the _Dive Mode_ dropdown list on the *Info* panel. - pSCR diving often involves gas changes, requiring an additional cylinder. Define all the appropriate cylinders as described above @@ -1845,9 +1903,9 @@ Poseidon MkVI and APD equipment can be found in xref:S_PoseidonMkVI[Appendix B]. == Obtaining more information about dives entered into the logbook -=== The *Dive Info* tab (for individual dives) +=== The *Info* tab (for individual dives) -The Dive Info tab gives some summary information about a particular dive that +The Info tab gives some summary information about a particular dive that has been selected in the *Dive List*. Useful information here includes the surface interval before the dive, the maximum and mean depths of the dive, the gas volume consumed, the surface air consumption (SAC) and the number of oxygen @@ -2240,9 +2298,8 @@ during a dive is indicated on the right hand side of the above figure for a dive === The Dive List context menu -Many actions within _Subsurface_ are dependent on a context menu used -mostly to manipulate groups of dives. The context menu is found by selecting -a dive or a group of dives and then right-clicking. +Several actions on either a single dive or a group of dives can be performed using the Dive List +Context Menu, found by selecting either a single dive or a group of dives and then right-clicking. image::images/ContextMenu.jpg["Figure: Context Menu",align="center"] @@ -2280,12 +2337,17 @@ given a choice with respect to the lowest sequence number to be used. Completing this operation results in new sequence numbers (based on date/time) for the dives in the *Dive List* panel. +One can also renumber a few selected dives in the dive list. Select the dives that +need renumbering. Right-click on the selected list and use the Dive List Context Menu +to perform the renumbering. A popup window appears requiring the user to specify +the starting number for the renumbering process. + [[S_Group]] === Grouping dives into trips and manipulating trips For regular divers, the dive list can rapidly become very long. _Subsurface_ can group dives into _trips_. It performs this by grouping dives that have -date/times that are not separated in time by more than two days, thus creating +date/times not separated in time by more than two days, thus creating a single heading for each diving trip represented in the dive log. Below is an ungrouped dive list (*A*, on the left) as well as the corresponding grouped dive list comprising five dive trips (*B*, on the right): @@ -2294,14 +2356,14 @@ image::images/Group2.jpg["Figure: Grouping dives",align="center"] Grouping into trips allows a rapid way of accessing individual dives without having to scan a long lists of dives. In order to group the dives in a dive list, -(from the Main Menu) users must select _Log -> Autogroup_. The *Dive List* panel +(from the Main Menu) select _Log -> Autogroup_. The *Dive List* panel now shows only the titles for the trips. ==== Editing the title and associated information for a particular trip Normally, in the dive list, minimal information is included in the trip title. More information about a trip can be added by selecting its trip title from -the *Dive List*. This shows a *Trip Notes* tab in the *Dive Notes* panel. Here +the *Dive List*. This shows a *Trip Notes* tab in the *Notes* panel. Here users can add or edit information about the date/time, the trip location and any other general comments about the trip as a whole (e.g. the dive company that was dived with, the general weather and surface conditions during the trip, etc.). @@ -2319,16 +2381,16 @@ the selected trip, revealing the individual dives performed during the trip. ==== Collapsing or expanding dive information for different trips -If a user right-clicks after selecting a particular trip in the dive list, the -resulting context menu allows several possibilities to expand or collapse dives +After selecting a particular trip in the dive list, the +context menu allows several possibilities to expand or collapse dives within trips. This includes expanding all trips, collapsing all trips and collapsing all trips except the selected one. ==== Merging dives from more than one trip into a single trip -By right-clicking on a selected trip title in the *Dive List* panel, a -context menu shows up that allows the merging of trips by either merging of the selected trip -with the trip below or with the trip above. +After selecting a trip title, the context menu allows the merging +of trips by either merging the selected trip with the trip below or with the +trip above.(Merge trip with trip below; Merge trip with trip above) ==== Splitting a single trip into more than one trip @@ -2358,16 +2420,14 @@ calibration dives of the dive computer or dives of extremely short duration. Users can unlink dives from the trip to which they belong. In order to do this, select and right-click the relevant dives to bring up the context menu. Then select the option *Remove dive(s) -from trip*. The dive(s) now appear immediately above the trip to -which they belonged. +from trip*. The dive(s) now appear immediately above or below the trip to +which they belonged, depending on the date and time of the unliked dive. ==== Add a dive to the trip immediately above Selected dives can be moved from the trip to which they belong and placed within -the trip immediately above the currently active trip. To do this, select -and right-click -the dive(s) to bring up the context menu, and then select *Add dive(s) to trip -immediately above*. +a separate trip. To do this, select and right-click +the dive(s) to bring up the context menu, and then select *Create new trip above*. ==== Shift the start time of dive(s) @@ -2379,7 +2439,7 @@ adjusted. This action brings up the context menu on which the *Shift times* option should be selected. User must then specify the time (in hours and minutes) by which the dives should be adjusted and click on the -option indicating whether the time adjustment should be forwards or backwards. +option indicating whether the time adjustment should be ealier or later. ==== Merge dives into a single dive @@ -2388,12 +2448,20 @@ for a few minutes, resulting in two or more dives being recorded by the dive computer and appearing as different dives in the *Dive List* panel. Users can merge these dives onto a single dive by selecting the appropriate dives, right-clicking them to bring up the context menu and then selecting *Merge selected -dives*. It may be necessary to edit the dive information in the *Dive Notes* +dives*. It may be necessary to edit the dive information in the *Notes* panel to reflect events or conditions that apply to the merged dive. The figure below shows the depth profile of two such dives that were merged: image::images/MergedDive.png["Example: Merged dive",align="center"] +==== Undo dive manipulations + +Important actions on dives or trips, described above, can be undone or redone. +This includes: _delete dives_, _merge dives_, _renumber dives_ and _shift dive times_. +To do this after performing any of these actions, from the *Main Menu* select +_Edit_. This brings up the possibility to _Undo_ or _Redo_ an action. + + [[S_Filter]] === Filtering the dive list @@ -2405,10 +2473,10 @@ 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. The _Filter Panel_ can be reset -(i.e. all current filters cleared) by selecting the *+*. The _Filter Panel_ may also be -minimised by selecting the middle icon. When minimised, only these three icons are shown. +(i.e. all current filters cleared) by selecting the *yellow angled arrow*. The _Filter Panel_ may also be +minimised by selecting the *green up-arrow". When minimised, only these three icons are shown. The panel can be maximised by clicking the icon that minimised the panel. The filter may also be -reset and closed by selecting the button with the flag. +reset and closed by selecting the *red button* with the white cross. An example of the _Filter Panel_ is shown in the figure below. image::images/Filterpanel.jpg["Figure: Filter panel",align="center"] @@ -2421,13 +2489,13 @@ textbox above the tags check list results in the tags check list being reduced to "_cave_" and "_cavern_". Filtering of the check list enables the rapid finding of search terms for filtering the dive list. -To activate filtering of the dive list, the check box of at least one item in one of -the four check lists needs to be checked. The dive list is then shortened to include -only the dives that pertain to the selection criteria specified in the check lists. +To activate filtering of the dive list, check at least tone 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. +shows those dives that have either one OR both of these tags. [[S_ExportLog]] == Exporting the dive log or parts of the dive log @@ -2452,7 +2520,7 @@ _Facebook_ connection. image::images/facebook1_f20.jpg["Figure: Facebook login",align="center"] Having established a login to _Facebook_, transfer of a dive profile to one's _Facebook_ timeline is easy. -A _Facebook_ icon appears in the *Dive Notes* panel of _Subsurface_ (See image *A* below). Ensure that the dive +A _Facebook_ icon appears in the *Notes* panel of _Subsurface_ (See image *A* below). Ensure that the dive that you want to transfer to the timeline is depicted in the _Subsurface_ *Dive Profile* panel. Select the _Facebook_ icon, and a dialogue is shown, determining the amount of additional information transferred with the dive profile (see image *B*, below). In order to transfer a dive profile to _Facebook_, the name of a @@ -2716,7 +2784,7 @@ image::images/Pref1_f20.jpg["FIGURE: Preferences defaults page",align="center"] the dive list. ** *Default cylinder*: Here users can specify the default cylinder listed in - the *Equipment* tab of the *Dive Notes* panel. + the *Equipment* tab of the *Notes* panel. ** *Animations*: Some actions in showing the dive profile are performed using animations. For instance, the axis values for depth and time change from dive to @@ -2765,6 +2833,7 @@ This panel allows two type of selections: ** _Show unused cylinders in Equipment Tab_: This checkbox allows display of information about unused cylinders when viewing the *Equipment Tab*. Conversely, if this box is not checked, and any cylinders entered using the *Equipment Tab* are not used (e.g. there was no gas switch to such a cylinder), then these cylinders are omitted from that list. +[[GradientFactors_Ref]] ** _Show average depth_: Activating this checkbox causes _Subsurface_ to draw a grey line across the dive profile, indicating the mean depth of the dive up to a particular point in time during that dive. Normally this is a u-shaped line indicating the deepest average depth just before the @@ -2888,7 +2957,7 @@ user interface. It is explicitly used under the following conditions: Like the _Subsurface_ dive log, the planner screen is divided into several sections (see image below). The *setup* parameters for a dive are entered into the several sections on the left hand side of the screen. -The setup is divided into several sections: Available Gases, Rates, Planning, Gas Options and Dive Notes. +The setup is divided into several sections: Available Gases, Rates, Planning, Gas Options and Notes. At the top right hand is a green *design panel* upon which the profile of the dive can be manipulated directly by dragging and clicking as explained below. This feature makes the @@ -2901,17 +2970,18 @@ any warning messages about the dive plan are printed. image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window",align="center"] -=== Open circuit dives as an example of dive planning +=== Open circuit dives -- Towards the left bottom of the planner (circled in blue in the image below) is a dropbox with three options. Select the appropriate one of these: +- Towards the centre bottom of the planner (circled in blue in the image above) is a dropbox with three options. Select the appropriate one of these: ** Open Circuit (the default) ** CCR ** pSCR +- Choose the Open Circuit option. - In the top left-hand area of the planning screen, ensure that the constant dive parameters are - appropriate. These are: Start date and time of the dive, Atmospheric Pressure and Altitude + appropriate. These are: Start date and time of the intended dive, Atmospheric Pressure and Altitude above sea level of the dive site. The atmospheric pressure can also be entered as an altitude - in metres, assuming an atmospheric pressure of 1.013 bar. + in metres, assuming a sea-level atmospheric pressure of 1.013 bar. - In the table labeled _Available Gases_, add the information of the cylinders to be used as well as the gas composition within that cylinder. This is done in a similar way as for @@ -2922,10 +2992,86 @@ image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window",align concentration in the boxes provided in this dialogue. Add additional cylinders by using the "+" icon to the top righthand of the dialogue. -- The dialogue indicating _Dive Planner Points_ is usually not used at this stage of the dive - planning. - -*The planning is performed in three stages* +- The profile of the planned dive can be created in two ways: + * Drag the waypoints + (the small white circles) on the existing dive profile in a way to represent the dive. Additional + waypoints can be created by double-clicking the existing dive profile. Waypoints can be deleted + by right-clicking a particular waypoint and selecting the _delete_ item from the resulting + context menu. + * The most efficient way to create a dive profile is to enter the appropriate values into the table + marked _Dive planner points_. The first line of the table represents the duration and the final + depth of the descent from the surface. Subsequent segments describe the bottom phase of the dive. + The _CC set point_ column is only relevant for closed circuit divers. + The ascent is usually not specified because this is what the planner is supposed to calculate. + Add additional segments to the profile by selecting the "+" icon at the top right hand of the + table. Segments entered into the _Dive planner points_ table automatically appear in the *Dive + Profile* diagram. + +==== Recreational dives + +The _Subsurface_ dive planner allows a sophisticated way of planning recreational dives, i.e. dives +that remain within no-decompression limits. +The dive planner automatically takes +into account the nitrogen load incurred in previous dives. But conventional dive tables are also used in a +way that can take into account previous dives. Why use a dive planner for recreational dives? Using +recreational dive tables, the maximum depth of a dive is taken into acount. However, few dives are +undertaken at a constant depth corresponding to the maximum depth (i.e. a "square" dive profile). This means that dive tables +overestimate the nitrogen load incurred during previous dives. The _Subsurface_ +dive planner calculates nitrogen load according to the real dive profiles of all uploaded previous dives, +in a similar way as dive computers calculate nitrogen load during a dive. This mean that the diver gets 'credit' +in terms of nitrogen loading for not remaining at maximum depth during previous dives, enabling planning a +longer subsequent dive. For the planner to work it is therefore crucial to upload all previous dives +onto _Subsurface_ before performing dive planning. + +To plan a dive, the appropriate settings need to be +defined. + +- Ensure that the date and time is set to that of the intended dive. This allows calculation of +the nitrogen load incurred during previous dives. + +- Immediately under the heading _Planning_ are two checkboxes _Recreational_ and _Safety Stop_. + Check these two boxes. + +- Then define the cylinder size, + the gas mixture (air or % oxygen) and the starting cylinder pressure in the top left-hand + section of the planner under _Available gases_. + +- The planner calculates whether the specified cylinder contains enough air/gas to complete + the planned dive. In order for this to be realistic, under _Gas options_, specify an appropriate + surface air consumption (SAC) rate for _Bottom SAC_. Suitable values are between 15 l/min and 30 l/min, + with novice divers or difficult dives requiring SAC rates closer to 30l/min. + +- Define the amount of gas that the cylinder must have at the end of the bottom section of the + dive just before ascent. A value of 50 bar is often used. + +- Define the depth of the dive by dragging the waypoints (white dots) on the dive profile or + (even better) defining the appropriate depths using the table under _Dive planner points_ as + desribed under the previous heading. If + this is a multilevel dive, set the appropriate dive depths to represent the dive plan by adding + waypoints to the dive profile or by adding appropriate dive planner points to the _Dive Planner Points_ + table. + +- The ascent speed can be changed. The default ascent speeds are those considered safe for recreational + divers. + +The dive profile in the planner indicates the maximum dive time within no-deco limits using the +Bühlmann ZH-L16 algorithm and the gas and depth settings specified as described above. The _Subsurface_ planner +allows rapid assessment of dive duration as a function of dive depth, given the nitrogen load incurred during previous dives. The +dive plan includes estimates of the amount of air/gas used, depending on the cylinder settings specified +under _Available gases_. If the initial cylinder pressure is set to 0, the dive duration shown is the +true no-deco limit (NDL) without taking into account gas used during the dive. If the surface above the dive profile is RED +it means that recreational dive limits are exceeded and either the dive duration or the dive depth needs to be reduced. + +Below is an image of a dive plan for a recreational dive at 30 metres. Although the no-deco limit (NDL) is 23 +minutes, the duration of the dive is limited by the amount of air in the cylinder, reflected by the information in the +text box at the bottom right of the panel. + +image::images/rec_diveplan.jpg["FIGURE: A recreational dive plan: setup",align="center"] + +==== Non-recreational open circuit dives, including decompression + +Non-recreational dive planning involves exceeding the no-deco limits and/or using multiple breathing gases. +Such dives are planned in three stages: *a) Nitrogen management*: This is performed by specifying the rates for descent and ascent, as well as the gradient factors (GFLow and GFHigh) under the headings _Rates_ and _Planning_ @@ -2950,7 +3096,6 @@ often in the range of 4-9 m/min. The descent rate is also specified. If the opti is activated, then the descent phase of the planned dive will be at the maximal descent rate specified in the _Rates_ section of the dive setup. - *b) Oxygen management*: In the *Gas Options* part of the dive specification, the maximum partial pressure for oxygen needs to be specified for the bottom part of the dive (_bottom po2_) as well as for the decompression part of the dive (_deco po2_). @@ -3028,7 +3173,7 @@ in the *Dive List* panel of _Subsurface_. On the bottom right of the dive planner, under _Dive Plan Details_, the exact details of the dive plan are provided. These details may be modified by checking any of the -options under the _Dive Notes_ section of the dive planner, immediately to the left +options under the _Notes_ section of the dive planner, immediately to the left of the _Dive Plan Details_. If a _Verbatim diveplan_ is requested, a detailed sentence-level explanation of the dive plan is given. If any of the management specifications have been exceeded during the planning, a warning @@ -3039,6 +3184,25 @@ level is indicated in the _Dive Plan Details_. This duration INCLUDES the transi time to get to that level. However, if the _Display transition in deco_ option is checked, the transitions are shown separately from the segment durations at a particular level. +=== Planning pSCR dives + +To plan a dive using a passive semi-closed rebreather (pSCR), select _pSCR_ rather than +_Open circuit_ in the dropdown list. +The parameters of the pSCR diver can be set by selecting _File -> Preferences -> Graph_ +from the main menu, where the gas consumption calculation takes into account the pSCR dump +ratio (default 10:1) as well as the metabolism rate. The calculation also takes the oxygen drop +accross the mouthpiece of the rebreather into account. If the +pO~2~ drops below what is considered a save value, a warning appears in the _Dive plan +details_. A typical pSCR configuration is with a single cylinder and one or more bail-out +cylinders. Therefore the setup of the _Available gases_ and the _Dive planner points_ tables +are very similar to that of a CCR dive plan, described above. However, no oxygen setpoints +are specified for pSCR dives. Below is a dive plan for a pSCR dive. The dive is comparable +to that of the CCR dive above, but note the longer ascent duration due to the lower oxygen +in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment. + +image::images/Planner_pSCR1_f20.jpg["FIGURE: Planning a pSCR dive: setup",align="center"] + + === Planning CCR dives To plan a dive using a closed circuit rebreather, select the _CCR_ option in the dropdown @@ -3063,25 +3227,6 @@ image::images/Planner_CCR1_f20.jpg["FIGURE: Planning a CCR dive: setup",align="c Note that, in the _Dive plan details_, the gas consumption for a CCR segment is not calculated, so gas consumptions of 0 litres are the norm. -=== Planning pSCR dives - -To plan a dive using a passive semi-closed rebreather (pSCR), select _pSCR_ rather than -_Open circuit_ in the dropdown list. -The parameters of the pSCR diver can be set by selecting _File -> Preferences -> Graph_ -from the main menu, where the gas consumption calculation takes into account the pSCR dump -ratio (default 10:1) as well as the metabolism rate. The calculation also takes the oxygen drop -accross the mouthpiece of the rebreather into account. If the -pO~2~ drops below what is considered a save value, a warning appears in the _Dive plan -details_. A typical pSCR configuration is with a single cylinder and one or more bail-out -cylinders. Therefore the setup of the _Available gases_ and the _Dive planner points_ tables -are very similar to that of a CCR dive plan, described above. However, no oxygen setpoints -are specified for pSCR dives. Below is a dive plan for a pSCR dive. The dive is comparable -to that of the CCR dive above, but note the longer ascent duration due to the lower oxygen -in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment. - -image::images/Planner_pSCR1_f20.jpg["FIGURE: Planning a pSCR dive: setup",align="center"] - - [[S_Replan]] === Modifying an existing dive plan @@ -3124,7 +3269,7 @@ inclusion in a text file or word processing document. Dive plans have many characteristics in common with dive logs (dive profile, dive notes, etc). After a dive plan has been saved, the dive details and gas calculations are saved in -the *Dive Notes* tab. While a dive plan is being designed, it can be printed using +the *Notes* tab. While a dive plan is being designed, it can be printed using the _Print_ button in the dive planner. This prints the dive details and gas calculations in the _Dive Plan Details_ panel of the dive planner. However, after the plan has been saved, it is represented in a way very similar to a dive log and the gas calculations cannot be @@ -3149,6 +3294,8 @@ dealing with the appropriate operations. - <<S_ExportLog,_Export_>> - Export the currently open dive logbook (or the selected dives in the logbook) to one of several formats. - <<S_PrintDivelog,_Print_>> - Print the currently open logbook. +- <<S_FindMovedImages, _Find moved images_>> - If photos taken during dives have been moved to + a different disk or directory, locate them and link them to the appropriate dives. - <<S_Preferences,_Preferences_>> - Set the _Subsurface_ preferences. - <<S_Configure,_Configure dive computer_>> - Edit the configuration of a dive computer. - _Quit_ - Quit _Subsurface_. @@ -3165,8 +3312,9 @@ dealing with the appropriate operations. === Log - <<S_EnterData,_Add Dive_>> - Manually add a new dive to the *Dive List* panel. +- _Edit dive_ - Edit a dive of which the profile was entered by hande and not from a dive computer. - <<S_DivePlanner,_Plan Dive_>> - This feature allows the planning of dives. -- <<S_Replan,_Re-plan dive_>> - Edit a dive plan that has been saved into the *Dive List*. +- <<S_Replan,_Edit dive in planner_>> - Edit a dive plan that has been saved into the *Dive List*. - <<S_CopyComponents,_Copy dive components_>> - By selecting this option, one can copy information from several fields of a dive log onto the clipboard. - _Paste dive components_ - Paste, into the selected dives in the *Dive List*, @@ -3183,7 +3331,7 @@ dealing with the appropriate operations. simmultaneously. - <<S_ViewPanels,_Dive List_>> - View only the *Dive List* panel. - <<S_ViewPanels,_Profile_>> - View only the *Dive Profile* panel. -- <<S_ViewPanels,_Info_>> - View only the *Dive Notes* panel. +- <<S_ViewPanels,_Info_>> - View only the *Notes* panel. - <<S_ViewPanels,_Globe_>> - View only the *World Map* panel. - _Yearly Statistics_ - Display summary statistics about dives during this and past years. @@ -3452,7 +3600,9 @@ dive computer and download dive information. Under Windows, a similar situation exists. Drivers for the MCS7780 are available from some Internet web sites e.g. -http://www.drivers-download.com/Drv/MosChip/MCS7780/[www.drivers-download.com]. +http://www.drivers-download.com/Drv/MosChip/MCS7780/[www.drivers-download.com]. Windows-based IrDA +drivers for the Uwatec can also be downloaded from the ScubaPro web site, drivers being 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. @@ -3588,7 +3738,7 @@ conventions to export dive log data. 4. 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 + select the last dive 5. With the dives marked, use the program menu _File -> Export_ 6. 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 @@ -3629,6 +3779,7 @@ Making a backup copy of the Suunto DM4/DM5 database: === Exporting from Atomic Logbook [[Atomic_Export]] +[icon="images/icons/atomiclogo.jpg"] [NOTE] Atomic Logbook is a Windows software by Atomic Aquatics. It allows downloading of dive information from Cobalt and Cobalt 2 dive computers. |