diff options
Diffstat (limited to 'Documentation/user-manual_fr.txt')
| -rw-r--r-- | Documentation/user-manual_fr.txt | 557 |
1 files changed, 361 insertions, 196 deletions
diff --git a/Documentation/user-manual_fr.txt b/Documentation/user-manual_fr.txt index 8c90f2c27..2a023f563 100644 --- a/Documentation/user-manual_fr.txt +++ b/Documentation/user-manual_fr.txt @@ -108,10 +108,10 @@ La *carte de plongée* en bas à droite, affiche les sites de plongées de l'utilisateur, sur une carte mondiale et centrée sur le site de la dernière plongée sélectionnée dans la *liste des plongées*. -Les *informations de plongée* en haut à gauche, fournissent des informations -détaillées sur la plongée sélectionnée dans la *liste des plongées*, dont -des statistiques pour la plongée sélectionnée ou pour toutes les plongées -mises en surbrillance. +Les *informations* en haut à gauche, fournissent des informations détaillées +sur la plongée sélectionnée dans la *liste des plongées*, dont des +statistiques pour la plongée sélectionnée ou pour toutes les plongées mises +en surbrillance. Le *profil de plongée* en haut à droite, affiche un profil de plongée graphique de la plongée sélectionnée dans la *liste des plongées*. @@ -127,9 +127,9 @@ sélectionnée_ sont affichées dans les panneaux respectifs. D'autre part, si plus d'une plongée est mise en surbrillance seule la dernière mise en surbrillance est la _plongée sélectionnée_, mais les données de _toutes les plongées mises en surbrillances_ sont affichées dans l'onglet *Stats* du -panneau *informations de plongée* (profondeur maximale, minimale et moyenne, -les durées, les températures de l'eau et le SAC (air consommé); temps total -et nombre de plongées sélectionnées). +panneau *informations* (profondeur maximale, minimale et moyenne, les +durées, les températures de l'eau et le SAC (air consommé); temps total et +nombre de plongées sélectionnées). [[S_ViewPanels]] @@ -217,18 +217,18 @@ duration, 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 *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# in the figure below. Each of these -tabs will now be explained for data entry. +panels to enter 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# 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"] @@ -240,14 +240,14 @@ 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. -==== Notes de plongée +==== 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 fields are visible: +descriptive 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 one can choose the correct @@ -340,9 +340,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: +completed 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 @@ -471,13 +471,13 @@ image::images/DiveProfile4_f20.jpg["FIGURE: Completed dive profile", align="cent ==== Saving the hand-entered dive information -The information entered in the *Dive 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, the dive data are saved in the current logbook. If the -_Cancel_ button is clicked, the newly entered dive data are discarded. When -exiting _Subsurface_, the user will be prompted once more to save the -logbook with the new dive(s). +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 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 dive data are discarded. When exiting +_Subsurface_, the user will be prompted once more to save the logbook with +the new dive(s). [[S_ImportDiveComputer]] === Importing new dive information from a Dive Computer @@ -538,7 +538,7 @@ that have not been uploaded before. This makes the download process faster on most dive computers and also saves battery power of the dive computer (at least for those not charging while connected via USB). If, for some reason, the user wishes to import ALL dives from the dive computer, even though some -may already be in the logbook, then check the check box labelled _Force +may already be in the logbook, then check the check box labeled _Force download of all dives_. - The dialogue has two drop-down lists, *Vendor* and *Dive Computer*. On the @@ -690,10 +690,10 @@ device instead of the model name, 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 _Subsurface_ window should be used. +fuller record of the dives. To do this, the *Notes* and the *Equipment* tabs +on the top left hand of the _Subsurface_ window should be used. -==== Notes de plongée +==== 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 @@ -701,10 +701,10 @@ additional information by hand in order to have a more complete dive record. In a few cases, (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 visible: +the dive is being edited. If one 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 one can choose the correct @@ -800,9 +800,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: +completed 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 @@ -888,17 +888,17 @@ 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 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 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 identical information. This is achieved by -editing the dive notes or the equipment for any one of the selected dives. +items of information 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 *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 *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. The simultaneous editing only works with fields that do not already contain information. This means that, if some fields have been edited for a @@ -913,15 +913,15 @@ 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 +dive with all the appropriate information 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 *Dive 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_. -All the selected dives now contain the data initially selected in the -original source dive log. +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_. All the selected +dives now contain the data initially selected in the original source dive +log. ==== Adding Bookmarks to a dive @@ -948,13 +948,13 @@ 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 saved by using the two buttons on the top right hand of the *Dive 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 deleted, -although the dive profile obtained from the dive computer will be -retained. When the user exits _Subsurface_ there is a final prompt to -confirm that the new data should be saved. +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 *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 deleted, although +the dive profile obtained from the dive computer will be retained. When the +user exits _Subsurface_ there is a final prompt to confirm that the new data +should be saved. === Importing dive information from other digital data sources or other data formats @@ -1014,6 +1014,18 @@ 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 @@ -1135,12 +1147,12 @@ table contains the column headings found in the _CSV_ data file. The blue row of cells immediately above these contains the names understood by _Subsurface_. The white area below the dropdown lists contains all the field names that _Subsurface_ recognises. These names are in blue balloons and can -be moved using a drag-and-frop action. For instance, _Subsurface_ expects +be moved using a drag-and-drop action. For instance, _Subsurface_ expects the column heading for Dive number (" # ") to be "Dive # ". If the column heading that _Subsurface_ expects is not in the blue cells, then drag the appropriate column heading from the upper area and drop it in the appropriate blue cell at the top of the table. To indicate the correct -column for "Dive #", drag the ballooned item labelled "Dive # " and drop it +column for "Dive #", drag the ballooned item labeled "Dive # " and drop it in the blue cell immediately above the white cell containing " # ". This is depicted in the image below. @@ -1159,8 +1171,8 @@ in the *Dive List* panel. [IMPORTANT] _CSV_ is an abbreviation for a data file format: _Comma-Separated -Variables_. It is a file format allowing someone to view or edit the -information using a text editor such as Notebook (Windows), gedit (Linux) or +Values_. It is a file format allowing someone to view or edit the +information using a text editor such as Notepad (Windows), gedit (Linux) or TextWrangler (OS/X). The two main advantages of the _CSV_ format is that the data are easily editable as text without any proprietary software and ensuring all information is human-readable, not being obscured by any custom @@ -1601,7 +1613,7 @@ image::images/icons/ShowPhotos_f20.png["FIGURE:Show photos toolbar button", alig 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: @@ -1625,9 +1637,9 @@ image::images/LoadImage6_f20.jpg["FIGURE: Full-screen photo on dive profile", al ==== The _Photos_ tab Photographs associated with a dive are shown as thumbnails in the _Photos_ -tab of the _Dive 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 +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 give an indication of when during a dive a photo was taken. By single-clicking on a thumbnail in the _Photos_ panel, a photo is selected. By double-clicking a @@ -1652,6 +1664,60 @@ 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. +[[Moving_images]] +==== 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 @@ -1667,7 +1733,7 @@ technical divers who dive deep or long. As far 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 @@ -1680,7 +1746,7 @@ there are only two types of information that need to be provided: in time on the *Dive Profile* panel and indicating the cylinder to which the change was made. After right-clicking, follow the context menu to "Add gas change" and select the appropriate cylinder from those defined during the first step, above (see image below). If the - *tank bar* button in the ttolbar has been activated, the cylinder switches are also indicated in the + *tank bar* button in the toolbar has been activated, the cylinder switches are also indicated in the tank bar. Having performed these tasks, _Subsurface_ indicates the appropriate use of @@ -1708,7 +1774,7 @@ 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. @@ -1719,11 +1785,11 @@ steps: profile with a cylinder symbol. If the *Tank Bar* is activated using the toolbar to the left of the profile, then the cylinder change is also indicated on the Tank Bar (see image below). After all the cylinder change events have been recorded on the dive profile, the correct cylinder pressures - for both cylinders are shown on the dive profile, as inthe image below. + for both cylinders are shown on the dive profile, as in the image below. image::images/sidemount1.jpg["FIGURE: Sidemount profile", align="center"] -This section gives an example of the versatility of _Subsurface_ as a give +This section gives an example of the versatility of _Subsurface_ as a dive logging tool. @@ -1747,7 +1813,7 @@ 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 and indicate the @@ -1755,7 +1821,7 @@ outlined above: xref:S_MulticylinderDives[multicylinder dives]. If a pSCR _Dive Mode_ has been selected, the dive ceiling for pSCR dives is -adjusted for the oxygen drop accross the mouthpiece which often requires +adjusted for the oxygen drop across the mouthpiece which often requires longer decompression periods. Below is a dive profile of a pSCR dive using EAN36 on the back cylinder and oxygen for decompression. Note that this dive lasted over two hours. @@ -1870,7 +1936,7 @@ the pressures of the oxygen and diluent cylinders. The pressures of these two cylinders are shown as green lines overlapping the depth profile. In addition, start and end pressures for both oxygen and diluent cylinders are shown in the _Equipment Tab_. Below is a dive profile for a CCR dive, -including an overaly of setpoint and oxygen sensor data, as well as the +including an overlay of setpoint and oxygen sensor data, as well as the cylinder pressure data. In this case there is good agreement from the readings of the two oxygen sensors. @@ -1886,13 +1952,13 @@ 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 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. +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 toxicity units (OTU) incurred. [icon="images/icons/info.jpg"] [NOTE] @@ -2220,11 +2286,11 @@ other than air. Their values are dependent on the composition of the breathing gas. The EAD is the depth of a hypothetical air dive that has the same partial pressure of nitrogen as the current depth of the nitrox dive at hand. A nitrox dive leads to the same decompression obligation as an air -dive to the depth equalling the EAD. The END is the depth of a hypothetical +dive to the depth equaling the EAD. The END is the depth of a hypothetical air dive that has the same sum of partial pressures of the narcotic gases nitrogen and oxygen as the current trimix dive. A trimix diver can expect -the same narcotic effect as a diver breathing air diving at a depth -equalling the END. +the same narcotic effect as a diver breathing air diving at a depth equaling +the END. Figure (*B*) above shows an information box with a nearly complete set of data. @@ -2305,9 +2371,9 @@ side of the above figure for a diver using EAN32. === 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"] @@ -2350,36 +2416,41 @@ 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 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): +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): 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 now shows only the titles for the trips. +list, (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 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.). After entering this information, users -should select *Save* from the buttons at the top right of the *Trip Notes* -tab. The trip title in the *Dive List* panel should now reflect some of the -edited information. +title from 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.). After entering this information, users should +select *Save* from the buttons at the top right of the *Trip Notes* tab. The +trip title in the *Dive List* panel should now reflect some of the edited +information. ==== Viewing the dives during a particular trip @@ -2390,16 +2461,16 @@ 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 within trips. This includes expanding all trips, collapsing -all trips and collapsing all trips except the selected one. +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 @@ -2428,14 +2499,14 @@ 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. +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*. +within 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) @@ -2446,7 +2517,7 @@ and right-click the dive(s) to be 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. +should be ealier or later. ==== Merge dives into a single dive @@ -2456,12 +2527,21 @@ 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* 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: +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 @@ -2474,12 +2554,12 @@ 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. 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. An example of the _Filter -Panel_ is shown in the figure below. +can be reset (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 *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"] @@ -2492,14 +2572,13 @@ 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. 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. +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. [[S_ExportLog]] == Exporting the dive log or parts of the dive log @@ -2527,10 +2606,10 @@ connexion _Facebook_. 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 -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, +one's _Facebook_ timeline is easy. 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 _Facebook_ album needs to be provided. The @@ -2578,7 +2657,7 @@ A dive log or part of it can be saved in three formats: _Divelogs.de_. Log into _http://en.divelogs.de_ and subscribe to this service in order to upload dive log data from _Subsurface_. -* _DiveShare_ is also a dive log repostory on the Internet focusing on the +* _DiveShare_ is also a dive log repository on the Internet focusing on the recreational dives. In order to upload dives one has to provide a used ID, so registration with _http://scubadiveshare.com_ is required. @@ -2806,7 +2885,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 @@ -2856,6 +2935,7 @@ the dive profile: ** _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 @@ -2983,7 +3063,7 @@ 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. +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 @@ -2998,35 +3078,121 @@ 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 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 the table labelled _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 <<S_CylinderData,providing - cylinder data for dive logs>>. Choose the cylinder type by double clicking - the cylinder type and using the dropdown list, then specify the work - pressure of this cylinder. By leaving the oxygen concentration (O2%) filed - 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 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* + dive parameters are 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 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 <<S_CylinderData,providing cylinder data for dive + logs>>. Choose the cylinder type by double clicking the cylinder type and + using the dropdown list, then specify the work pressure of this cylinder. By + leaving the oxygen concentration (O2%) filed 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 righthand of the dialogue. + +- 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_ @@ -3056,7 +3222,6 @@ _Drop to first depth_ 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_). @@ -3102,7 +3267,7 @@ specified in the _Available Gases_ table. Add new waypoints until the main features of the dive have been completed, e.g. the bottom time segment and deep stops (if these are implemented). Leave the remaining waypoints on the ascent to _Subsurface_. In most cases _Subsurface_ computes additional way -points in order to fulfil decompression requirements for that dive. A +points in order to fulfill decompression requirements for that dive. A waypoint can be moved by selecting that waypoint and by using the arrow keys. The waypoints listed in the _Dive Planner Points_ dialogue can be edited by hand in order to obtain a precise presentation of the dive @@ -3140,7 +3305,7 @@ appear 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 +by checking any of the 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 @@ -3153,6 +3318,25 @@ INCLUDES the transition 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 @@ -3177,25 +3361,6 @@ image::images/Planner_CCR1_f20.jpg["FIGURE: Planning a CCR dive: setup", align=" 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 apears 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 accross 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 @@ -3239,8 +3404,8 @@ Plan Details_ for 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 _Print_ button in the dive +gas calculations are saved in 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 @@ -3315,8 +3480,7 @@ des sections de ce manuel traitant des opérations relatives. *liste des plongées*. - <<S_ViewPanels,_Profil_>> - Affiche uniquement le panneau du *profil de la plongée*. -- <<S_ViewPanels,_Info_>> - Affiche uniquement le panneau des *notes de - plongée*. +- <<S_ViewPanels,_Info_>> - Affiche uniquement le panneau des *notes*. - <<S_ViewPanels,_Globe_>> - Affiche uniquement le panneau de la *carte mondiale*. - _Statistiques annuelles_ - Affiche par année le résumé des statistiques des @@ -3677,7 +3841,7 @@ _Subsurface_ as follows: files_". - On the list of file names select the .CSV file that has been created above. An import dialogue opens. -- In the dropdown list on the middle right labeled '_Pre-configured imports_", +- In the dropdown list on the top left labeled '_Pre-configured imports_", select _APD Log Viewer_. - Ensure the other settings for the ADP dive log are appropriate, then select _OK_. @@ -3719,8 +3883,8 @@ naming conventions to export dive log data. appropriate dives. 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 + * To select all dives: Select the first dive, hold down shift and 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'. @@ -3762,10 +3926,11 @@ 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. -The divelog is kept in a SQlite database at +The divelog is kept in a SQLite database at C:\ProgramData\AtomicsAquatics\Cobalt-Logbook\Cobalt.db. This file can be directly imported to Subsurface. @@ -3827,7 +3992,7 @@ following a few simple rules: 1. Date: use one of the following formats: yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy 2. Duration: the format should be minutes:seconds. -3. Unit system: only one unit system shold be used (i.e., no mixture between +3. Unit system: only one unit system should be used (i.e., no mixture between imperial and metric units) 4. Tags and buddies: values should be separated using a comma. 5. GPS position: users must use decimal degrees, e.g. 30.22496 30.821798 |