aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/user-manual_fr.html.git
diff options
context:
space:
mode:
authorGravatar Guillaume GARDET <guillaume.gardet@free.fr>2015-09-08 10:38:20 +0200
committerGravatar Dirk Hohndel <dirk@hohndel.org>2015-09-08 09:55:56 -0700
commit33831162f1c5a175fcef60bf6099df7d9c3cb7b6 (patch)
tree79bda73089358bde19309c39f63583eba30159f3 /Documentation/user-manual_fr.html.git
parenta29f897125878e25e3d47b98d499a68970154004 (diff)
downloadsubsurface-33831162f1c5a175fcef60bf6099df7d9c3cb7b6.tar.gz
Documentation: update french translation of user-manual
Signed-off-by: Guillaume GARDET <guillaume.gardet@free.fr> Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
Diffstat (limited to 'Documentation/user-manual_fr.html.git')
-rw-r--r--Documentation/user-manual_fr.html.git1310
1 files changed, 712 insertions, 598 deletions
diff --git a/Documentation/user-manual_fr.html.git b/Documentation/user-manual_fr.html.git
index b9f692c61..cb9b70799 100644
--- a/Documentation/user-manual_fr.html.git
+++ b/Documentation/user-manual_fr.html.git
@@ -404,9 +404,9 @@ asciidoc.install(3);
<div id="content">
<div class="imageblock" style="text-align:center;">
<div class="content">
-<img src="images/Subsurface4Banner.jpg" alt="Banner" />
-</div>
-</div>
+<img src="images/Subsurface4Banner.jpg" alt="Banner" />
+</div>
+</div>
<div class="paragraph"><p><span class="big">MANUEL UTILISATEUR</span></p></div>
<div class="paragraph"><p><strong>Auteurs du manuel</strong> : Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg,
Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Pedro Neves</p></div>
@@ -414,9 +414,9 @@ Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Ped
<div class="paragraph"><p>Bienvenue en tant qu&#8217;utilisateur de <em>Subsurface</em>, un programme avancé
d&#8217;enregistrement de plongées (carnet de plongées) avec une bonne
infrastructure pour décrire, organiser, interpréter et imprimer des plongées
-en scaphandre et en apnée. <em>Subsurface</em> offre de nombreux avantages par
-rapport à d&#8217;autres solutions logicielles similaires :</p></div>
-<div class="ulist"><ul>
+en scaphandre et en apnée. <em>Subsurface</em> offre de nombreux avantages par
+rapport à d&#8217;autres solutions logicielles similaires :</p></div>
+<div class="ulist"><ul>
<li>
<p>
Avez-vous besoin d&#8217;une façon d&#8217;enregistrer vos plongées utilisant des
@@ -496,9 +496,9 @@ utilisateurs de la meilleur manière qu&#8217;il soit, il est important d&#8217;
informations sur les utilisateurs. À l&#8217;ouverture de <em>Subsurface</em> après avoir
utilisé le logiciel pendant une semaine environ, une fenêtre de sondage
apparait. Cela est complètement optionnel et l&#8217;utilisateur contrôle quelles
-informations sont envoyées ou non à l'équipe de développement de
-<em>Subsurface</em>. Toutes les données que l&#8217;utilisateur choisit d&#8217;envoyer sont
-extrêmement utiles et ne seront utilisées que pour les futures
+informations sont envoyées ou non à l'équipe de développement de
+<em>Subsurface</em>. Toutes les données que l&#8217;utilisateur choisit d&#8217;envoyer sont
+extrêmement utiles et ne seront utilisées que pour les futures
développements et modifications du logiciel pour coller au mieux aux besoins
des utilisateurs de <em>Subsurface</em>. Si vous complétez le sondage ou cliquez
sur l&#8217;option pour ne plus être sondé, cela devrait être la dernière
@@ -527,9 +527,9 @@ plongée sélectionnée dans la <strong>liste des plongées</strong>.</p></div>
<div class="paragraph"><p>Les <strong>informations</strong> en haut à gauche, fournissent des informations détaillées
sur la plongée sélectionnée dans la <strong>liste des plongées</strong>, dont des
statistiques pour la plongée sélectionnée ou pour toutes les plongées mises
-en surbrillance.</p></div>
-<div class="paragraph"><p>Le <strong>profil de plongée</strong> en haut à droite, affiche un profil de plongée
-graphique de la plongée sélectionnée dans la <strong>liste des plongées</strong>.</p></div>
+en surbrillance.</p></div>
+<div class="paragraph"><p>Le <strong>profil de plongée</strong> en haut à droite, affiche un profil de plongée
+graphique de la plongée sélectionnée dans la <strong>liste des plongées</strong>.</p></div>
<div class="paragraph"><p>Les séparateurs entre ces panneaux peuvent être déplacés pour modifier la
taille de chaque panneau. <em>Subsurface</em> mémorise la position de ces
séparateurs, pour qu&#8217;au prochain lancement <em>Subsurface</em> utilise ces
@@ -574,9 +574,9 @@ carnet de plongée sera détaillée.</p></div>
<div class="sectionbody">
<div class="paragraph"><p>Sélectionner <em>Fichier &#8594; Nouveau carnet de plongée</em> à partir du menu
principal. Toutes les données de plongées sont effacées pour que de
-nouvelles puissent être ajoutées. S&#8217;il existe des données non encore
-enregistrées dans le carnet ouvert, l&#8217;utilisateur devra sélectionner s&#8217;il
-faut les enregistrer ou non avant de créer le nouveau carnet.</p></div>
+nouvelles puissent être ajoutées. S&#8217;il existe des données non encore
+enregistrées dans le carnet ouvert, l&#8217;utilisateur devra sélectionner s&#8217;il
+faut les enregistrer ou non avant de créer le nouveau carnet.</p></div>
</div>
</div>
<div class="sect1">
@@ -642,9 +642,9 @@ Importer à partir d&#8217;un tableur ou de fichiers CSV contenant les profils d
<div class="paragraph"><p>This is usually the approach for dives without a dive computer. The basic
record of information within <em>Subsurface</em> is a dive. The most important
information in a simple dive logbook usually includes dive type, date, time,
-duration, depth, the names of your dive buddy and of the dive master or dive
-guide, and some remarks about the dive. <em>Subsurface</em> can store much more
-information than this for each dive. In order to add a dive to a dive log,
+duration, depth, the names of your dive buddy and of the dive master or dive
+guide, and some remarks about the dive. <em>Subsurface</em> can store much more
+information than this for each dive. In order to add a dive to a dive log,
select <em>Log &#8594; Add Dive</em> from the Main Menu. The program then shows three
panels to enter information for a dive: two tabs in the <strong>Info</strong> panel
(<strong>Notes</strong> and <strong>Equipment</strong>), as well as the <strong>Dive Profile</strong> panel that displays
@@ -735,17 +735,16 @@ e.g. N30° 13' 29.8" , E30° 49' 1.5" Decimal degrees, e.g. 30.22496 ,
</ol></div>
<div class="paragraph"><p>Southern hemisphere latitudes are given with a <strong>S</strong>, e.g. S30°, or with a
negative value, e.g. -30.22496. Similarly western longitudes are given with
-a <strong>W</strong>, e.g. W07°, or with a negative value, e.g. -7.34323.</p></div>
-<div class="paragraph"><p>Some keyboards don&#8217;t have the degree sign (°). It can be replaced by a d
-like that: N30d W20d.</p></div>
-<div class="paragraph"><p>Please note that GPS coordinates of a dive site are linked to the Location
-name - so adding coordinates to dives that do not have a location
-description will cause unexpected behaviour (Subsurface will think that all
-of these dives have the same location and try to keep their GPS coordinates
-the same).</p></div>
-<div class="paragraph"><p><strong>Dive mode</strong>: This is a dropdown box allowing one to choose the type of dive
-performed. The options are OC (Open Circuit, the default setting, meant for most recreational dives),
-Freedive (dive without SCUBA equipment), CCR (Closed-circuit
+a <strong>W</strong>, e.g. W07°, or with a negative value, e.g. -7.34323.</p></div>
+<div class="paragraph"><p>Some keyboards don&#8217;t have the degree sign (°). It can be replaced by a d
+like that: N30d W20d.</p></div>
+<div class="paragraph"><p>Note that GPS coordinates of a dive site are linked to the Location name -
+so adding coordinates to dives that do not have a location description will
+cause unexpected behaviour (Subsurface will think that all of these dives
+have the same location and try to keep their GPS coordinates the same).</p></div>
+<div class="paragraph"><p><strong>Dive mode</strong>: This is a dropdown box allowing one to choose the type of dive
+performed. The options are OC (Open Circuit, the default setting, meant for most recreational dives),
+Freedive (dive without SCUBA equipment), CCR (Closed-circuit
rebreather) and pSCR (Passive semi-closed rebreather).</p></div>
<div class="paragraph"><p><strong>Divemaster</strong>: The name of the dive master or dive guide for this dive can be
entered here.
@@ -925,9 +924,9 @@ EAN50.</p></div>
the <strong>Dive Profile</strong> can now be saved in the user&#8217;s logbook by using the two
buttons on the top right hand of the Notes tab. If the <em>Save</em> button is
clicked, the dive data are saved in the current logbook. If the <em>Cancel</em>
-button is clicked, the newly entered dive data are discarded. When exiting
-<em>Subsurface</em>, the user will be prompted once more to save the logbook with
-the new dive(s).</p></div>
+button is clicked, the newly entered dive data are discarded. When exiting
+<em>Subsurface</em>, the user will be prompted once more to save the logbook with
+the new dive(s).</p></div>
</div>
</div>
<div class="sect2">
@@ -935,9 +934,9 @@ the new dive(s).</p></div>
<div class="sect3">
<h4 id="_connecting_and_importing_data_from_a_dive_computer">5.2.1. Connecting and importing data from a dive computer.</h4>
<div class="paragraph"><p>The use of dive computers allows the collection of a large amount of
-information about each dive, e.g. a detailed record of depth, duration,
-rates of ascent/descent and of gas partial pressures. <em>Subsurface</em> can
-capture this information and present it as part of the dive information,
+information about each dive, e.g. a detailed record of depth, duration,
+rates of ascent/descent and of gas partial pressures. <em>Subsurface</em> can
+capture this information and present it as part of the dive information,
using dive information from a wide range of dive computers. The latest list
of supported dive computers can be found at:
<a href="http://subsurface-divelog.org/documentation/supported-dive-computers/">
@@ -1490,9 +1489,9 @@ If one hovers using the mouse over the red bookmark, the appropriate text is
saved by using the two buttons on the top right hand of the <strong>Notes</strong> tab. If
the <em>Save</em> button is clicked, the dive data are saved. If the <em>Cancel</em>
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 <em>Subsurface</em> there is a final prompt to confirm that the new data
-should be saved.</p></div>
+the dive profile obtained from the dive computer will be retained. When the
+user exits <em>Subsurface</em> there is a final prompt to confirm that the new data
+should be saved.</p></div>
</div>
</div>
<div class="sect2">
@@ -1500,9 +1499,9 @@ should be saved.</p></div>
<div class="paragraph" id="S_ImportingAlienDiveLogs"><p>If a user has been diving for some time, it is possible that several dives
were logged using other dive log software. This information does not need
retyping because these dive logs can probably be imported into
-<em>Subsurface</em>. <em>Subsurface</em> will import dive logs from a range of other dive
-log software. While some software is supported natively, for others the user
-has to export the logbook(s) to an intermediate format so that they can then
+<em>Subsurface</em>. <em>Subsurface</em> will import dive logs from a range of other dive
+log software. While some software is supported natively, for others the user
+has to export the logbook(s) to an intermediate format so that they can then
be imported by <em>Subsurface</em>. Currently, <em>Subsurface</em> supports importing CSV
log files from several sources. APD LogViewer, XP5, Sensus and Seabear
files are preconfigured, but because the import is flexible, users can
@@ -1564,9 +1563,9 @@ JDiveLog
</li>
<li>
<p>
-Suunto Dive Manager (DM3 and DM4)
-</p>
-</li>
+Suunto Dive Manager (DM3 and DM4)
+</p>
+</li>
<li>
<p>
CSV (text-based and spreadsheet-based) dive logs, including APD CCR logs
@@ -1611,13 +1610,13 @@ The dive log data from Mares Dive Organiser need to be exported to the
user&#8217;s desktop, using a <em>.sdf</em> file name extension. Refer to
<a href="#Mares_Export">Appendix C</a> for more information.
</p>
-</li>
-<li>
-<p>
+</li>
+<li>
+<p>
Data should then be imported into <em>www.divelogs.de</em>. One needs to create a
- user account in <em>www.divelogs.de</em>, log into that web site, then select
- <em>Import Logbook &#8594; Dive Organiser</em> from the menu on the left hand side. The
- instructions must be carefully followed to transfer the dive information (in
+ user account in <em>www.divelogs.de</em>, log into that web site, then select
+ <em>Import Logbook &#8594; Dive Organiser</em> from the menu on the left hand side. The
+ instructions must be carefully followed to transfer the dive information (in
<em>.sdf</em> format) from the Dive Organiser database to <em>www.divelogs.de</em>.
</p>
</li>
@@ -1664,9 +1663,9 @@ information that may be helpful for importing spreadsheet-based data into
<div class="paragraph"><p>One can view a <em>CSV</em> file by using an ordinary text editor. It is normally
organised into a single line that provides the headers (or <em>field names</em> or
<em>column headings</em>) of the data columns, followed by the data, one record per
-line.</p></div>
-<div class="paragraph"><p>There are two types of <em>CSV</em> dive logs that can be imported into
-<em>Subsurface</em>:</p></div>
+line.</p></div>
+<div class="paragraph"><p>There are two types of <em>CSV</em> dive logs that can be imported into
+<em>Subsurface</em>:</p></div>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
@@ -2386,9 +2385,9 @@ window. A photo can be deleted from the <em>Photos</em> panel by selecting it
removes the photo both from the <em>Photos</em> tab as well as the dive profile.</p></div>
</div>
<div class="sect3">
-<h4 id="_photos_on_an_external_hard_disk">5.5.4. Photos on an external hard disk</h4>
-<div class="paragraph"><p>Most underwater photographers store their photos on an external drive. If
-such a drive can be mapped (almost always the case) the photos can be
+<h4 id="_photos_on_an_external_hard_disk">5.5.4. Photos on an external hard disk</h4>
+<div class="paragraph"><p>Most underwater photographers store their photos on an external drive. If
+such a drive can be mapped (almost always the case) the photos can be
directly accessed by <em>Subsurface</em>. This facilitates the interaction between
<em>Subsurface</em> and an external repository of photos. When associating a dive
profile with photos from an external drive, the normal procedure of
@@ -2541,16 +2540,16 @@ steps:</p></div>
specifications of the different cylinders, using the <strong>Equipment</strong> tab of the <strong>Info Panel</strong> (see
image below where two 12 litre cylinder were used).
</p>
-</li>
-<li>
-<p>
+</li>
+<li>
+<p>
<strong>Indicate cylinder change events on the <em>Subsurface</em> dive profile</strong>. Once the dive log has been imported
from a dive computer into <em>Subsurface</em>, the cylinder switch events need to be indicated on the dive profile.
Cylinder changes are recorded by right-clicking at the appropriate point on the dive profile and then
selecting <em>Add gas change</em>. A list of the appropriate cylinders is shown with the
- currently used cylinder greyed out. In the image below Tank 1 is greyed out, leaving only Tank 2
- to be selected. Select the appropriate cylinder. The cylinder change is then indicated on the dive
- profile with a cylinder symbol. If the <strong>Tank Bar</strong> is activated using the toolbar to the left of the
+ currently used cylinder greyed out. In the image below Tank 1 is greyed out, leaving only Tank 2
+ to be selected. Select the appropriate cylinder. The cylinder change is then indicated on the dive
+ profile with a cylinder symbol. If the <strong>Tank Bar</strong> 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 in the image below.
@@ -2624,35 +2623,36 @@ lasted over two hours.</p></div>
has been breathed while doing two things to maintain a breathable oxygen
concentration:
a) remove carbon dioxide from the gas that has been exhaled
-regulate the oxygen concentration to remain within safe diving limits.
-Currently, within <em>Subsurface</em>, the Poseidon MkVI Discovery is the best
-supported CCR dive computer. The CCR interface of <em>Subsurface</em> is currently
-experimental and under active development. In contrast to a conventional
+regulate the oxygen concentration to remain within safe diving limits. The
+CCR interface of <em>Subsurface</em> is currently experimental and under active
+development. Subsurface currently supports Poseidon MkVI and APD
+Discovery/Evolution dive computers. In contrast to a conventional
recreational dive computer, a CCR system computer does not allow the
download of a log containing multiple dives. Rather, each dive is stored
-independently. This means that <em>Subsurface</em> cannot download a dive log
-directly from a CCR dive computer, but that it imports CCR dive logs in the
-same way that it imports dive log data from other digital databases.</td>
-</tr></table>
-</div>
-<div class="sect4">
+independently. This means that <em>Subsurface</em> cannot download a dive log
+directly from a CCR dive computer, but that it imports CCR dive logs in the
+same way that it imports dive log data from other digital databases: one
+dive at a time.</td>
+</tr></table>
+</div>
+<div class="sect4">
<h5 id="_import_a_ccr_dive">Import a CCR dive</h5>
<div class="paragraph"><p>See the section dealing with <a href="#S_ImportingAlienDiveLogs">Importing dive
information from other digital sources</a>. From the main menu of <em>Subsurface</em>,
-select <em>Import &#8594; Import log files</em> to bring up the
-<a href="#Unified_import">universal import dialogue</a>. As explained in that
-section, the bottom right hand of the import dialogue contains a dropdown
-list of appropriate devices that currently includes an option for (Poseidon)
-MkVI files (import for other CCR equipment is under active
-development). Having selected the appropriate CCR format and the directory
-where the original dive logs have been stored from the CCR dive computer,
-one can select a particular dive log file (in the case of the MkVI it is a
-file with a .txt extension). After selecting the appropriate dive log,
-activate the <em>Open</em> button at the bottom right hand of the universal import
-dialogue.</p></div>
-</div>
-<div class="sect4">
-<h5 id="_displayed_information_for_a_ccr_dive">Displayed information for a CCR dive</h5>
+select <em>Import &#8594; Import log files</em> to bring up the
+<a href="#Unified_import">universal import dialogue</a>. As explained in that
+section, the bottom right hand of the import dialogue contains a dropdown
+list (labled <em>Filter:</em>) of appropriate devices that currently
+includes(Poseidon) MkVI or APD log viewer files (import for other CCR
+equipment is under active development). Having selected the appropriate CCR
+format and the directory where the original dive logs have been stored from
+the CCR dive computer, one can select a particular dive log file (in the
+case of the MkVI it is a file with a .txt extension). After selecting the
+appropriate dive log, activate the <em>Open</em> button at the bottom right hand of
+the universal import dialogue. See the section below for</p></div>
+</div>
+<div class="sect4">
+<h5 id="_displayed_information_for_a_ccr_dive">Displayed information for a CCR dive</h5>
<div class="paragraph"><p><em>Partial pressures of gases</em>: The graph of oxygen partial pressure shows the
information from the oxygen sensors of the CCR equipment. In contrast to
recreational equipment (where pO<sub>2</sub> values are calculated based on gas
@@ -2685,26 +2685,26 @@ If no sensor data is available, the pO<sub>2</sub> value is assumed to be equal
</ul></div>
<div class="paragraph"><p>The mean pO<sub>2</sub> of the sensors is indicated with a green line,</p></div>
<div class="paragraph"><p>The oxygen setpoint values as well as the readings from the individual
-oxygen sensors can be shown. The display of additional CCR information is
-turned on by checking the appropriate checkboxes in the <em>Preferences</em> panel
-(accessible by selecting <a href="#S_CCR_options"><em>File &#8594; Preferences &#8594;
-Graph</em></a>). This part of the <em>Preferences</em> panel look like this, representing
-two checkboxes that modify the display of pO<sub>2</sub> when the appropriate toolbar
-button on the Dive Profile has been activated.</p></div>
-<div class="imageblock" style="text-align:center;">
-<div class="content">
-<img src="images/CCR_preferences_f20.jpg" alt="FIGURE: CCR preferences panel" />
-</div>
-</div>
-<div class="paragraph"><p>Checking any of the check boxes allows the display of additional
-oxygen-related information whenever the pO<sub>2</sub> toolbar button on the
-<em>Profile</em> panel is activated. The first checkbox allows the display of
-setpoint information. This is a red line superimposed on the green oxygen
-partial pressure graph and allows a comparison of the mean measured oxygen
-partial pressure and the setpoint values, as in the image below.</p></div>
-<div class="imageblock" style="text-align:center;">
-<div class="content">
-<img src="images/CCR_setpoint_f20.jpg" alt="FIGURE: CCR setpoint and po2 graph" />
+oxygen sensors can be shown. The display of additional CCR information is
+turned on by checking the appropriate checkboxes in the <em>Preferences</em> panel
+(accessible by selecting <a href="#S_CCR_options"><em>File &#8594; Preferences &#8594;
+Graph</em></a>). This part of the <em>Preferences</em> panel is shown in the image below,
+representing two checkboxes that modify the display of pO<sub>2</sub> when the
+appropriate toolbar button on the Dive Profile has been activated.</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/CCR_preferences_f20.jpg" alt="FIGURE: CCR preferences panel" />
+</div>
+</div>
+<div class="paragraph"><p>Checking any of these check boxes allows the display of additional
+oxygen-related information whenever the pO<sub>2</sub> toolbar button on the
+<em>Profile</em> panel is activated. The first checkbox allows the display of
+setpoint information. This is a red line superimposed on the green oxygen
+partial pressure graph and allows a comparison of the mean measured oxygen
+partial pressure and the setpoint values, as shown below.</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/CCR_setpoint_f20.jpg" alt="FIGURE: CCR setpoint and po2 graph" />
</div>
</div>
<div class="paragraph"><p>The second checkbox allows the display of the data from each individual
@@ -2749,20 +2749,37 @@ addition, start and end pressures for both oxygen and diluent cylinders are
shown in the <em>Equipment Tab</em>. Below is a dive profile for a CCR dive,
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.</p></div>
-<div class="imageblock" style="text-align:center;">
-<div class="content">
-<img src="images/CCR_dive_profile_f20.jpg" alt="FIGURE: CCR dive profile" />
-</div>
-</div>
-<div class="paragraph"><p><em>Equipment-specific information</em>: Equipment-specific information gathered by
-<em>Subsurface</em> is shown in the <a href="#S_ExtraDataTab">Extra data tab</a>. This may
-include setup information or metadata about the dive.</p></div>
-<div class="paragraph"><p>More equipment-specific information for downloading CCR dive logs for
-Poseidon MkVI and APD equipment can be found in <a href="#S_PoseidonMkVI">Appendix
-B</a>.</p></div>
-</div>
-</div>
+readings of the two oxygen sensors.</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/CCR_dive_profile_f22.jpg" alt="FIGURE: CCR dive profile" />
+</div>
+</div>
+<div class="paragraph"><p><em>Equipment-specific information</em>: Equipment-specific information gathered by
+<em>Subsurface</em> is shown in the <a href="#S_ExtraDataTab">Extra data tab</a>. This may
+include setup information or metadata about the dive.</p></div>
+<div class="paragraph"><p>The deco ceiling calculated by Subsurface is not very accurate because the
+precise pressure of nitrogen in the loop can usually not be determined from
+the dive log imported from the CCR equipment. Many CCR dive computers,
+however, report an internally-calculated deco ceiling that is reported in
+the dive log, reflecting a more accurate assessment. The display of this
+ceiling is activated by clicking the appropriate button to the left of the
+dive profile:</p></div>
+<div class="paragraph"><p>The default colour of the computer-generated deco ceiling is white. However,
+this can be set to red by checking the appropriate check box after selecting
+<em>File &#8594; Preferences &#8594; Graph</em>. Below is a dive profile indicating the dive
+computer-generated deco ceiling:</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/CCR_dive_ceilingF22.jpg" alt="FIGURE: CCR computer-generated deco ceiling" />
+</div>
+</div>
+<div class="paragraph"><p>More equipment-specific information for downloading CCR dive logs for
+Poseidon MkVI and APD equipment can be found in
+<a href="#_appendix_b_dive_computer_specific_information_for_importing_dive_information">Appendix
+B</a>.</p></div>
+</div>
+</div>
</div>
</div>
</div>
@@ -3327,9 +3344,9 @@ Graph <strong>D</strong> shows the pressures after ascent to a depth of 4.5 mete
<p>
Graph <strong>E</strong> indicates the situation after remaining at 4.5 meters for 10
minutes. The fast compartments have decreased in pressure. As expected, the
- pressures in the slow compartments have not changed much. The pressures in
- the fast compartments do not approach the GFHigh value any more and the
- diver is safer than in the situation indicated in graph <strong>D</strong>.
+ pressures in the slow compartments have not changed much. The pressures in
+ the fast compartments do not approach the GFHigh value any more and the
+ diver is safer than in the situation indicated in graph <strong>D</strong>.
</p>
</li>
</ul></div>
@@ -3357,9 +3374,9 @@ a group of dives and then right-clicking.</p></div>
<div class="content">
<img src="images/DiveListOptions.jpg" alt="Example: Dive list info options" />
</div>
-</div>
-<div class="paragraph"><p>The default information in the <strong>Dive List</strong> includes, for each dive,
-Dive_number, Date, Rating, Dive_depth, Dive_duration and Dive_location. This
+</div>
+<div class="paragraph"><p>The default information in the <strong>Dive List</strong> includes, for each dive,
+Dive_number, Date, Rating, Dive_depth, Dive_duration and Dive_location. This
information can be controlled and changed by right-clicking on the header
bar of the <strong>Dive List</strong>. For instance, a right-click on the <em>Date</em> header
brings up a list of items that can be shown in the dive list (see
@@ -3375,9 +3392,9 @@ dives at a particular site. By pressing <em>Ctl-F</em> on the keyboard, a text
is opened at the top left hand of the <strong>Dive List</strong>. Type the name of a dive
site in this text box and the <strong>Dive List</strong> is immediately filtered to show
only the dives for that site.</p></div>
-</div>
-</div>
-<div class="sect2">
+</div>
+</div>
+<div class="sect2">
<h3 id="S_Renumber">7.2. Renumbering the dives</h3>
<div class="paragraph"><p>Dives are normally numbered incrementally from non-recent dives (low
sequence numbers) to recent dives (having the highest sequence numbers). The
@@ -3457,14 +3474,14 @@ figures below shows the selection and context menu on the left (A) and the
completed action on the right (B):</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
-<img src="images/SplitDive3a.jpg" alt="FIGURE: Split a trip into 2 trips" />
-</div>
-</div>
+<img src="images/SplitDive3a.jpg" alt="FIGURE: Split a trip into 2 trips" />
+</div>
+</div>
</div>
</div>
-<div class="sect2">
-<h3 id="_manipulating_single_dives">7.4. Manipulating single dives</h3>
-<div class="sect3">
+<div class="sect2">
+<h3 id="_manipulating_single_dives">7.4. Manipulating single dives</h3>
+<div class="sect3">
<h4 id="_delete_a_dive_from_the_dive_log">7.4.1. Delete a dive from the dive log</h4>
<div class="paragraph"><p>Dives can be permanently deleted from the dive log by selecting and
right-clicking them to bring up the context menu, and then selecting <strong>Delete
@@ -3571,9 +3588,9 @@ those dives that have either one OR both of these tags.</p></div>
<p>
Exporter les informations de plongée vers <em>Facebook</em>
</p>
-</li>
-<li>
-<p>
+</li>
+<li>
+<p>
<a href="#S_Export_other">Exporter des informations de plongée vers d&#8217;autres
destinations ou formats</a>
</p>
@@ -3586,9 +3603,9 @@ d&#8217;export. Cela est du au fait que l&#8217;export vers <em>Facebook</em> n
connexion vers <em>Facebook</em>, nécessitant un identifiant et un mot de passe. À
partir du menu principal, si vous sélectionnez <em>Fichier &#8594; Préférences &#8594;
Facebook</em>, un écran de connexion est présenté (voir l&#8217;image <strong>A</strong> sur la
-gauche, ci dessous). Entrez vos identifiant et mot de passe <em>Facebook</em>. Une
-fois connecté à <em>Facebook</em>, le panneau de l&#8217;image <strong>B</strong> ci dessous est
-présenté. Ce panneau a un bouton qui doit être sélectionné pour fermer la
+gauche, ci dessous). Entrez vos identifiant et mot de passe <em>Facebook</em>. Une
+fois connecté à <em>Facebook</em>, le panneau de l&#8217;image <strong>B</strong> ci dessous est
+présenté. Ce panneau a un bouton qui doit être sélectionné pour fermer la
connexion <em>Facebook</em>.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
@@ -3633,9 +3650,9 @@ préférences Facebook.</p></div>
<div class="paragraph"><p>For non-<em>Facebook exports</em>, the export function can be reached by selecting
<em>File &#8594; Export</em>, which brings up the Export dialog. This dialog always
gives two options: save ALL dives, or save only the dives selected in <strong>Dive
-List</strong> panel of <em>Subsurface</em>. Click the appropriate radio button (see images
-below).</p></div>
-<div class="imageblock" style="text-align:center;">
+List</strong> panel of <em>Subsurface</em>. Click the appropriate radio button (see images
+below).</p></div>
+<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Export_f20.jpg" alt="Figure: Export dialog" />
</div>
@@ -3761,9 +3778,9 @@ instance <em>www.divelogs.de</em>.</p></div>
</div>
<div class="sect1">
<h2 id="S_Cloud_access">9. Keeping a <em>Subsurface</em> dive log in the Cloud</h2>
-<div class="sectionbody">
-<div class="paragraph"><p>For each diver, dive log information is highly important. Not only is it a
-record of diving activities for one&#8217;s own pleasure, but it is important
+<div class="sectionbody">
+<div class="paragraph"><p>For each diver, dive log information is highly important. Not only is it a
+record of diving activities for one&#8217;s own pleasure, but it is important
information required for admission to further training courses or
(sometimes) even diving sites. The security of the dive log is therefore
critical. In order to have a dive log that is resistant to failure of a home
@@ -3854,21 +3871,21 @@ one&#8217;s desktop computer.</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/Cloud.jpg" alt="FIGURE: Dropbox folder" />
-</div>
-</div>
-<div class="paragraph"><p>The <em>Dropbox</em> program creates a copy of the <em>Dropbox</em> Internet Cloud content
-on one&#8217;s desktop computer. When the computer is connected to the Internet,
-the Internet content is automatically updated. Therefore both the <em>Open</em> and
-<em>Save</em> of dive logs are done using the local copy of the dive log in the
-local <em>Dropbox</em> folder, so there&#8217;s no need for a direct internet
-connection. If the local copy is modified, e.g. by adding a dive, the remote
-copy in the <em>Dropbox</em> server in the Cloud will be automatically updated
-whenever Internet access is available.</p></div>
-<div class="paragraph"><p>In this way a dive log in one&#8217;s <em>Dropbox</em> folder can be accessed seamlessly
-from the Internet and can be accessed from any place with Internet
-access. Currently there are no costs involved for this service. Dropbox
-(Windows, Mac and Linux) can be installed by accessing the
-<a href="http://www.dropbox.com/install"><em>Install Page on the Dropbox website</em></a>
+</div>
+</div>
+<div class="paragraph"><p>The <em>Dropbox</em> program creates a copy of the <em>Dropbox</em> Internet Cloud content
+on one&#8217;s desktop computer. When the computer is connected to the Internet,
+the Internet content is automatically updated. Therefore both the <em>Open</em> and
+<em>Save</em> of dive logs are done using the local copy of the dive log in the
+local <em>Dropbox</em> folder, so there&#8217;s no need for a direct internet
+connection. If the local copy is modified, e.g. by adding a dive, the remote
+copy in the <em>Dropbox</em> server in the Cloud will be automatically updated
+whenever Internet access is available.</p></div>
+<div class="paragraph"><p>In this way a dive log in one&#8217;s <em>Dropbox</em> folder can be accessed seamlessly
+from the Internet and can be accessed from any place with Internet
+access. Currently there are no costs involved for this service. Dropbox
+(Windows, Mac and Linux) can be installed by accessing the
+<a href="http://www.dropbox.com/install"><em>Install Page on the Dropbox website</em></a>
Alternatively one can use <em>Dropbox</em> as a mechanism to backup one&#8217;s dive
log. To Store a dive log in the Cloud, select <em>File &#8594; Save as</em> from the
<em>Subsurface</em> main menu, navigate to the <em>Dropbox</em> folder and select the
@@ -3876,147 +3893,176 @@ log. To Store a dive log in the Cloud, select <em>File &#8594; Save as</em> from
Logbook</em> from the <em>Subsurface</em> main menu and navigate to the dive log file
in the <em>Dropbox</em> folder and select the <em>Open</em> button.</p></div>
<div class="paragraph"><p>Several paid services exist on the Internet (e.g. Google, Amazon) where the
-same process could be used for the Cloud-based storage of dive logs.</p></div>
-</div>
-</div>
+same process could be used for the Cloud-based storage of dive logs.</p></div>
+</div>
+</div>
<div class="sect1">
<h2 id="S_PrintDivelog">10. Printing a dive log</h2>
<div class="sectionbody">
-<div class="paragraph"><p><em>Subsurface</em> provides a simple interface to print a whole dive log or only a few selected dives.
- Pre-installed templates or a custom written template can be used to choose where the data will
- be fitted into the page.</p></div>
+<div class="paragraph"><p><em>Subsurface</em> provides a simple and flexible interface to print a whole dive log or only a few selected dives.
+ Pre-installed templates or a custom written template can be used to choose where the data are fitted into the page.</p></div>
<div class="paragraph"><p>Before printing, two decisions are required:</p></div>
<div class="ulist"><ul>
<li>
-<p>
-Should the whole dive log be printed or only part of it? If only part of the
- dive log is required, then the user must select the required dives from the
- <strong>Dive List</strong> panel.
-</p>
-</li>
-<li>
-<p>
-What gas partial pressure information is required on the dive profile? Users
- should select the appropriate toggle-buttons on the button bar to the left
- of the Dive Profile panel.
-</p>
-</li>
-</ul></div>
-<div class="paragraph"><p>Now the print options should be selected to match the user&#8217;s needs. To do
-this, user should select <em>File &#8594; Print</em> from the Main menu. The following
-dialogue appears (see the image on the left [A], below).</p></div>
-<div class="imageblock" style="text-align:center;">
-<div class="content">
-<img src="images/PrintDiveLog.jpg" alt="FIGURE: Print dialogue" />
-</div>
-</div>
-<div class="paragraph"><p>Under <em>Print type</em> users need to select one of two options:</p></div>
-<div class="ulist"><ul>
-<li>
<p>
-<em>Dive list</em> print: print dives from the list with profiles and other
- information.
+Should the whole dive log be printed or only part of it? If only part of the
+ dive log is required, then select the required dives from the <strong>Dive List</strong>
+ panel.
</p>
</li>
<li>
<p>
-<em>Statistics</em> print: print yearly statistics of the dives.
+If the dive profiles needs printing, what gas partial pressure information
+ should be shown? Select the appropriate toggle-buttons on the button bar to
+ the left of the <strong>Dive Profile</strong> panel.
</p>
</li>
</ul></div>
-<div class="paragraph"><p>Under <em>Print options</em> users need to select:</p></div>
+<div class="paragraph"><p>If <em>File &#8594; Print</em> is selected from the Main menu, the the dialogue below
+(image <strong>A</strong>) appears. Three specifications are needed to achieve the desired
+information and page layout:</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Print1_f22.jpg" alt="FIGURE: Print dialogue" />
+</div>
+</div>
+<div class="olist arabic"><ol class="arabic">
+<li>
+<p>
+Under <em>Print type</em> select one of two options:
+</p>
<div class="ulist"><ul>
<li>
<p>
-Printing only the dives that have been selected from the dive list prior to
- activating the print dialogue, achieved by checking the box <em>Print only
- selected dives</em>.
+<em>Dive list print</em>: Print dives from the <strong>Dive List</strong> panel with profiles and
+ other information.
</p>
</li>
<li>
<p>
-Printing in colour, achieved by checking the box with <em>Print in colour</em>.
+<em>Statistics print</em>: Print yearly statistics of the dives.
</p>
</li>
</ul></div>
-<div class="paragraph"><p>Under <em>Template</em> users can select:</p></div>
+</li>
+<li>
+<p>
+Under <em>Print options</em> select:
+</p>
<div class="ulist"><ul>
<li>
<p>
-A template to be used as the page layout.
+Printing only the dives selected from the dive list prior to activating the
+ print dialogue by checking the box <em>Print only selected dives</em>. If this
+ check box is <strong>not</strong> checked all dives in the <strong>Dive List</strong> panel are printed.
</p>
</li>
<li>
<p>
-<em>Delete</em> a template from the template list
+Printing in colour, achieved by checking the box with <em>Print in colour</em>. If
+ this check box is not checked, printing is in monochrome (grey scale).
</p>
</li>
+</ul></div>
+</li>
+</ol></div>
+<div class="paragraph"><p>Under <em>Template</em> select a template to be used as the page layout. There are
+several templates (see image <strong>B</strong>, above).</p></div>
+<div class="ulist"><ul>
<li>
<p>
-<em>Import</em> a new template to the template list
+<em>Table</em>: This prints a summary table of all dives selected (see below).
</p>
</li>
+</ul></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Print_summarylist_f22.jpg" alt="FIGURE: Print summary table" />
+</div>
+</div>
+<div class="ulist"><ul>
<li>
<p>
-<em>Export</em> a template from the template list
+<em>Flow layout</em>: Print the text associated with each diev without printing the
+ dive profiles
+ of each dive (see below):
</p>
</li>
+</ul></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Print_flow_layout_f22.jpg" alt="FIGURE: Print flow layout" />
+</div>
+</div>
+<div class="ulist"><ul>
<li>
<p>
-<em>Edit</em> a template (choose colors, fonts, font-type)
+<em>One Dive</em>: Print one dive per page, also showing the dive profile (see
+ below)
</p>
</li>
</ul></div>
-<div class="paragraph"><p>When editing a template the following options are available:</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/print2_f22.jpg" alt="FIGURE: Print one dive / page" />
+</div>
+</div>
<div class="ulist"><ul>
<li>
<p>
-<em>Style</em>: edit font type, size, choose color palette; this will not affect
- the template HTML code
+<em>Two Dives</em>: Print two dives per page, also showing the dive profiles.
</p>
</li>
<li>
<p>
-<em>Template</em>: edit the template HTML code; by saving, the "Custom" template in
- the template list will be replaced
+<em>Six Dives</em>: Print six dives per page, also showing the dive profiles.
</p>
</li>
<li>
<p>
-<em>Colors</em>: edit the current color palette; the new color palette will
- overwrite the "Custom" color palette
+<em>Custom</em>: This option allows customisation of the print contents and
+ layout. This is
+ discussed at the end of this section.
</p>
</li>
</ul></div>
<div class="paragraph"><p>Users can <em>Preview</em> the printed page by selecting the <em>Preview</em> button on
-the dialogue. After preview, changes to the options in the print dialogue
-can be made, resulting in a layout that fits personal taste.</p></div>
-<div class="paragraph"><p>Next, select the <em>Print</em> button in the dialogue. This activates the regular
-print dialogue used by the user operating system (image [<strong>B</strong>] in the middle,
-above), allowing them to choose a printer and to set its properties (image
-[<strong>C</strong>] on the right, above). It is important to set the print resolution of
-the printer to an appropriate value by changing the printer
-properties. Finally, one can print the dives. Below is a (rather small)
-example of the output for one particular page.</p></div>
-<div class="imageblock" style="text-align:center;">
-<div class="content">
+the dialogue (see image <strong>A</strong> at the start of this section). After preview,
+changes to the options in the print dialogue can be made, resulting in a
+layout that fits personal taste.</p></div>
+<div class="paragraph"><p>Next, select the <em>Print</em> button (see image <strong>A</strong> at the start of this
+section). This activates the regular print dialogue used by the user
+operating system, allowing one to choose a printer and to set its properties
+(see image below):</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Print_print_f22.jpg" alt="FIGURE: Print one dive / page" />
+</div>
+</div>
+<div class="paragraph"><p>Set the print resolution of the printer to an appropriate value by changing
+the printer <em>Properties</em>. Finally, select the <em>Print</em> button to print the
+dives. Below is a (rather small) example of the output for one particular
+page.</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
<img src="images/Printpreview.jpg" alt="FIGURE: Print preview page" />
</div>
</div>
<div class="sect2">
<h3 id="_write_a_custom_printing_template_advanced">10.1. Write a custom printing template (advanced)</h3>
<div class="paragraph"><p>Writing a custom template is an effective way to produce highly customized
-printouts. Subsurface uses HTML templates with Grantlee as the printing
-backend.</p></div>
-<div class="paragraph"><p>See <a href="#_appendix_f_write_a_custom_printing_template">APPENDIX F</a> for
-information on how to write your own template.</p></div>
+printouts. Subsurface uses HTML templates to render printing. One can create
+a template, export a new template, import an existing template and delete an
+existing template by using the appropriate buttons under the <em>Template</em>
+dropdown list in the print dialogue. See <a href="#S_APPENDIX_E">APPENDIX E</a> for
+information on how to write or modify a template.</p></div>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="S_Configure">11. Configurer un ordinateur de plongée</h2>
-<div class="sectionbody">
-<div class="paragraph"><p><em>Subsurface</em> permet de configurer son ordinateur de plongée. Actuellement,
+<h2 id="S_Configure">11. Configurer un ordinateur de plongée</h2>
+<div class="sectionbody">
+<div class="paragraph"><p><em>Subsurface</em> permet de configurer son ordinateur de plongée. Actuellement,
les familles d&#8217;ordinateurs supportés sont Heinrichs-Weikamp (OSTC 2, OSTC 3)
et Suunto Vyper (Stinger, Mosquito, D3, Vyper, Vytec, Cobra, Gekko et
Zoop). De nombreux paramètres de ces ordinateurs de plongée peuvent être
@@ -4179,9 +4225,9 @@ the dive profile:
<em>Draw dive computer reported ceiling red</em>: This checkbox allows exactly what it says.
Not all dive computers report ceiling values. If the dive computer does report it, it may differ
from the ceilings calculated by <em>Subsurface</em>. This is because of the different algorithms and gradient factors available for calculating ceilings, as well as the dynamic way that a
- dive computer can calculate ceilings during a dive.
-</p>
-</li>
+ dive computer can calculate ceilings during a dive.
+</p>
+</li>
<li>
<p>
<em>Show unused cylinders in Equipment Tab</em>: This checkbox allows display of information about unused cylinders when viewing the <strong>Equipment Tab</strong>. Conversely, if this box is not checked, and any cylinders entered using the <strong>Equipment Tab</strong> are not used (e.g. there was no gas switch to such a cylinder), then these cylinders are omitted from that list.
@@ -4207,9 +4253,9 @@ the dive profile:
Gradient Factors:* Here users can set the <em>gradient factors</em> used while diving. GF_Low is
the gradient factor at depth and GF_High is used just below the surface.
At intermediate depths gradient factors between GF_Low and GF_High are used.
- Gradient factors add conservatism to the nitrogen exposure during a dive, in a
- similar way that many dive computers have a conservatism setting. The lower
- the value of a gradient factor, the more conservative the calculations are with
+ Gradient factors add conservatism to the nitrogen exposure during a dive, in a
+ similar way that many dive computers have a conservatism setting. The lower
+ the value of a gradient factor, the more conservative the calculations are with
respect to nitrogen loading and the deeper the ascent ceilings are. Gradient
factors of 20/60 are considered conservative and values of 60/90 are considered
harsh. Checking <strong>GFLow at max depth</strong> box causes GF_Low to be used at the
@@ -4306,9 +4352,9 @@ Internet services such as the <a href="#S_Companion"><em>Subsurface Companion ap
data export/import from <em>Divelogs.de</em>. These Internet requirements are
determined by one&#8217;s type of connection to the Internet and by the Internet
Service Provider (ISP) used. One&#8217;s ISP should provide the appropriate
-information. If a proxy server is used for Internet access, the appropriate
-information needs to be provided here. The type of proxy needs to be
-selected from the dropdown list. after which the IP address of the host and
+information. If a proxy server is used for Internet access, the appropriate
+information needs to be provided here. The type of proxy needs to be
+selected from the dropdown list. after which the IP address of the host and
the appropriate port number should be provided. If the proxy server uses
authentication, the appropriate userID and password also needs to be
provided so that <em>Subsurface</em> can automatically pass through the proxy
@@ -4335,9 +4381,9 @@ plongée vers Facebook</a> pour plus d&#8217;informations.</p></div>
<div class="sect1">
<h2 id="S_DivePlanner">13. The <em>Subsurface</em> dive planner</h2>
<div class="sectionbody">
-<div class="paragraph"><p>Dive planning is an advanced feature of <em>Subsurface</em>, accessible by
-selecting <em>Log &#8594; Plan Dive</em> from the main menu. It allows calculation of
-nitrogen load during a dive by using the Bühlmann ZH-L16 algorithm with the
+<div class="paragraph"><p>Dive planning is an advanced feature of <em>Subsurface</em>, accessible by
+selecting <em>Log &#8594; Plan Dive</em> from the main menu. It allows calculation of
+nitrogen load during a dive by using the Bühlmann ZH-L16 algorithm with the
addition of gradient factors as implemented by Erik Baker.</p></div>
<div class="sidebarblock">
<div class="content">
@@ -4396,9 +4442,9 @@ sections (see image below). The <strong>setup</strong> parameters for a dive are
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 Notes.</p></div>
-<div class="paragraph"><p>At the top right hand is a green <strong>design panel</strong> upon which the profile of
-the dive can be manipulated directly by dragging and clicking as explained
-below. This feature makes the <em>Subsurface</em> dive planner unique in ease of
+<div class="paragraph"><p>At the top right hand is a green <strong>design panel</strong> upon which the profile of
+the dive can be manipulated directly by dragging and clicking as explained
+below. This feature makes the <em>Subsurface</em> dive planner unique in ease of
use.</p></div>
<div class="paragraph"><p>At the bottom right is a text panel with a heading of <em>Dive Plan
Details</em>. This is where the details of the dive plan are provided in a way
@@ -4597,78 +4643,78 @@ For more information external to this manual see:</p></div>
<div class="ulist"><ul>
<li>
<p>
-<a href="http://www.tek-dive.com/portal/upload/M-Values.pdf">Understanding
- M-values by Erik Baker, <em>Immersed</em> Vol. 3, No. 3.</a>
-</p>
-</li>
-<li>
-<p>
-<a href="http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/5037-gradient-factors-for-dummies.html">Gradient
- factors for dummies, by Kevin Watts</a>
-<a href="http://www.amazon.com/Deco-Divers-Decompression-Theory-Physiology/dp/1905492073/ref=sr_1_1?s=books&amp;ie=UTF8&amp;qid=1403932320&amp;sr=1-1&amp;keywords=deco+for+divers"><em>Deco
-for Divers</em>, by Mark Powell (2008). Aquapress</a> Southend-on-Sea, UK. ISBN 10:
-1-905492-07-3. An excellent non-technical review.
-</p>
-</li>
-</ul></div>
-<div class="paragraph"><p>The ascent rate is critical for nitrogen off-gassing at the end of the dive
-and is specified for several depth ranges, utilising the average (or mean)
-depth as a yardstick. The mean depth of the dive plan is indicated by a
-light grey line on the dive profile. Ascent rates at deeper levels are often
-in the range of 8-12 m/min, while ascent rates near the surface are often in
-the range of 4-9 m/min. The descent rate is also specified. If the option
-<em>Drop to first depth</em> is activated, then the descent phase of the planned
-dive will be at the maximal descent rate specified in the <em>Rates</em> section of
-the dive setup.</p></div>
-<div class="paragraph"><p><strong>b) Oxygen management</strong>: In the <strong>Gas Options</strong> part of the dive specification, the maximum partial
-pressure for oxygen needs to be specified for the
-bottom part of the dive (<em>bottom po2</em>) as well as for the decompression part of the dive (<em>deco po2</em>).
-The most commonly
-used values are 1.4 bar for the bottom part of the dive and 1.6 bar for any decompression
-stages. Normally, a partial pressure of 1.6 bar is not exceeded. PO2 settings and the depth at which switching to a gas takes place can also be edited in the
-<em>Available Gases</em> dialog. Normally the planner decides on switching to a new gas when, during
-ascent, the partial pressure of the new gas has increased to 1.6 bar.</p></div>
-<div class="paragraph"><p><strong>c) Gas management</strong>: With open-circuit dives this is a primary consideration. One needs to keep within the limits of the amount of gas within the dive
-cylinder(s), allowing for an appropriate margin for a safe return to the surface, possibly
-sharing with a buddy. Under the <em>Gas Options</em> heading, specify the best (but conservative) estimate
-of your surface-equivalent air consumption (SAC, also termed RMV) in
-litres/min (for the time being, only SI units are supported). Specify the SAC during the
-bottom part of the dive (<em>bottom SAC</em>) as well as during the decompression or safety stops of the
-dive (<em>deco SAC</em>). Values of 15-30 l/min are common. For good gas management, a thumbsuck guess
-is not sufficient and one needs to
-monitor one&#8217;s gas consumption on a regular basis, dependent on different dive conditions and/or equipment.
-The planner calculates the total volume of gas used during the dive and issues a warning
-if one exceeds the total amount of gas available. Good practice demands that one does not dive to
-the limit of the gas supply but that an appropriate reserve is kept for unforeseen circumstances.
-For technical diving, this reserve can be up to 66% of the total available gas.</p></div>
-<div class="paragraph"><p>Now (at last) one can start the detailed time-depth planning of the
-dive. <em>Subsurface</em> offers a unique graphical interface for performing this
-part of the planning. The mechanics of doing this is similar to
-hand-entering a dive profile in the dive log part of <em>Subsurface</em>. Upon
-activating the planner, a default dive of depth 15 m for 40 min is offered
-in the bue design surface to the top right hand of the screen. The white
-dots (waypoints) on the profile can be dragged with a mouse. Create more
-waypoints by double-clicking on the profile line and ensuring that the
-profile reflects the intended dive. Drag the waypoints to represent the
-depth and duration of the dive. It is NOt necessary to specify the ascent
-part of the dive since the planner calculates this, based on the settings
-that have been specified. If any of the management limits (for nitrogen,
-oxygen or gas) is exceeded, the surface above the dive profile changes from
-BLUE to RED.</p></div>
-<div class="paragraph"><p>Each waypoint on the dive profile creates a <em>Dive Planner Point</em> in the
-table on the left of the dive planner panel. Ensure that the <em>Used Gas</em>
-value in each row of that table corresponds to one of the gas mixtures
-specified in the <em>Available Gases</em> 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 <em>Subsurface</em>. In most cases <em>Subsurface</em> computes additional way
-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 <em>Dive Planner Points</em> dialogue can be
-edited by hand in order to obtain a precise presentation of the dive
-plan. In fact, one can create the whole dive profile by editing the <em>Dive
-Planner Points</em> dialog.</p></div>
-<div class="paragraph"><p>Indicate any changes in gas cylinder used by indicating gas changes as
+<a href="http://www.tek-dive.com/portal/upload/M-Values.pdf">Understanding
+ M-values by Erik Baker, <em>Immersed</em> Vol. 3, No. 3.</a>
+</p>
+</li>
+<li>
+<p>
+<a href="http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/5037-gradient-factors-for-dummies.html">Gradient
+ factors for dummies, by Kevin Watts</a>
+<a href="http://www.amazon.com/Deco-Divers-Decompression-Theory-Physiology/dp/1905492073/ref=sr_1_1?s=books&amp;ie=UTF8&amp;qid=1403932320&amp;sr=1-1&amp;keywords=deco+for+divers"><em>Deco
+for Divers</em>, by Mark Powell (2008). Aquapress</a> Southend-on-Sea, UK. ISBN 10:
+1-905492-07-3. An excellent non-technical review.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>The ascent rate is critical for nitrogen off-gassing at the end of the dive
+and is specified for several depth ranges, utilising the average (or mean)
+depth as a yardstick. The mean depth of the dive plan is indicated by a
+light grey line on the dive profile. Ascent rates at deeper levels are often
+in the range of 8-12 m/min, while ascent rates near the surface are often in
+the range of 4-9 m/min. The descent rate is also specified. If the option
+<em>Drop to first depth</em> is activated, then the descent phase of the planned
+dive will be at the maximal descent rate specified in the <em>Rates</em> section of
+the dive setup.</p></div>
+<div class="paragraph"><p><strong>b) Oxygen management</strong>: In the <strong>Gas Options</strong> part of the dive specification, the maximum partial
+pressure for oxygen needs to be specified for the
+bottom part of the dive (<em>bottom po2</em>) as well as for the decompression part of the dive (<em>deco po2</em>).
+The most commonly
+used values are 1.4 bar for the bottom part of the dive and 1.6 bar for any decompression
+stages. Normally, a partial pressure of 1.6 bar is not exceeded. PO2 settings and the depth at which switching to a gas takes place can also be edited in the
+<em>Available Gases</em> dialog. Normally the planner decides on switching to a new gas when, during
+ascent, the partial pressure of the new gas has increased to 1.6 bar.</p></div>
+<div class="paragraph"><p><strong>c) Gas management</strong>: With open-circuit dives this is a primary consideration. One needs to keep within the limits of the amount of gas within the dive
+cylinder(s), allowing for an appropriate margin for a safe return to the surface, possibly
+sharing with a buddy. Under the <em>Gas Options</em> heading, specify the best (but conservative) estimate
+of your surface-equivalent air consumption (SAC, also termed RMV) in
+litres/min (for the time being, only SI units are supported). Specify the SAC during the
+bottom part of the dive (<em>bottom SAC</em>) as well as during the decompression or safety stops of the
+dive (<em>deco SAC</em>). Values of 15-30 l/min are common. For good gas management, a thumbsuck guess
+is not sufficient and one needs to
+monitor one&#8217;s gas consumption on a regular basis, dependent on different dive conditions and/or equipment.
+The planner calculates the total volume of gas used during the dive and issues a warning
+if one exceeds the total amount of gas available. Good practice demands that one does not dive to
+the limit of the gas supply but that an appropriate reserve is kept for unforeseen circumstances.
+For technical diving, this reserve can be up to 66% of the total available gas.</p></div>
+<div class="paragraph"><p>Now (at last) one can start the detailed time-depth planning of the
+dive. <em>Subsurface</em> offers a unique graphical interface for performing this
+part of the planning. The mechanics of doing this is similar to
+hand-entering a dive profile in the dive log part of <em>Subsurface</em>. Upon
+activating the planner, a default dive of depth 15 m for 40 min is offered
+in the bue design surface to the top right hand of the screen. The white
+dots (waypoints) on the profile can be dragged with a mouse. Create more
+waypoints by double-clicking on the profile line and ensuring that the
+profile reflects the intended dive. Drag the waypoints to represent the
+depth and duration of the dive. It is NOt necessary to specify the ascent
+part of the dive since the planner calculates this, based on the settings
+that have been specified. If any of the management limits (for nitrogen,
+oxygen or gas) is exceeded, the surface above the dive profile changes from
+BLUE to RED.</p></div>
+<div class="paragraph"><p>Each waypoint on the dive profile creates a <em>Dive Planner Point</em> in the
+table on the left of the dive planner panel. Ensure that the <em>Used Gas</em>
+value in each row of that table corresponds to one of the gas mixtures
+specified in the <em>Available Gases</em> 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 <em>Subsurface</em>. In most cases <em>Subsurface</em> computes additional way
+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 <em>Dive Planner Points</em> dialogue can be
+edited by hand in order to obtain a precise presentation of the dive
+plan. In fact, one can create the whole dive profile by editing the <em>Dive
+Planner Points</em> dialog.</p></div>
+<div class="paragraph"><p>Indicate any changes in gas cylinder used by indicating gas changes as
explained in the section <a href="#S_CreateProfile">hand-creating a dive profile</a>. These changes should reflect the cylinders and gas compositions
defined in the table with <em>Available Gases</em>. If two or more gases are used,
automatic gas switches will be suggested during the ascent to the
@@ -4693,9 +4739,9 @@ using EAN50 and using the settings as described above.</p></div>
<div class="paragraph"><p>Once the above has been completed, one can save it by clicking the <em>Save</em>
button towards the top middle of the planner. The saved dive plan will
appear in the <strong>Dive List</strong> panel of <em>Subsurface</em>.</p></div>
-<div class="paragraph"><p><strong>The dive plan details</strong></p></div>
-<div class="paragraph"><p>On the bottom right of the dive planner, under <em>Dive Plan Details</em>, the
-exact details of the dive plan are provided. These details may be modified
+<div class="paragraph"><p><strong>The dive plan details</strong></p></div>
+<div class="paragraph"><p>On the bottom right of the dive planner, under <em>Dive Plan Details</em>, the
+exact details of the dive plan are provided. These details may be modified
by checking any of the options under the <em>Notes</em> section of the dive
planner, immediately to the left of the <em>Dive Plan Details</em>. If a <em>Verbatim
diveplan</em> is requested, a detailed sentence-level explanation of the dive
@@ -4766,9 +4812,9 @@ dive and adds a (possibly modified) copy to the dive list. If that copy is
saved with the same start time as the original, the two dives are considered
two versions of the same dive and do not influence other each during
decompression calculation (see next section).</p></div>
-</div>
-<div class="sect2">
-<h3 id="_planning_for_repetitive_dives">13.6. Planning for repetitive dives</h3>
+</div>
+<div class="sect2">
+<h3 id="_planning_for_repetitive_dives">13.6. Planning for repetitive dives</h3>
<div class="paragraph"><p>Repetitive dives can easily be planned if the dates and start times of the
repetitive dive set is specified appropriately in the top left-hand <em>Start
Time</em> field. <em>Subsurface</em> calculates the gas loading figures correctly and
@@ -4843,9 +4889,9 @@ des sections de ce manuel traitant des opérations relatives.</p></div>
<li>
<p>
<a href="#S_ExportLog"><em>Exporter</em></a> - Exporter le carnet de plongée actuellement
- ouvert (ou les plongées sélectionnées dans le carnet) vers un des nombreux
- formats.
-</p>
+ ouvert (ou les plongées sélectionnées dans le carnet) vers un des nombreux
+ formats.
+</p>
</li>
<li>
<p>
@@ -4872,9 +4918,9 @@ des sections de ce manuel traitant des opérations relatives.</p></div>
configuration d&#8217;un ordinateur de plongée.
</p>
</li>
-<li>
-<p>
-<em>Quitter</em> - Quitter <em>Subsurface</em>.
+<li>
+<p>
+<em>Quitter</em> - Quitter <em>Subsurface</em>.
</p>
</li>
</ul></div>
@@ -4909,9 +4955,9 @@ des sections de ce manuel traitant des opérations relatives.</p></div>
</p>
</li>
</ul></div>
-</div>
-<div class="sect2">
-<h3 id="_journal_log">14.3. Journal (log)</h3>
+</div>
+<div class="sect2">
+<h3 id="_journal_log">14.3. Journal (log)</h3>
<div class="ulist"><ul>
<li>
<p>
@@ -4944,9 +4990,9 @@ des sections de ce manuel traitant des opérations relatives.</p></div>
champs d&#8217;un journal de plongée vers le presse-papier.
</p>
</li>
-<li>
-<p>
-<em>Coller les composants de la plongée</em> - Colle, dans les plongées
+<li>
+<p>
+<em>Coller les composants de la plongée</em> - Colle, dans les plongées
sélectionnées dans la <strong>liste des plongées</strong>, les informations copiées au
préalable avec l&#8217;option <em>Copier les composants de la plongée</em>.
</p>
@@ -5058,9 +5104,9 @@ des sections de ce manuel traitant des opérations relatives.</p></div>
<p>
<em>Manuel utilisateur</em> - Ouvre une fenêtre affichant ce manuel utilisateur.
</p>
-</li>
-</ul></div>
-</div>
+</li>
+</ul></div>
+</div>
</div>
</div>
<div class="sect1">
@@ -5094,9 +5140,9 @@ storage.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/drivers.jpg" alt="Note" />
-</td>
-<td class="content">Le système d&#8217;exploitation de l&#8217;ordinateur nécessite les bons pilotes pour
+<img src="images/icons/drivers.jpg" alt="Note" />
+</td>
+<td class="content">Le système d&#8217;exploitation de l&#8217;ordinateur nécessite les bons pilotes pour
communiquer avec l&#8217;ordinateur de plongée de la façon utilisée par
l&#8217;ordinateur de plongée (Bluetooth, USB, infra-rouge).</td>
</tr></table>
@@ -5122,9 +5168,9 @@ Sous Windows, le bon pilote devrait être téléchargé automatiquement la
<div class="paragraph"><p>Sous Mac, les utilisateurs peuvent parfois avoir besoin d&#8217;installer
manuellement le bon pilote. Par exemple, pour le Mares Puck ou n&#8217;importe
quel autre ordinateur de plongée utilisant une interface USB-série basé sur
-le composant Silicon Labs CP2101 ou similaire, le bon pilote est disponible
-sous <em>Mac_OSX_VCP_Driver.zip</em> sur le
-<a href="http://www.silabs.com/support/pages/document-library.aspx?p=Interface&amp;f=USB%20Bridges&amp;pn=CP2101">dépôt
+le composant Silicon Labs CP2101 ou similaire, le bon pilote est disponible
+sous <em>Mac_OSX_VCP_Driver.zip</em> sur le
+<a href="http://www.silabs.com/support/pages/document-library.aspx?p=Interface&amp;f=USB%20Bridges&amp;pn=CP2101">dépôt
de documents et logiciels Silicon Labs</a>.</p></div>
</div>
<div class="sect2">
@@ -5132,9 +5178,9 @@ de documents et logiciels Silicon Labs</a>.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/usb.jpg" alt="Note" />
-</td>
-<td class="content">Lorsqu&#8217;un utilisateur connecte un ordinateur de plongée en utilisant l&#8217;USB,
+<img src="images/icons/usb.jpg" alt="Note" />
+</td>
+<td class="content">Lorsqu&#8217;un utilisateur connecte un ordinateur de plongée en utilisant l&#8217;USB,
généralement <em>Subsurface</em> proposera soit une liste déroulante contenant le
bon nom (ou le point de montage pour un Uemis Zurich) ou la liste sera
désactivée si aucun nom de périphérique n&#8217;est nécessaire. Dans les rares cas
@@ -5211,9 +5257,9 @@ vérifiez que
l&#8217;appartenance au groupe est bien effectif. Le groupe <code>dialout</code> devrait
être listé
parmi les différents IDs.
-Sous certaines circonstances, les modifications ne prennent effet qu&#8217;après une déconnexionpuis reconnexion sur l&#8217;ordinateur (sous Ubuntu, par exemple).
-Avec le bon nom de périphérique (par exemple <code>dev/ttyUSB3</code>) et avec un accès
-en écriture au port USB, l&#8217;ordinateur de plongée devrait se connecter et
+Sous certaines circonstances, les modifications ne prennent effet qu&#8217;après une déconnexionpuis reconnexion sur l&#8217;ordinateur (sous Ubuntu, par exemple).
+Avec le bon nom de périphérique (par exemple <code>dev/ttyUSB3</code>) et avec un accès
+en écriture au port USB, l&#8217;ordinateur de plongée devrait se connecter et
vous devriez pouvoir importer vos plongées.</p></div>
</div>
<div class="sect2">
@@ -5221,9 +5267,9 @@ vous devriez pouvoir importer vos plongées.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/bluetooth.jpg" alt="Note" />
-</td>
-<td class="content">For dive computers communicating through bluetooth like the Heinrichs
+<img src="images/icons/bluetooth.jpg" alt="Note" />
+</td>
+<td class="content">For dive computers communicating through bluetooth like the Heinrichs
Weikamp Frog or the Shearwater Predator and Petrel there is a different
procedure to get the devices name to communicate with <em>Subsurface</em>. Follow
these steps:</td>
@@ -5234,9 +5280,9 @@ these steps:</td>
<p>
<strong>For the dive computer, after enabling Bluetooth, ensure it is in Upload mode.</strong>
</p>
-</li>
-</ul></div>
-<div class="paragraph"><p>For Bluetooth pairing of the dive computer, refer to the manufacturer&#8217;s user
+</li>
+</ul></div>
+<div class="paragraph"><p>For Bluetooth pairing of the dive computer, refer to the manufacturer&#8217;s user
guide. When using a Shearwater Predator/Petrel, select <em>Dive Log &#8594; Upload
Log</em> and wait for the <em>Wait PC</em> message.</p></div>
<div class="ulist"><ul>
@@ -5500,33 +5546,33 @@ upload mode countdown is still running, go to_Subsurface_, select
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/iumis.jpg" alt="Note" />
-</td>
-<td class="content"><em>Subsurface</em> downloads the information stored on the SDA (the built-in file
-system of the Uemis) including information about dive spots and
-equipment. Buddy information is not yet downloadable. Things are very
-similar to a normal USB-connected dive computer (the Uemis is one of those
-that recharge when connected to the USB port). The main difference is that
-one does not enter a device name, but instead the location where the
-UEMISSDA file system is mounted once connected to the dive computer. On
-Windows this is a drive letter ( often <em>E:</em> or <em>F:</em>), on a Mac this is
-<em>/Volumes/UEMISSDA</em> and on Linux systems this differs depending on the
-distribution. On Fedora it usually is
-<em>/var/run/media/&lt;your_username&gt;/UEMISSDA</em>. In all cases <em>Subsurface</em> should
-suggest the correct location in the drop down list.</td>
-</tr></table>
-</div>
-<div class="paragraph"><p>After selecting the above device name, download the dives from the Uemis
-Zurich. One technical issue with the Uemis Zurich download implementation
-(this is a Uemis firmware limitation, not a <em>Subsurface</em> issue) is that one
-cannot download more than about 40-50 dives without running out of memory on
-the SDA. This will usually only happen the very first time one downloads
-dives from the Uemis Zurich. Normally when downloading at the end of a day
-or even after a dive trip, the capacity is sufficient. If <em>Subsurface</em>
-displays an error that the dive computer ran out of space the solution is
-straight forward. Disconnect the SDA, turn it off and on again, and
-reconnect it. You can now retry (or start a new download session) and the
-download will continue where it stopped previously. One may have to do this
+<img src="images/icons/iumis.jpg" alt="Note" />
+</td>
+<td class="content"><em>Subsurface</em> downloads the information stored on the SDA (the built-in file
+system of the Uemis) including information about dive spots and
+equipment. Buddy information is not yet downloadable. Things are very
+similar to a normal USB-connected dive computer (the Uemis is one of those
+that recharge when connected to the USB port). The main difference is that
+one does not enter a device name, but instead the location where the
+UEMISSDA file system is mounted once connected to the dive computer. On
+Windows this is a drive letter ( often <em>E:</em> or <em>F:</em>), on a Mac this is
+<em>/Volumes/UEMISSDA</em> and on Linux systems this differs depending on the
+distribution. On Fedora it usually is
+<em>/var/run/media/&lt;your_username&gt;/UEMISSDA</em>. In all cases <em>Subsurface</em> should
+suggest the correct location in the drop down list.</td>
+</tr></table>
+</div>
+<div class="paragraph"><p>After selecting the above device name, download the dives from the Uemis
+Zurich. One technical issue with the Uemis Zurich download implementation
+(this is a Uemis firmware limitation, not a <em>Subsurface</em> issue) is that one
+cannot download more than about 40-50 dives without running out of memory on
+the SDA. This will usually only happen the very first time one downloads
+dives from the Uemis Zurich. Normally when downloading at the end of a day
+or even after a dive trip, the capacity is sufficient. If <em>Subsurface</em>
+displays an error that the dive computer ran out of space the solution is
+straight forward. Disconnect the SDA, turn it off and on again, and
+reconnect it. You can now retry (or start a new download session) and the
+download will continue where it stopped previously. One may have to do this
more than once, depending on how many dives are stored on the dive computer.</p></div>
</div>
<div class="sect2">
@@ -5534,16 +5580,16 @@ more than once, depending on how many dives are stored on the dive computer.</p>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/Galileo.jpg" alt="Note" />
-</td>
-<td class="content">The Uwatec Galileo dive computers use infra red (IrDA) communication between
-the dive computer and Subsurface. The Uwatec hardware uses a USB dongle
-based on the serial infra-red (SIR) protocol and the MSC7780 IrDA controller
-manufactured by MosChip and marketed by Scubapro and some electronics
-companies. Under Linux, the kernel already provides for communication using
-the IrDA protocol. However, the user additionally needs to load a driver for
-the IrDA interface with the dive computer. The easiest way is to load the
-<strong>irda-tools</strong> package from the
+<img src="images/icons/Galileo.jpg" alt="Note" />
+</td>
+<td class="content">The Uwatec Galileo dive computers use infra red (IrDA) communication between
+the dive computer and Subsurface. The Uwatec hardware uses a USB dongle
+based on the serial infra-red (SIR) protocol and the MSC7780 IrDA controller
+manufactured by MosChip and marketed by Scubapro and some electronics
+companies. Under Linux, the kernel already provides for communication using
+the IrDA protocol. However, the user additionally needs to load a driver for
+the IrDA interface with the dive computer. The easiest way is to load the
+<strong>irda-tools</strong> package from the
<a href="http://irda.sourceforge.net/docs/startirda.html">Linux IrDA Project</a>. After
the installation of the irda-tools, the <strong>root user</strong> can specify a device
name from the console as follows: <code>irattach irda0</code></td>
@@ -5566,16 +5612,16 @@ for OSX 10.6 or higher.</p></div>
<table><tr>
<td class="icon">
<img src="images/icons/HW_DR5.jpg" alt="Note" />
-</td>
-<td class="content">When mounted as a USB drive the Heinrichs Weikamp DR5 saves a single UDDF
-file for every dive. Mark all the dives you&#8217;d like to import or open.
-Note: The DR5 does not seem to store gradient factors nor deco information,
+</td>
+<td class="content">When mounted as a USB drive the Heinrichs Weikamp DR5 saves a single UDDF
+file for every dive. Mark all the dives you&#8217;d like to import or open.
+Note: The DR5 does not seem to store gradient factors nor deco information,
so for <em>Subsurface</em> it is not possible to display them. Adjust the gradient
factors in the <em>Graph Settings</em> in <em>Subsurface</em> to generate a deco overlay
in the <em>Subsurface</em> <strong>Dive Profile</strong> panel but please note that the deco
-calculated by <em>Subsurface</em> will most likely differ from the one displayed on
-the DR5.</td>
-</tr></table>
+calculated by <em>Subsurface</em> will most likely differ from the one displayed on
+the DR5.</td>
+</tr></table>
</div>
</div>
<div class="sect2">
@@ -5583,18 +5629,18 @@ the DR5.</td>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/HW_xdeepblack.jpg" alt="Note" />
-</td>
-<td class="content">Each dive has to be individually saved as UDDF file using "Export UDDF"
+<img src="images/icons/HW_xdeepblack.jpg" alt="Note" />
+</td>
+<td class="content">Each dive has to be individually saved as UDDF file using "Export UDDF"
option in BLACK&#8217;s logbook menu. When mounted as a USB drive UDDF files are
available in LOGBOOK directory. Note: The xDEEP BLACK saves NDL time but
does not seem to store gradient factors nor deco information, so for
<em>Subsurface</em> it is not possible to display them. Adjust the gradient factors
in the <em>Graph Settings</em> in <em>Subsurface</em> to generate a deco overlay in the
<em>Subsurface</em> <strong>Dive Profile</strong> panel but please note that the deco calculated
-by <em>Subsurface</em> will most likely differ from the one displayed on the xDEEP
-BLACK.</td>
-</tr></table>
+by <em>Subsurface</em> will most likely differ from the one displayed on the xDEEP
+BLACK.</td>
+</tr></table>
</div>
</div>
<div class="sect2">
@@ -5602,9 +5648,9 @@ BLACK.</td>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/predator.jpg" alt="Note" />
-</td>
-<td class="content">Using a Shearwater Predator one may be able to pair Bluetooth but then
+<img src="images/icons/predator.jpg" alt="Note" />
+</td>
+<td class="content">Using a Shearwater Predator one may be able to pair Bluetooth but then
encounter issues when downloading, showing errors like <em>Slip RX: unexp. SLIP
END</em> on the Predator. This might also arise when using other dive log
software and operating systems other than Linux. We have no detailed idea
@@ -5626,9 +5672,9 @@ switch to different Bluetooth drivers for the same hardware
</li>
<li>
<p>
-switch off WiFi while using Bluetooth
-</p>
-</li>
+switch off WiFi while using Bluetooth
+</p>
+</li>
</ul></div>
</div>
<div class="sect2">
@@ -5636,9 +5682,9 @@ switch off WiFi while using Bluetooth
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/MkVI.jpeg" alt="Note" />
-</td>
-<td class="content">Download of dive logs from the MkVI is performed using a custom
+<img src="images/MkVI.jpeg" alt="Note" />
+</td>
+<td class="content">Download of dive logs from the MkVI is performed using a custom
communications adapter and the <em>Poseidon PC Configuration Software</em>,
obtained when purchasing the MKVI equipment. The latter is a Windows
application allowing configuration of equipment and storage of dive
@@ -5664,19 +5710,19 @@ Dive log details (file with a .csv extension)
Redbook format dive log (file with .cvsr extension). This is a compressed
version of the dive log using a proprietary format.
</p>
-</li>
-</ul></div>
-<div class="paragraph"><p><em>Subsurface</em> accesses the .txt and the .csv files to obtain dive log
+</li>
+</ul></div>
+<div class="paragraph"><p><em>Subsurface</em> accesses the .txt and the .csv files to obtain dive log
information.</p></div>
</div>
<div class="sect2">
-<h3 id="_importing_from_apd_inspiration_ccr">17.7. Importing from APD Inspiration CCR</h3>
+<h3 id="_importing_from_apd_inspiration_evolution_ccr">17.7. Importing from APD Inspiration/Evolution CCR</h3>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/APDComputer.jpg" alt="Note" />
-</td>
-<td class="content">The dive logs of an APD Inspiration or similar CCR dive computer are
+<img src="images/APDComputer.jpg" alt="Note" />
+</td>
+<td class="content">The dive logs of an APD Inspiration or similar CCR dive computer are
downloaded using a communications adapter and <em>AP Communicator</em>, obtained
when purchasing the equipment. The dive logs can be viewed using the <em>AP Log
Viewer</em>, within Windows or Mac/OS. However, APD logs can be viewed and
@@ -5685,66 +5731,89 @@ of dive computer). The APD inspiration dive logs are imported into
<em>Subsurface</em> as follows:</td>
</tr></table>
</div>
-<div class="ulist"><ul>
-<li>
-<p>
-Open a dive within the <em>AP Log Viewer</em>.
-</p>
-</li>
+<div class="ulist"><ul>
+<li>
+<p>
+Download the dive using <em>AP Communicator</em>.
+</p>
+</li>
+<li>
+<p>
+Open a dive within the <em>AP Log Viewer</em>.
+</p>
+</li>
<li>
<p>
Select the tab at the top of the screen, entitled "<em>Data</em>".
</p>
-</li>
-<li>
-<p>
-If the raw dive log data show on the screen, click on "<em>Copy to Clipboard</em>".
-</p>
-</li>
-<li>
-<p>
-Open a text editor, e.g. Notepad (Windows), TextWrangler (Mac).
-</p>
-</li>
-<li>
-<p>
-Copy the contents of the clipboard into the text editor and save the text
- file with a filename extension of .CSV
-</p>
-</li>
-<li>
+</li>
+<li>
+<p>
+With the raw dive log data show on the screen, click on "<em>Copy to
+ Clipboard</em>".
+</p>
+</li>
+<li>
+<p>
+Open a text editor, e.g. Notepad (Windows) or TextWrangler (Mac).
+</p>
+</li>
+<li>
+<p>
+Copy the contents of the clipboard into the text editor and save the text
+ file with a filename extension of <em>.apd</em>
+</p>
+</li>
+<li>
<p>
Within <em>Subsurface</em>, select <em>Import &#8594; Import log files</em> to open the
<a href="#Unified_import">universal import dialogue</a>.
</p>
-</li>
-<li>
-<p>
-In the dropdown list towards the bottom right of the dialogue, select "<em>CSV
- files</em>".
-</p>
-</li>
-<li>
-<p>
-On the list of file names select the .CSV file that has been created
- above. An import dialogue opens.
-</p>
-</li>
-<li>
-<p>
-In the dropdown list on the top left labeled '<em>Pre-configured imports</em>",
- select <em>APD Log Viewer</em>.
-</p>
-</li>
-<li>
-<p>
-Ensure the other settings for the ADP dive log are appropriate, then select
- <em>OK</em>.
-</p>
-</li>
-</ul></div>
-<div class="paragraph"><p>The APD dive log will appear within <em>Subsurface</em>.</p></div>
-</div>
+</li>
+<li>
+<p>
+In the dropdown list towards the bottom right of the dialogue (labled
+ <em>Filter:</em>), select "APD log viewer".
+</p>
+</li>
+<li>
+<p>
+On the list of file names select the <em>.apd</em> file that has been created
+ above. An import dialogue opens indicating the default settings for the data
+ in the <em>.apd</em> file. If any changes are required, do this as for
+ <a href="#S_ImportingCSVDives">CSV imports</a>.
+</p>
+</li>
+</ul></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/APD_CSVimportF22.jpg" alt="Figure: APD log viewer import" />
+</div>
+</div>
+<div class="ulist"><ul>
+<li>
+<p>
+The top left hand dropdown box in the import panel allows one to select the
+ APD dive computer for which the dive log needs to be imported. The default
+ it is DC1, <em>i.e.</em> the first of the two dive computers the APD uses. It is
+ possible to sequentially import the data for both dive computers by first
+ importing CD1 and then DC2.(<strong>Hint</strong>: The logs for the two dive computers are
+ viewed by selecting <em>View &#8594; Next DC</em> from the Main Menu after the uploading
+ has been completed)
+</p>
+</li>
+<li>
+<p>
+Click the <em>Ok</em> button at the bottom of the import panel.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>The APD dive log will appear within <em>Subsurface</em>. The dive
+computer-generated ceiling generated by the Inspiration can be viewed by
+selecting the appropriate button on the left of the <strong>Dive Profile</strong>. Cylinder
+pressure data are not logged by the APD equipment but can be manually
+entered in the <em>Equipment</em> Tab.</p></div>
+</div>
</div>
</div>
<div class="sect1">
@@ -5752,9 +5821,9 @@ Ensure the other settings for the ADP dive log are appropriate, then select
<div class="sectionbody">
<div class="paragraph"><p>The import of dive log data from external dive log software is mostly
performed using the dialogue found by selecting <em>Import</em> from the Main Menu,
-then clicking on <em>Import Log Files</em>. This is a single-step process, more
-information about which can be found <a href="#Unified_import">here.</a> However, in
-some cases, a two-step process may be required:</p></div>
+then clicking on <em>Import Log Files</em>. This is a single-step process, more
+information about which can be found <a href="#Unified_import">here.</a> However, in
+some cases, a two-step process may be required:</p></div>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
@@ -5766,9 +5835,9 @@ Export the foreign dive log data to format that is accessible from
<p>
Import the accessible dive log data into <em>Subsurface</em>.
</p>
-</li>
-</ol></div>
-<div class="paragraph"><p>This appendix provides some information about approaches to export dive log
+</li>
+</ol></div>
+<div class="paragraph"><p>This appendix provides some information about approaches to export dive log
data from foreign dive log software. The procedures below mostly apply to
Linux and/or Windows.</p></div>
<div class="sect2">
@@ -5776,9 +5845,9 @@ Linux and/or Windows.</p></div>
<div class="admonitionblock">
<table><tr>
<td class="icon">
-<img src="images/icons/suuntologo.jpg" alt="Note" />
-</td>
-<td class="content">DiveManager is a MS Windows application for Suunto dive computers.
+<img src="images/icons/suuntologo.jpg" alt="Note" />
+</td>
+<td class="content">DiveManager is a MS Windows application for Suunto dive computers.
Divemanager 3 (DM3) is an older version of the Suunto software. More recent
Suunto dive computers use Divemanager version 4 or 5 (DM4 or DM5). The
different versions of Divemanager use different methods and different file
@@ -5800,9 +5869,9 @@ Do not start the import wizard to import dives from the dive computer.
<li>
<p>
In the navigation tree on the left side of the program-window, select the
- appropriate dives.
-</p>
-</li>
+ appropriate dives.
+</p>
+</li>
<li>
<p>
Within the list of dives, select the dives you would like to import later:
@@ -5829,9 +5898,9 @@ With the dives marked, use the program menu <em>File &#8594; Export</em>
<li>
<p>
The export pop-up will show. Within this pop-up, there is one field called
- <em>Export Path</em>.
-</p>
-<div class="ulist"><ul>
+ <em>Export Path</em>.
+</p>
+<div class="ulist"><ul>
<li>
<p>
Click the browse button next to the field Export Path
@@ -5936,9 +6005,9 @@ Click <em>Save</em>
</li>
<li>
<p>
-The dives are now exported to the file DM4.bak (or DM5.bak)
-</p>
-</li>
+The dives are now exported to the file DM4.bak (or DM5.bak)
+</p>
+</li>
</ol></div>
</div>
<div class="sect2">
@@ -5946,14 +6015,14 @@ The dives are now exported to the file DM4.bak (or DM5.bak)
<div class="admonitionblock" id="Atomic_Export">
<table><tr>
<td class="icon">
-<img src="images/icons/atomiclogo.jpg" alt="Note" />
-</td>
-<td class="content">Atomic Logbook is a Windows software by Atomic Aquatics. It allows
+<img src="images/icons/atomiclogo.jpg" alt="Note" />
+</td>
+<td class="content">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
-C:\ProgramData\AtomicsAquatics\Cobalt-Logbook\Cobalt.db. This file can be
-directly imported to Subsurface.</td>
-</tr></table>
+C:\ProgramData\AtomicsAquatics\Cobalt-Logbook\Cobalt.db. This file can be
+directly imported to Subsurface.</td>
+</tr></table>
</div>
</div>
<div class="sect2">
@@ -5961,9 +6030,9 @@ directly imported to Subsurface.</td>
<div class="admonitionblock" id="Mares_Export">
<table><tr>
<td class="icon">
-<img src="images/icons/mareslogo.jpg" alt="Note" />
-</td>
-<td class="content">Mares Dive Organiser is a Windows application. The dive log is kept as a
+<img src="images/icons/mareslogo.jpg" alt="Note" />
+</td>
+<td class="content">Mares Dive Organiser is a Windows application. The dive log is kept as a
Microsoft SQL Compact Edition database with a <em>.sdf</em> filename extension. The
database includes all Dive Organiser-registered divers on the particular
computer and all Mares dive computers used. The safest way to obtain a copy
@@ -5992,9 +6061,9 @@ Extract the <em>.sdf</em> file from the zipped folder to your Desktop.
</li>
<li>
<p>
-The password for accessing the .zip file is <em>mares</em>.
-</p>
-</li>
+The password for accessing the .zip file is <em>mares</em>.
+</p>
+</li>
</ol></div>
</div>
<div class="sect2">
@@ -6046,9 +6115,9 @@ the log file in Subsurface.</p></div>
</div>
</div>
<div class="sect1">
-<h2 id="S_Appendix_D">19. ANNEXE D : Exporter un tableur vers le format CSV</h2>
+<h2 id="_annexe_d_exporter_un_tableur_vers_le_format_csv">19. ANNEXE D : Exporter un tableur vers le format CSV</h2>
<div class="sectionbody">
-<div class="paragraph"><p>De nombreux plongeurs conservent un carnet de plongée sous forme de fichier
+<div class="paragraph" id="S_Appendix_D"><p>De nombreux plongeurs conservent un carnet de plongée sous forme de fichier
numérique, souvent un tableur avec différents champs et informations. Ces
données peuvent facilement être importées dans <em>Subsurface</em> après que le
tableur a été converti en fichier CSV. Cette section explique la procedure
@@ -6104,9 +6173,9 @@ this:</p></div>
<div class="imageblock" style="text-align:center;">
<div class="content">
<img src="images/LOffice_spreadsheetdata.jpg" alt="FIGURE: Spreadsheet data" />
-</div>
-</div>
-<div class="paragraph"><p>To export the data as a .CSV file from within LibreOffice click <em>File &#8594;
+</div>
+</div>
+<div class="paragraph"><p>To export the data as a .CSV file from within LibreOffice click <em>File &#8594;
Save As</em>. On the dialogue that comes up, select the <em>Text CSV (.csv)</em> as the
file type and select the option <em>Edit filter settings</em>.</p></div>
<div class="imageblock" style="text-align:center;">
@@ -6121,9 +6190,9 @@ then select <em>OK</em>.</p></div>
<div class="content">
<img src="images/LOffice_field_options.jpg" alt="FIGURE: Field options" />
</div>
-</div>
-<div class="paragraph"><p>One can double check the .CSV file by opening it with a text editor, and
-then import the dive data as explained on the section
+</div>
+<div class="paragraph"><p>One can double check the .CSV file by opening it with a text editor, and
+then import the dive data as explained on the section
<a href="#S_ImportingCSVDives">Importing CSV dives</a>.</p></div>
</div>
<div class="sect2">
@@ -6131,9 +6200,9 @@ then import the dive data as explained on the section
<div class="paragraph"><p>The field delimiter (called "<em>list separator</em>" in Microsoft manuals) is not
accessible from within <em>Excel</em> and needs to be set through the <em>Microsoft
Control Panel</em>. After changing the separator character, all software on the
-Windows machine use the new character as a separator. One can change the
-character back to the default character by following the same procedure,
-outlined below.</p></div>
+Windows machine use the new character as a separator. One can change the
+character back to the default character by following the same procedure,
+outlined below.</p></div>
<div class="ulist"><ul>
<li>
<p>
@@ -6191,94 +6260,66 @@ the appropriate folder has been selected to save the CSV file into.</p></div>
</div>
<div class="paragraph"><p>Select the <em>Save</em> button. The CSV-formatted file is saved into the folder
that was selected. One can double check the .CSV file by opening it with a
-text editor, and then import the dive data as explained on the section
-<a href="#S_ImportingCSVDives">Importing CSV dives</a>.</p></div>
-</div>
+text editor, and then import the dive data as explained on the section
+<a href="#S_ImportingCSVDives">Importing CSV dives</a>.</p></div>
+</div>
</div>
</div>
<div class="sect1">
-<h2 id="_appendix_e_faqs">20. APPENDIX E: FAQs.</h2>
+<h2 id="S_APPENDIX_E">20. ANNEXE E : Créer un modèle d&#8217;impression personnalisé</h2>
<div class="sectionbody">
-<div class="sect2">
-<h3 id="_subsurface_appears_to_miscalculate_gas_consumption_and_sac">20.1. Subsurface appears to miscalculate gas consumption and SAC</h3>
-<div class="paragraph" id="SAC_CALCULATION"><p><em>Question</em>: I dived with a 12.2 l tank, starting with 220 bar and ending
-with 100 bar, and I calculate a different SAC compared what <em>Subsurface</em>
-calculates. Is <em>Subsurface</em> miscalculating?</p></div>
-<div class="paragraph"><p><em>Answer</em>: Not really. What happens is that <em>Subsurface</em> actually calculates
-gas consumption differently - and better - than you expect. In particular,
-it takes the incompressibility of the gas into account. Traditionally, Gas
-consumption and SAC should be: <code>consumption = tank size x (start pressure -
-end pressure)</code></p></div>
-<div class="paragraph"><p>and that&#8217;s true for an ideal gas, and it&#8217;s what you get taught in dive
-theory. But an "ideal gas" doesn&#8217;t actually exist, and real gases actually
-don&#8217;t compress linearly with pressure. Also, you are missing the fact that
-one atmosphere of pressure isn&#8217;t actually one bar. So the <strong>real</strong>
-calculation is:</p></div>
-<div class="paragraph"><p><code>consumption = (amount_of_air_at_beginning - amount_of_air_at_end)</code></p></div>
-<div class="paragraph"><p>where the amount of air is <strong>not</strong> just "tank size times pressure in bar".
-It&#8217;s a combination of: "take compressibility into account" (which is a
-fairly small issue under 220 bar - you&#8217;ll see more differences when you do
-high-pressure tanks with 300bar) and "convert bar to atm" (which is the
-majority of your discrepancy). Remember: one ATM is ~1.013 bar, so without
-the compressibility, your gas use is:</p></div>
-<div class="paragraph"><p><code>12.2*((220-100)/1.013)</code></p></div>
-<div class="paragraph"><p>which is about 1445, not 1464. So there was 19 l too much in your simple
-calculation that ignored the difference between 1 bar and one ATM. The
-compressibility does show up above 200 bar, and takes that 1445 down about
-eight litres more, so you really did use only about 1437 l of air at surface
-pressure.</p></div>
-<div class="paragraph"><p>So be happy: your SAC really is better than your calculations indicated. Or
-be sad: your cylinder contains less air than you thought it did. And as
-mentioned, the "contains less air than you thought it did" really starts
-becoming much more noticeable at high pressure. A 400 bar really does not
-contain twice as much air as a 200 bar one. At lower pressures, air acts
-pretty much like an ideal gas.</p></div>
-</div>
-<div class="sect2">
-<h3 id="_some_dive_profiles_have_time_discrepancies_with_the_recorded_samples_from_my_dive_computer_8230">20.2. Some dive profiles have time discrepancies with the recorded samples from my dive computer&#8230;</h3>
-<div class="paragraph"><p><em>Subsurface</em> ends up ignoring surface time for many things (average depth,
-divetime, SAC, etc). <em>Question</em>: Why do dive durations in my dive computer
-differ from that given by <em>Subsurface</em>?</p></div>
-<div class="paragraph"><p><em>Answer</em>: For example, if you end up doing a weight check (deep enough to
-trigger the "dive started") but then come back up and wait five minutes for
-your buddies, your dive computer may say that your dive is 50 minutes long -
-because you have fifty minutes worth of samples - but subsurface will say
-it&#8217;s 45 minutes - because you were actually diving for 45 minutes. It&#8217;s
-even more noticeable if you do things like divemastering the initial OW
-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 class="paragraph"><p><em>Subsurface</em> provides a mechanism to create or modify templates for printing
+dive logs in order to produce customised printouts of dive logs. Templates,
+written in HTML as well as a simple Grantlee instruction set, are rendered
+to the print device by <em>Subsurface</em>.</p></div>
+<div class="paragraph"><p>Templates are accessed using the print dialogue (see image <strong>B</strong> below).</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Print1_f22.jpg" alt="FIGURE: Print dialogue" />
</div>
-<div class="sect2">
-<h3 id="_some_dive_profiles_are_missing_from_the_download">20.3. Some dive profiles are missing from the download</h3>
-<div class="paragraph" id="DC_HISTORY"><p><em>Question</em>: I cannot download all my dives, only the most recent ones even
-though my dive computer&#8217;s manual states that it records history of e.g. 999
-dives.</p></div>
-<div class="paragraph"><p><em>Answer</em>: Dive history is different than the dive profiles on the log. The
-history only keeps track of the total number of dives and total amount of
-time spent below surface. The logs, on the other hand, store the dive
-profile, but they have limited amount of memory to do so. The exact amount
-of dive profiles that can be stored on the device depend on sample interval
-and duration of the dives. Once the memory is full the oldest dives get
-overwritten with new dives. Thus we are only able to download the last 13,
-30 or 199 dives.</p></div>
-<div class="paragraph"><p>If you have downloaded your dives to different dive logging software before
-they were overwritten, there is a high change that Subsurface can import
-these. However, if the logs are only on your dive computer, they cannot be
-salvaged after being over written by new dives.</p></div>
</div>
+<div class="paragraph"><p>The buttons under the <em>Template</em> dropdown box allows one to <em>Edit</em>,
+<em>Delete</em>, <em>Import</em> and to <em>Export</em> templates (see image <strong>A</strong> above). New or
+modified templates are stored as HTML files in the same directory as the
+dive log being processed. In order to create or modify a template, select
+the <em>Custom</em> template from the template dropdown list in the print dialogue
+(see image <strong>B</strong> above), then select <em>Edit</em>.</p></div>
+<div class="paragraph"><p>The Edit Panel comprises three tabs:</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Template1_f22.jpg" alt="FIGURE: template edit dialogue" />
+</div>
+</div>
+<div class="paragraph"><p>1) The <em>Style</em> tab (image <strong>A</strong> above) controls the font, line spacing and colour
+ template used for printing the dive log. The style attributes are
+ editable. Choose one of the four colour palets used for colour printing.</p></div>
+<div class="paragraph"><p>2) The <em>Colors</em> tab (image <strong>B</strong> above) allows editing the colours used for
+ printing the dive log. The colours are highly customisable: the <em>Edit</em>
+ buttons in the <em>Colors</em> tab allows choosing abritrary colours for different
+ components of the dive log printout.</p></div>
+<div class="paragraph"><p>3) The <em>Template</em> tab of the Edit Panel (see image below) allows creating a
+ template using HTML as well as a few Grantlee programming
+ primitives. Grantlee provides the ability to create and format HTML code in
+ a highly simple but efficient way (see below). The HTML of the template can
+ be edited and saved. The saved template is stored in the same directory as
+ the dive being processed. By default, a <em>Custom</em> template is a skeleton with
+ no specific print instructions. The informastion being printed needs to be
+ specified and formatted in the by replacing the section marked with: "&lt;!--
+ Template must be filled -&#8594;". Writing HTML code with Grantlee instructions
+ allows unlimited freedom in determining what is printed an in which way it
+ should be rendered.</p></div>
+<div class="imageblock" style="text-align:center;">
+<div class="content">
+<img src="images/Template2_f22.jpg" alt="FIGURE:Template tab" />
</div>
</div>
-<div class="sect1">
-<h2 id="_appendix_f_write_a_custom_printing_template">21. APPENDIX F: Write a custom printing template</h2>
-<div class="sectionbody">
-<div class="paragraph"><p><em>Subsurface</em> provides a customizable printing support which is based on
-templates that are transformed by the <em>Grantlee</em> backend to correct <em>HTML</em>
-syntax, The <em>HTML</em> output is then rendered by <em>Subsurface</em>.</p></div>
+<div class="paragraph"><p>One can adapt any of the existing templates and save it to the dive log
+directory. The standard templates (e.g. One dive, Six dives, Table) can be
+modified in this way.</p></div>
<div class="paragraph"><p>To write a custom template the following elements must exist so that the
template will be correctly handled and rendered.</p></div>
<div class="sect2">
-<h3 id="_main_dive_loop">21.1. Main dive loop</h3>
+<h3 id="_main_dive_loop">20.1. Main dive loop</h3>
<div class="paragraph"><p><em>Subsurface</em> exports a dive list called (<strong>dives</strong>) to the <em>Grantlee</em>
backend. It is possible to iterate over the list as follows:</p></div>
<div class="literalblock">
@@ -6299,7 +6340,7 @@ backend. It is possible to iterate over the list as follows:</p></div>
<a href="http://www.grantlee.org/apidox/for_themers.html">here</a></p></div>
</div>
<div class="sect2">
-<h3 id="_grantlee_exported_variables">21.2. Grantlee exported variables</h3>
+<h3 id="_grantlee_exported_variables">20.2. Grantlee exported variables</h3>
<div class="paragraph"><p>Only a subset of the dive data is exported:</p></div>
<div class="tableblock">
<table rules="all"
@@ -6485,7 +6526,7 @@ cellspacing="0" cellpadding="4">
</div></div>
</div>
<div class="sect2">
-<h3 id="_defined_css_selectors">21.3. Defined CSS selectors</h3>
+<h3 id="_defined_css_selectors">20.3. Defined CSS selectors</h3>
<div class="paragraph"><p>As the dive profile is placed after rendering, <em>Subsurface</em> uses a special
<em>CSS</em> selectors to do some searches in the HTML output. The <em>CSS</em> selectors
in the following table should be added.</p></div>
@@ -6533,7 +6574,7 @@ data-numberofdives = 0).</td>
</div>
</div>
<div class="sect2">
-<h3 id="_special_attributes">21.4. Special attributes</h3>
+<h3 id="_special_attributes">20.4. Special attributes</h3>
<div class="paragraph"><p>There are two ways of rendering- either rendering a specific number of dives
in each page or make <em>Subsurface</em> try to fit as much dives as possible into
one page (<em>flow</em> rendering).</p></div>
@@ -6573,11 +6614,84 @@ page size.</td>
</div>
</div>
</div>
+<div class="sect1">
+<h2 id="_appendix_f_faqs">21. APPENDIX F: FAQs.</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="S_APPENDIX_F">21.1. Subsurface appears to miscalculate gas consumption and SAC</h3>
+<div class="paragraph" id="SAC_CALCULATION"><p><em>Question</em>: I dived with a 12.2 l tank, starting with 220 bar and ending
+with 100 bar, and I calculate a different SAC compared what <em>Subsurface</em>
+calculates. Is <em>Subsurface</em> miscalculating?</p></div>
+<div class="paragraph"><p><em>Answer</em>: Not really. What happens is that <em>Subsurface</em> actually calculates
+gas consumption differently - and better - than you expect. In particular,
+it takes the incompressibility of the gas into account. Traditionally, Gas
+consumption and SAC should be: <code>consumption = tank size x (start pressure -
+end pressure)</code></p></div>
+<div class="paragraph"><p>and that&#8217;s true for an ideal gas, and it&#8217;s what you get taught in dive
+theory. But an "ideal gas" doesn&#8217;t actually exist, and real gases actually
+don&#8217;t compress linearly with pressure. Also, you are missing the fact that
+one atmosphere of pressure isn&#8217;t actually one bar. So the <strong>real</strong>
+calculation is:</p></div>
+<div class="paragraph"><p><code>consumption = (amount_of_air_at_beginning - amount_of_air_at_end)</code></p></div>
+<div class="paragraph"><p>where the amount of air is <strong>not</strong> just "tank size times pressure in bar".
+It&#8217;s a combination of: "take compressibility into account" (which is a
+fairly small issue under 220 bar - you&#8217;ll see more differences when you do
+high-pressure tanks with 300bar) and "convert bar to atm" (which is the
+majority of your discrepancy). Remember: one ATM is ~1.013 bar, so without
+the compressibility, your gas use is:</p></div>
+<div class="paragraph"><p><code>12.2*((220-100)/1.013)</code></p></div>
+<div class="paragraph"><p>which is about 1445, not 1464. So there was 19 l too much in your simple
+calculation that ignored the difference between 1 bar and one ATM. The
+compressibility does show up above 200 bar, and takes that 1445 down about
+eight litres more, so you really did use only about 1437 l of air at surface
+pressure.</p></div>
+<div class="paragraph"><p>So be happy: your SAC really is better than your calculations indicated. Or
+be sad: your cylinder contains less air than you thought it did. And as
+mentioned, the "contains less air than you thought it did" really starts
+becoming much more noticeable at high pressure. A 400 bar really does not
+contain twice as much air as a 200 bar one. At lower pressures, air acts
+pretty much like an ideal gas.</p></div>
+</div>
+<div class="sect2">
+<h3 id="_some_dive_profiles_have_time_discrepancies_with_the_recorded_samples_from_my_dive_computer_8230">21.2. Some dive profiles have time discrepancies with the recorded samples from my dive computer&#8230;</h3>
+<div class="paragraph"><p><em>Subsurface</em> ends up ignoring surface time for many things (average depth,
+divetime, SAC, etc). <em>Question</em>: Why do dive durations in my dive computer
+differ from that given by <em>Subsurface</em>?</p></div>
+<div class="paragraph"><p><em>Answer</em>: For example, if you end up doing a weight check (deep enough to
+trigger the "dive started") but then come back up and wait five minutes for
+your buddies, your dive computer may say that your dive is 50 minutes long -
+because you have fifty minutes worth of samples - but subsurface will say
+it&#8217;s 45 minutes - because you were actually diving for 45 minutes. It&#8217;s
+even more noticeable if you do things like divemastering the initial OW
+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 class="sect2">
+<h3 id="_some_dive_profiles_are_missing_from_the_download">21.3. Some dive profiles are missing from the download</h3>
+<div class="paragraph" id="DC_HISTORY"><p><em>Question</em>: I cannot download all my dives, only the most recent ones even
+though my dive computer&#8217;s manual states that it records history of e.g. 999
+dives.</p></div>
+<div class="paragraph"><p><em>Answer</em>: Dive history is different than the dive profiles on the log. The
+history only keeps track of the total number of dives and total amount of
+time spent below surface. The logs, on the other hand, store the dive
+profile, but they have limited amount of memory to do so. The exact amount
+of dive profiles that can be stored on the device depend on sample interval
+and duration of the dives. Once the memory is full the oldest dives get
+overwritten with new dives. Thus we are only able to download the last 13,
+30 or 199 dives.</p></div>
+<div class="paragraph"><p>If you have downloaded your dives to different dive logging software before
+they were overwritten, there is a high change that Subsurface can import
+these. However, if the logs are only on your dive computer, they cannot be
+salvaged after being over written by new dives.</p></div>
+</div>
+</div>
+</div>
</div>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2015-09-01 14:25:48 CEST
+Last updated 2015-09-08 10:31:18 CEST
</div>
</div>
</body>