mifr/subsurface
1
0
Fork 0
mirror of https://github.com/subsurface/subsurface.git synced 2024-11-28 05:00:20 +00:00
Code Issues Projects Releases Packages Wiki Activity

Documentation: Merge/update french user-manual translation

Browse source 
Merge/update french user-manual translation.

Signed-off-by: Guillaume GARDET <guillaume.gardet@free.fr>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
Guillaume GARDET 2015-05-18 11:41:16 +02:00 committed by Dirk Hohndel
parent 6730405624
commit 5584158baa
4 changed files with 2939 additions and 1976 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1977
Documentation/50-pot/subsurface-manual.pot
View file

File diff suppressed because it is too large Load diff

1948
Documentation/fr/po/subsurface-manual.fr.po
View file

File diff suppressed because it is too large Load diff

688
Documentation/user-manual_fr.html.git
View file

@ -508,16 +508,16 @@ nouveau sondage en démarrant <em>Subsurface</em> avec l&#8217;option <em>--sur
ligne de commande.</p></div>
</div>
</div>
<div class="sect1">
<h2 id="S_StartUsing">3. Commencer à utiliser le programme</h2>
<div class="sectionbody">
<div class="paragraph"><p>La fenêtre <em>Subsurface</em> est généralement divisée en 4 panneaux avec un <strong>Menu
principal</strong> (Fichier Importer Journal Vue Aide) en haut de la fenêtre (pour
Windows et Linux) ou en haut de l'écran (pour Mac et Ubuntu Unity). Les
quatre panneaux sont :</p></div>
<div class="paragraph"><p>La <strong>liste des plongées</strong> en bas à gauche, contenant une liste de toutes les
plongées du journal (carnet) de plongées de l&#8217;utilisateur. Une plongée peut
être sélectionnée et mise en surbrillance dans la liste en cliquant
<div class="sect1">
<h2 id="S_StartUsing">3. Commencer à utiliser le programme</h2>
<div class="sectionbody">
<div class="paragraph"><p>The <em>Subsurface</em> window is usually divided into four panels with a <strong>Main
Menu</strong> (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:</p></div>
<div class="paragraph"><p>La <strong>liste des plongées</strong> en bas à gauche, contenant une liste de toutes les
plongées du journal (carnet) de plongées de l&#8217;utilisateur. Une plongée peut
être sélectionnée et mise en surbrillance dans la liste en cliquant
dessus. Dans la plupart des cas, les touches haut/bas peuvent être utilisée
pour passer d&#8217;une plongée à l&#8217;autre. La <strong>liste des plongées</strong> est un outil
important pour manipuler un journal (carnet) de plongée.</p></div>
@ -1569,13 +1569,24 @@ CSV (text-based and spreadsheet-based) dive logs, including APD CCR logs
<div class="paragraph"><p>Selecting the appropriate file in the file list of the dialogue opens the
imported dive log in the <em>Subsurface</em> <strong>Dive List</strong>. Some other formats, not
accessible through the Import dialogue are also supported, as explained
below.</p></div>
</div>
<div class="sect3">
<h4 id="_importing_from_mares_dive_organiser_v2_1">5.3.2. Importing from Mares Dive Organiser V2.1</h4>
<div class="paragraph"><p>Since Mares utilise proprietary Windows software not compatible with
multi-platform applications, these dive logs cannot be directly imported
into <em>Subsurface</em>. Mares dive logs need to be imported using a three-step
below.</p></div>
</div>
<div class="sect3">
<h4 id="_importing_from_heinrichs_weikamp_ostc_tools">5.3.2. Importing from Heinrichs Weikamp OSTC Tools</h4>
<div class="paragraph"><p><em>OSTC Tools</em> is a Microsoft-based suite of dive download and dive management
tools for the OSTC family of dive computers. <em>OSTC Tools</em> downloads dive
data from the dive computer and stores it as a binary file with file
extension <em>.dive</em> . Subsurface can directly import these files when using
the universal import dialogue. From the dropdown list at the bottom right
select <em>All files</em>. This makes the <em>OSTC Tools</em> dive logs visible in the
file list panel. Select one or more dive, then click the <em>Open</em> button. The
OSTC dives are shown in the <strong>Dive List</strong> panel.</p></div>
</div>
<div class="sect3">
<h4 id="_importing_from_mares_dive_organiser_v2_1">5.3.3. Importing from Mares Dive Organiser V2.1</h4>
<div class="paragraph"><p>Since Mares utilise proprietary Windows software not compatible with
multi-platform applications, these dive logs cannot be directly imported
into <em>Subsurface</em>. Mares dive logs need to be imported using a three-step
process, using <em>www.divelogs.de</em> as a mechanism to extract the dive log
information.</p></div>
<div class="olist arabic"><ol class="arabic">
@ -1601,13 +1612,13 @@ Finally, import the dives from <em>divelogs.de</em> to <em>Subsurface</em>, usin
instructions below.
</p>
</li>
</ol></div>
</div>
<div class="sect3">
<h4 id="S_ImportingDivelogsDe">5.3.3. Importing dives from <strong>divelogs.de</strong></h4>
<div class="paragraph"><p>The import of dive information from <em>divelogs.de</em> is simple, using a single
dialogue box. The <em>Import &#8594; Import from Divelogs.de</em> option should be
selected from the Main Menu. This brings up a dialogue box (see figure on
</ol></div>
</div>
<div class="sect3">
<h4 id="S_ImportingDivelogsDe">5.3.4. Importing dives from <strong>divelogs.de</strong></h4>
<div class="paragraph"><p>The import of dive information from <em>divelogs.de</em> is simple, using a single
dialogue box. The <em>Import &#8594; Import from Divelogs.de</em> option should be
selected from the Main Menu. This brings up a dialogue box (see figure on
left [<strong>A</strong>] below). Enter a user-ID and password for <em>divelogs.de</em> into the
appropriate fields and then select the <em>Download</em> button. Download from
<em>divelogs.de</em> starts immediately, displaying a progress bar in the dialogue
@ -1618,13 +1629,13 @@ after which the imported dives appear in the <em>Subsurface</em> <strong>Dive Li
<div class="content">
<img src="images/Divelogs1.jpg" alt="FIGURE:Download from Divelogs.de" />
</div>
</div>
</div>
<div class="sect3">
<h4 id="S_ImportingCSVData">5.3.4. Importing data in CSV format</h4>
<div class="paragraph"><p>A comma-separated file (.csv) can be used to import dive information either
as dive profiles (as in the case of the APD Inspiration and Evolution closed
circuit rebreathers) or as dive metadata (in case the user keeps dive data
</div>
</div>
<div class="sect3">
<h4 id="S_ImportingCSVData">5.3.5. Importing data in CSV format</h4>
<div class="paragraph"><p>A comma-separated file (.csv) can be used to import dive information either
as dive profiles (as in the case of the APD Inspiration and Evolution closed
circuit rebreathers) or as dive metadata (in case the user keeps dive data
in a spreadsheet). The <em>CSV</em> format is a universal simplified format that
allows for easy information exchange between different computers or software
packages. For an introduction to CSV-formatted files see <a href="#S_CSV_Intro">A
@ -2372,21 +2383,84 @@ photos any more. If the display of photos is activated (using the toolbox
to the left of the <em>Dive Profile</em>), the program only shows a small white dot
where each photo should be on the dive profile. In addition the <em>Photos</em>
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.</p></div>
</div>
</div>
<div class="sect2">
<h3 id="_logging_special_types_of_dives">5.6. Logging special types of dives</h3>
later, the external drive with the photos is connected again, the photos can
be seen in the normal way.</p></div>
</div>
<div class="sect3">
<h4 id="Moving_images">5.5.5. Moving photographs among directories, hard disks or computers</h4>
<div class="paragraph"><p>After a photograph has been loaded into <em>Subsurface</em> and associated with a specific dive, the directory
where the photo lies is stored, allowing <em>Subsurface</em> 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, <em>Subsurface</em> 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, <em>Subsurface</em> has a mechanism that eases the
process of updating the directory information for each photo: automatic updates using fingerprints.</p></div>
<div class="paragraph"><p>When a photo is loaded into <em>Subsurface</em>, 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 <em>Subsurface</em>) to a different directory, disk or computer, <em>Subsurface</em> can perform the
following steps:</p></div>
<div class="ulist"><ul>
<li>
<p>
look through a particular directory (and all its subdirectories recursively)
where photos have been moved
to,
</p>
</li>
<li>
<p>
calculate fingerprints for all photos in this directory, and
</p>
</li>
<li>
<p>
if there is a match between a calculated fingerprint and the one originally
calculated when a photo was
loaded into <em>Subsurface</em> (even if the original file name has changed), to
automatically update the directory information so that <em>Subsurface</em> can find
the photo in the new moved directory.
</p>
</li>
</ul></div>
<div class="paragraph"><p>This is achieved by selecting from the Main Menu: <em>File &#8594; Find moved images</em>. This brings up a window within
which the NEW directory of the photos needs to be specified. Select the appropriate directory and click
the <em>Scan</em> button towards the bottom right of the panel. The process may require several minutes to
complete, after which <em>subsurface</em> will show the appropriate photographs when a particular dive is opened.</p></div>
<div class="sidebarblock" id="Image_fingerprint_upgrade">
<div class="content">
<div class="paragraph"><p><strong>Upgrading existing photo collections without fingerprints</strong></p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<img src="images/icons/important.png" alt="Important" />
</td>
<td class="content">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 <strong>Dive profile</strong> 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 <strong>Notes</strong> 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 <em>Notes</em> text box and immediately delete
that space character. Select the optio <em>Apply changes</em> in the blue edit bar
to save the dive information. Fingerprints are calculated while saving this
specific dive.</td>
</tr></table>
</div>
</div></div>
</div>
</div>
<div class="sect2">
<h3 id="_logging_special_types_of_dives">5.6. Logging special types of dives</h3>
<div class="sect3">
<h4 id="S_MulticylinderDives">5.6.1. Multicylinder dives</h4>
<div class="paragraph"><p><em>Subsurface</em> easily handles dives involving more than one
cylinder. Multicylinder diving usually happens (a) if a diver does not have
enough gas for the complete dive in a single cylinder; (b) if the diver
needs more than one gas mixture because of the depth or the decompression
needs of the dive. For this reason multicylinder dives are often used by
technical divers who dive deep or long. As far as <em>Subsurface</em> is concerned,
there are only two types of information that need to be provided:</p></div>
needs of the dive. For this reason multicylinder dives are often used by
technical divers who dive deep or long. As far as <em>Subsurface</em> is concerned,
there are only two types of information that need to be provided:</p></div>
<div class="ulist"><ul>
<li>
<p>
@ -2440,9 +2514,9 @@ steps:</p></div>
cylinders with air or with the same gas mixture, <em>Subsurface</em> distinguishes among these different
cylinders. In contrast, most dive computers that allow gas switching only distinguish among different
<em>gases</em> used, not among different <em>cylinders</em> used. This means that when sidemount dives are downloaded
from these dive computers, the events of switching between cylinders with the same gas are not downloaded. This may mean
that one may have to keep a written log of cylinder switch times using a slate, or (if the dive computer
has this facility) marking each cylinder switch with a bookmark that can be retrieved later. Returning
from these dive computers, the events of switching between cylinders with the same gas are not downloaded. This may mean
that one may have to keep a written log of cylinder switch times using a slate, or (if the dive computer
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.
</p>
</li>
@ -2471,9 +2545,9 @@ steps:</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/sidemount1.jpg" alt="FIGURE: Sidemount profile" />
</div>
</div>
<div class="paragraph"><p>This section gives an example of the versatility of <em>Subsurface</em> as a dive
</div>
</div>
<div class="paragraph"><p>This section gives an example of the versatility of <em>Subsurface</em> as a dive
logging tool.</p></div>
</div>
<div class="sect3">
@ -2529,9 +2603,9 @@ lasted over two hours.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<img src="images/APD.jpg" alt="Note" />
</td>
<td class="content">Closed system rebreathers use advanced technology to recirculate gas that
<img src="images/APD.jpg" alt="Note" />
</td>
<td class="content">Closed system rebreathers use advanced technology to recirculate gas that
has been breathed while doing two things to maintain a breathable oxygen
concentration:
a) remove carbon dioxide from the gas that has been exhaled
@ -3250,15 +3324,15 @@ Graph <strong>E</strong> indicates the situation after remaining at 4.5 meters f
</div>
<div class="sect1">
<h2 id="_organising_the_logbook_manipulating_groups_of_dives">7. Organising the logbook (Manipulating groups of dives)</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_the_dive_list_context_menu">7.1. The Dive List context menu</h3>
<div class="paragraph"><p>Many actions within <em>Subsurface</em> 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.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/ContextMenu.jpg" alt="Figure: Context Menu" />
<div class="sectionbody">
<div class="sect2">
<h3 id="_the_dive_list_context_menu">7.1. The Dive List context menu</h3>
<div class="paragraph"><p>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.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/ContextMenu.jpg" alt="Figure: Context Menu" />
</div>
</div>
<div class="paragraph"><p>The context menu is used in many manipulations described below.</p></div>
@ -3298,31 +3372,35 @@ automatically follow on because of the dives that are more recent in
date/time than the newly-added dive with an older date/time. Therefore, one
may sometimes need to renumber the dives. This is performed by selecting
(from the Main Menu) <em>Log &#8594; Renumber</em>. Users are 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
<strong>Dive List</strong> panel.</p></div>
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
<strong>Dive List</strong> panel.</p></div>
<div class="paragraph"><p>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.</p></div>
</div>
<div class="sect2">
<h3 id="S_Group">7.3. Grouping dives into trips and manipulating trips</h3>
<div class="paragraph"><p>For regular divers, the dive list can rapidly become very long. <em>Subsurface</em>
can group dives into <em>trips</em>. It performs this by grouping dives that have
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 (<strong>A</strong>, on the left) as well as the corresponding grouped
dive list comprising five dive trips (<strong>B</strong>, on the right):</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Group2.jpg" alt="Figure: Grouping dives" />
</div>
<div class="sect2">
<h3 id="S_Group">7.3. Grouping dives into trips and manipulating trips</h3>
<div class="paragraph"><p>For regular divers, the dive list can rapidly become very long. <em>Subsurface</em>
can group dives into <em>trips</em>. 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 (<strong>A</strong>, on the left) as well as the
corresponding grouped dive list comprising five dive trips (<strong>B</strong>, on the
right):</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Group2.jpg" alt="Figure: Grouping dives" />
</div>
</div>
<div class="paragraph"><p>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 <em>Log &#8594; Autogroup</em>. The <strong>Dive
List</strong> panel now shows only the titles for the trips.</p></div>
<div class="sect3">
<h4 id="_editing_the_title_and_associated_information_for_a_particular_trip">7.3.1. Editing the title and associated information for a particular trip</h4>
<div class="paragraph"><p>Normally, in the dive list, minimal information is included in the trip
</div>
<div class="paragraph"><p>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) select <em>Log &#8594; Autogroup</em>. The <strong>Dive List</strong> panel
now shows only the titles for the trips.</p></div>
<div class="sect3">
<h4 id="_editing_the_title_and_associated_information_for_a_particular_trip">7.3.1. Editing the title and associated information for a particular trip</h4>
<div class="paragraph"><p>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 <strong>Dive List</strong>. This shows a <strong>Trip Notes</strong> tab in the <strong>Notes</strong>
panel. Here users can add or edit information about the date/time, the trip
@ -3339,22 +3417,22 @@ information.</p></div>
trips by clicking the arrow-head on the left of each trip title. This
expands the selected trip, revealing the individual dives performed during
the trip.</p></div>
</div>
<div class="sect3">
<h4 id="_collapsing_or_expanding_dive_information_for_different_trips">7.3.3. Collapsing or expanding dive information for different trips</h4>
<div class="paragraph"><p>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.</p></div>
</div>
<div class="sect3">
<h4 id="_merging_dives_from_more_than_one_trip_into_a_single_trip">7.3.4. Merging dives from more than one trip into a single trip</h4>
<div class="paragraph"><p>By right-clicking on a selected trip title in the <strong>Dive List</strong> 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.</p></div>
</div>
<div class="sect3">
<h4 id="_splitting_a_single_trip_into_more_than_one_trip">7.3.5. Splitting a single trip into more than one trip</h4>
</div>
<div class="sect3">
<h4 id="_collapsing_or_expanding_dive_information_for_different_trips">7.3.3. Collapsing or expanding dive information for different trips</h4>
<div class="paragraph"><p>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.</p></div>
</div>
<div class="sect3">
<h4 id="_merging_dives_from_more_than_one_trip_into_a_single_trip">7.3.4. Merging dives from more than one trip into a single trip</h4>
<div class="paragraph"><p>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)</p></div>
</div>
<div class="sect3">
<h4 id="_splitting_a_single_trip_into_more_than_one_trip">7.3.5. Splitting a single trip into more than one trip</h4>
<div class="paragraph"><p>If a trip includes five dives, the user can split this trip into two trips
(trip 1: top 3 dives; trip 2: bottom 2 dives) by selecting and
right-clicking the top three dives. The resulting context menu allows the
@ -3381,31 +3459,31 @@ duration.</p></div>
</div>
<div class="sect3">
<h4 id="_unlink_a_dive_from_a_trip">7.4.2. Unlink a dive from a trip</h4>
<div class="paragraph"><p>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 <strong>Remove dive(s) from trip</strong>. The dive(s) now
appear immediately above the trip to which they belonged.</p></div>
</div>
<div class="sect3">
<h4 id="_add_a_dive_to_the_trip_immediately_above">7.4.3. Add a dive to the trip immediately above</h4>
<div class="paragraph"><p>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 <strong>Add dive(s) to trip immediately above</strong>.</p></div>
</div>
<div class="sect3">
<h4 id="_shift_the_start_time_of_dive_s">7.4.4. Shift the start time of dive(s)</h4>
<div class="paragraph"><p>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 <strong>Remove dive(s) from trip</strong>. 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.</p></div>
</div>
<div class="sect3">
<h4 id="_add_a_dive_to_the_trip_immediately_above">7.4.3. Add a dive to the trip immediately above</h4>
<div class="paragraph"><p>Selected dives can be moved from the trip to which they belong and placed
within a separate trip. To do this, select and right-click the dive(s) to
bring up the context menu, and then select <strong>Create new trip above</strong>.</p></div>
</div>
<div class="sect3">
<h4 id="_shift_the_start_time_of_dive_s">7.4.4. Shift the start time of dive(s)</h4>
<div class="paragraph"><p>Sometimes it is necessary to adjust the start time of a dive. This may apply
to situations where dives are performed in different time zones or when the
dive computer has an erroneous time. In order to do this, user must select
and right-click the dive(s) to be adjusted. This action brings up the
context menu on which the <strong>Shift times</strong> 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.</p></div>
</div>
<div class="sect3">
<h4 id="_merge_dives_into_a_single_dive">7.4.5. Merge dives into a single dive</h4>
context menu on which the <strong>Shift times</strong> 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 ealier or later.</p></div>
</div>
<div class="sect3">
<h4 id="_merge_dives_into_a_single_dive">7.4.5. Merge dives into a single dive</h4>
<div class="paragraph"><p>Sometimes a dive is briefly interrupted, e.g. if a diver returns to the
surface for a few minutes, resulting in two or more dives being recorded by
the dive computer and appearing as different dives in the <strong>Dive List</strong>
@ -3418,29 +3496,37 @@ dives that were merged:</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/MergedDive.png" alt="Example: Merged dive" />
</div>
</div>
</div>
</div>
<div class="sect2">
<h3 id="S_Filter">7.5. Filtering the dive list</h3>
</div>
</div>
</div>
<div class="sect3">
<h4 id="_undo_dive_manipulations">7.4.6. Undo dive manipulations</h4>
<div class="paragraph"><p>Important actions on dives or trips, described above, can be undone or
redone. This includes: <em>delete dives</em>, <em>merge dives</em>, <em>renumber dives</em> and
<em>shift dive times</em>. To do this after performing any of these actions, from
the <strong>Main Menu</strong> select <em>Edit</em>. This brings up the possibility to <em>Undo</em> or
<em>Redo</em> an action.</p></div>
</div>
</div>
<div class="sect2">
<h3 id="S_Filter">7.5. Filtering the dive list</h3>
<div class="paragraph"><p>The dives in the <strong>Dive List</strong> panel can be filtered, that is, one can select
only some of the dives based on their attributes, e.g. dive tags, dive site,
dive master, buddy or protective clothing. For instance, filtering allows
one to list the deep dives at a particular dive site, or otherwise the cave
dives with a particular buddy.</p></div>
<div class="paragraph"><p>To open the filter, select <em>Log &#8594; Filter divelist</em> from the main menu. This
opens the <em>Filter Panel</em> at the top of the <em>Subsurface</em> window. Three icons
are located at the top right hand of the filter panel. The <em>Filter Panel</em>
can be reset (i.e. all current filters cleared) by selecting the <strong>+</strong>. The
<em>Filter Panel</em> 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 <em>Filter
Panel</em> is shown in the figure below.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Filterpanel.jpg" alt="Figure: Filter panel" />
<div class="paragraph"><p>To open the filter, select <em>Log &#8594; Filter divelist</em> from the main menu. This
opens the <em>Filter Panel</em> at the top of the <em>Subsurface</em> window. Three icons
are located at the top right hand of the filter panel. The <em>Filter Panel</em>
can be reset (i.e. all current filters cleared) by selecting the <strong>yellow
angled arrow</strong>. The <em>Filter Panel</em> may also be minimised by selecting the
<strong>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</strong> with the
white cross. An example of the <em>Filter Panel</em> is shown in the figure below.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Filterpanel.jpg" alt="Figure: Filter panel" />
</div>
</div>
<div class="paragraph"><p>Four filter criteria may be used to filter the dive list: dive tags, person
@ -3448,20 +3534,19 @@ Panel</em> is shown in the figure below.</p></div>
by a check list with check boxes. Above each check list is a second-level
filter tool, allowing the listing of only some of the attributes within that
check list. For instance, typing "<em>ca</em>" in the filter textbox above the tags
check list results in the tags check list being reduced to "<em>cave</em>" and
"<em>cavern</em>". Filtering of the check list enables the rapid finding of search
terms for filtering the dive list.</p></div>
<div class="paragraph"><p>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
<em>AND</em> operators, Subsurface filters therefore for <em>cave</em> as a tag AND <em>Joe
Smith</em> as a buddy; but the filters within a category are inclusive -
filtering for <em>cave</em> and <em>boat</em> shows those dives that have either one or
both of these tags.</p></div>
</div>
</div>
</div>
check list results in the tags check list being reduced to "<em>cave</em>" and
"<em>cavern</em>". Filtering of the check list enables the rapid finding of search
terms for filtering the dive list.</p></div>
<div class="paragraph"><p>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 <em>AND</em> operators, Subsurface filters
therefore for <em>cave</em> as a tag AND <em>Joe Smith</em> as a buddy; but the filters
within a category are inclusive - filtering for <em>cave</em> and <em>boat</em> shows
those dives that have either one OR both of these tags.</p></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="S_ExportLog">8. Exporting the dive log or parts of the dive log</h2>
<div class="sectionbody">
@ -3975,13 +4060,13 @@ the dive profile:
<p>
<em>Show average depth</em>: Activating this checkbox causes <em>Subsurface</em> 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
ascent.
</p>
<div class="ulist"><ul>
<li>
<p>
<strong>Misc</strong>:
that dive. Normally this is a u-shaped line indicating the deepest average depth just before the
ascent.
</p>
<div class="ulist" id="GradientFactors_Ref"><ul>
<li>
<p>
<strong>Misc</strong>:
</p>
</li>
</ul></div>
@ -4191,18 +4276,18 @@ messages about the dive plan are printed.</p></div>
<div class="content">
<img src="images/PlannerWindow1_f20.jpg" alt="FIGURE: Dive planner startup window" />
</div>
</div>
</div>
<div class="sect2">
<h3 id="_open_circuit_dives_as_an_example_of_dive_planning">13.2. Open circuit dives as an example of dive planning</h3>
<div class="ulist"><ul>
<li>
<p>
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:
</p>
<div class="ulist"><ul>
<li>
</div>
</div>
<div class="sect2">
<h3 id="_open_circuit_dives">13.2. Open circuit dives</h3>
<div class="ulist"><ul>
<li>
<p>
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:
</p>
<div class="ulist"><ul>
<li>
<p>
Open Circuit (the default)
</p>
@ -4218,17 +4303,22 @@ pSCR
</p>
</li>
</ul></div>
</li>
<li>
<p>
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.
</p>
</li>
<li>
</li>
<li>
<p>
Choose the Open Circuit option.
</p>
</li>
<li>
<p>
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
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.
</p>
</li>
<li>
<p>
In the table labeled <em>Available Gases</em>, add the information of the cylinders
to be used as well as the gas composition within that cylinder. This is done
@ -4239,18 +4329,133 @@ In the table labeled <em>Available Gases</em>, add the information of the cylind
the boxes provided in this dialogue. Add additional cylinders by using the
"+" icon to the top righthand of the dialogue.
</p>
</li>
<li>
<p>
The dialogue indicating <em>Dive Planner Points</em> is usually not used at this
stage of the dive planning.
</p>
</li>
</ul></div>
<div class="paragraph"><p><strong>The planning is performed in three stages</strong></p></div>
<div class="paragraph"><p><strong>a) Nitrogen management</strong>: This is performed by specifying the rates for descent and ascent,
as well as the gradient factors (GFLow and GFHigh) under the headings <em>Rates</em> and <em>Planning</em>
to the bottom left of the planning screen. Initially, the GFHigh and GFLow values in the <em>Preferences</em>
</li>
<li>
<p>
The profile of the planned dive can be created in two ways:
</p>
<div class="ulist"><ul>
<li>
<p>
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 <em>delete</em> item from
the resulting context menu.
</p>
</li>
<li>
<p>
The most efficient way to create a dive profile is to enter the appropriate
values into the table marked <em>Dive planner points</em>. 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 <em>CC
set point</em> 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 <em>Dive planner
points</em> table automatically appear in the <strong>Dive Profile</strong> diagram.
</p>
</li>
</ul></div>
</li>
</ul></div>
<div class="sect3">
<h4 id="_recreational_dives">13.2.1. Recreational dives</h4>
<div class="paragraph"><p>The <em>Subsurface</em> 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 <em>Subsurface</em> 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 <em>credit</em> 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 <em>Subsurface</em> before performing dive planning.</p></div>
<div class="paragraph"><p>To plan a dive, the appropriate settings need to be defined.</p></div>
<div class="paragraph"><p>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.</p></div>
<div class="ulist"><ul>
<li>
<p>
Immediately under the heading <em>Planning</em> are two checkboxes <em>Recreational</em>
and <em>Safety Stop</em>. Check these two boxes.
</p>
</li>
<li>
<p>
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
<em>Available gases</em>.
</p>
</li>
<li>
<p>
The planner calculates whether the specified cylinder contains enough
air/gas to complete the planned dive. In order for this to be realistic,
under <em>Gas options</em>, specify an appropriate surface air consumption (SAC)
rate for <em>Bottom SAC</em>. Suitable values are between 15 l/min and 30 l/min,
with novice divers or difficult dives requiring SAC rates closer to 30l/min.
</p>
</li>
<li>
<p>
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.
</p>
</li>
<li>
<p>
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 <em>Dive planner points</em> 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 <em>Dive Planner Points</em> table.
</p>
</li>
<li>
<p>
The ascent speed can be changed. The default ascent speeds are those
considered safe for recreational divers.
</p>
</li>
</ul></div>
<div class="paragraph"><p>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 <em>Subsurface</em> 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
<em>Available gases</em>. 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.</p></div>
<div class="paragraph"><p>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.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/rec_diveplan.jpg" alt="FIGURE: A recreational dive plan: setup" />
</div>
</div>
</div>
<div class="sect3">
<h4 id="_non_recreational_open_circuit_dives_including_decompression">13.2.2. Non-recreational open circuit dives, including decompression</h4>
<div class="paragraph"><p>Non-recreational dive planning involves exceeding the no-deco limits and/or
using multiple breathing gases. Such dives are planned in three stages:</p></div>
<div class="paragraph"><p><strong>a) Nitrogen management</strong>: This is performed by specifying the rates for descent and ascent,
as well as the gradient factors (GFLow and GFHigh) under the headings <em>Rates</em> and <em>Planning</em>
to the bottom left of the planning screen. Initially, the GFHigh and GFLow values in the <em>Preferences</em>
panel of <em>Subsurface</em> is used. If these are changed within the planner (see <em>Gas Options</em> within
the planner), the new values are
used without changing the original values in the <em>Preferences</em>. Gradient Factor settings strongly affect the calculated ceilings and their depths.
@ -4368,14 +4573,36 @@ information.</p></div>
<div class="paragraph"><p>If the option <em>Display segment duration</em> is checked, then the duration of
each depth level is indicated in the <em>Dive Plan Details</em>. This duration
INCLUDES the transition time to get to that level. However, if the <em>Display
transition in deco</em> option is checked, the transitions are shown separately
from the segment durations at a particular level.</p></div>
</div>
<div class="sect2">
<h3 id="_planning_ccr_dives">13.3. Planning CCR dives</h3>
<div class="paragraph"><p>To plan a dive using a closed circuit rebreather, select the <em>CCR</em> option in
the dropdown list, circled in blue in the image below.</p></div>
<div class="paragraph"><p><strong>Available gases</strong>: In the <em>Available gases</em> table, enter the cylinder information for the
transition in deco</em> option is checked, the transitions are shown separately
from the segment durations at a particular level.</p></div>
</div>
</div>
<div class="sect2">
<h3 id="_planning_pscr_dives">13.3. Planning pSCR dives</h3>
<div class="paragraph"><p>To plan a dive using a passive semi-closed rebreather (pSCR), select <em>pSCR</em> rather than
<em>Open circuit</em> in the dropdown list.
The parameters of the pSCR diver can be set by selecting <em>File &#8594; Preferences &#8594; Graph</em>
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<sub>2</sub> drops below what is considered a save value, a warning appears in the <em>Dive plan
details</em>. A typical pSCR configuration is with a single cylinder and one or more bail-out
cylinders. Therefore the setup of the <em>Available gases</em> and the <em>Dive planner points</em> 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.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Planner_pSCR1_f20.jpg" alt="FIGURE: Planning a pSCR dive: setup" />
</div>
</div>
</div>
<div class="sect2">
<h3 id="_planning_ccr_dives">13.4. Planning CCR dives</h3>
<div class="paragraph"><p>To plan a dive using a closed circuit rebreather, select the <em>CCR</em> option in
the dropdown list, circled in blue in the image below.</p></div>
<div class="paragraph"><p><strong>Available gases</strong>: In the <em>Available gases</em> table, enter the cylinder information for the
diluent cylinder and for any bail-out cylinders. Do NOT enter the information for the oxygen
cylinder since it is implied when the <em>CCR</em> dropdown selection is made.</p></div>
<div class="paragraph"><p><strong>Entering setpoints</strong>: Specify a default setpoint in the Preferences tab, by selecting <em>File &#8594; Preferences &#8594; Graph</em> from the main menu. All user-entered segments in the <em>Dive planner points</em> table
@ -4392,33 +4619,12 @@ algorithm does not switch deco-gases automatically while in CCR mode (i.e. when
</div>
</div>
<div class="paragraph"><p>Note that, in the <em>Dive plan details</em>, the gas consumption for a CCR segment
is not calculated, so gas consumptions of 0 litres are the norm.</p></div>
</div>
<div class="sect2">
<h3 id="_planning_pscr_dives">13.4. Planning pSCR dives</h3>
<div class="paragraph"><p>To plan a dive using a passive semi-closed rebreather (pSCR), select <em>pSCR</em> rather than
<em>Open circuit</em> in the dropdown list.
The parameters of the pSCR diver can be set by selecting <em>File &#8594; Preferences &#8594; Graph</em>
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<sub>2</sub> drops below what is considered a save value, a warning appears in the <em>Dive plan
details</em>. A typical pSCR configuration is with a single cylinder and one or more bail-out
cylinders. Therefore the setup of the <em>Available gases</em> and the <em>Dive planner points</em> 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.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Planner_pSCR1_f20.jpg" alt="FIGURE: Planning a pSCR dive: setup" />
</div>
</div>
</div>
<div class="sect2">
<h3 id="S_Replan">13.5. Modifying an existing dive plan</h3>
<div class="paragraph"><p>Normally, when a dive plan has been saved, it is accessible from the <strong>Dive
List</strong>, like any other dive log. Within the <strong>Dive List</strong> there is not a way to
is not calculated, so gas consumptions of 0 litres are the norm.</p></div>
</div>
<div class="sect2">
<h3 id="S_Replan">13.5. Modifying an existing dive plan</h3>
<div class="paragraph"><p>Normally, when a dive plan has been saved, it is accessible from the <strong>Dive
List</strong>, like any other dive log. Within the <strong>Dive List</strong> there is not a way to
change a saved dive plan. To perform changes to a dive plan, select it on
the <strong>Dive List</strong>. Then, in the main menu, select <em>Log &#8594; Re-plan dive</em>. This
will open the selected dive plan within the dive planner, allowing changes
@ -5257,14 +5463,14 @@ Within the list of dives, select the dives you would like to import later:
<p>
To select certain dives: hold <em>ctrl</em> and click the dive
</p>
</li>
<li>
<p>
To select all dives: Select the first dive, hold down shift and
select the last dive
</p>
</li>
</ul></div>
</li>
<li>
<p>
To select all dives: Select the first dive, hold down shift and select the
last dive
</p>
</li>
</ul></div>
</li>
<li>
<p>
@ -5678,14 +5884,14 @@ dives, when you may stay in the water for a long time, but spend most of it
at the surface. And then you don&#8217;t want that to count as some kind of long
dive”.</p></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
Last updated 2015-02-20 09:40:45 CET
Last updated 2015-05-18 11:34:51 CEST
</div>
</div>
</body>
</html>
</html>

302
Documentation/user-manual_fr.txt
View file

@ -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
@ -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
@ -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,23 +2416,28 @@ 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
@ -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
@ -2462,6 +2533,15 @@ 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
@ -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
@ -2998,19 +3078,20 @@ 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.
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
@ -3022,10 +3103,96 @@ image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window", alig
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 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.
*The planning is performed in three stages*
==== 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_
@ -3055,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_).
@ -3152,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
@ -3176,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 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
@ -3717,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'.