mifr/subsurface
1
0
Fork 0
mirror of https://github.com/subsurface/subsurface.git synced 2025-02-19 22:16:15 +00:00
Code Issues Projects Releases Packages Wiki Activity

Documentation: update french translation of user-manual

Browse source 
Signed-off-by: Guillaume GARDET <guillaume.gardet@free.fr>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
Guillaume GARDET 2015-10-13 20:43:15 +02:00 • committed by Dirk Hohndel
parent 8d2d7cd4a3
commit 409df339b8
4 changed files with 2815 additions and 2564 deletions
Download patch file Download diff file Expand all files Collapse all files

304
Documentation/user-manual_fr.txt
View file

@ -350,7 +350,7 @@ image::images/DC_import_f20.jpg["FIGURE: Download dialogue 1", align="center"]
Dive computers tend to keep a certain number of dives in their memory, even
though these dives have already been imported to _Subsurface_. For that
reason, if the divecomputer allows this, _Subsurface_ only imports dives
reason, if the dive computer allows this, _Subsurface_ only imports dives
that have not been uploaded before. This makes the download process faster
on most dive computers and also saves battery power of the dive computer (at
least for those not charging while connected via USB).
@ -403,7 +403,7 @@ least for those not charging while connected via USB).
could be inaccurate as we cannot determine how much downloadable data there
is until all data have been downloaded). After successful download, Dialogue
*B* in the figure above appears. After the dives have been downloaded, they
appear in a tabular format on the righthand side of the dialogue (see image
appear in a tabular format on the right-hand side of the dialogue (see image
*B*, above). Each dive comprises a row in the table, with the date, duration
and depth shown. Next to each dive is a checkbox: check all the dives that
need to be transferred to the *Dive List*. In the case of the image above,
@ -504,7 +504,7 @@ _"Choose Bluetooth download mode"_, the dialogue below appears.
image::images/DC_import_Bluetooth.jpg["FIGURE: Download Bluetooth", align="center"]
On the _Linux_ or _MacOS_ platforms the name of the _Subsurface_ computer
and its Bluetooth address are shown on the righthand side, On the lefthand
and its Bluetooth address are shown on the right-hand side, On the lefthand
side, if the computer has connected more than one local Bluetooth devices
the user can use the list box to indicate which one needs to connect to
_Subsurface_. The power state (on/off) of the Bluetooth adapter is shown
@ -562,15 +562,16 @@ downloaded dives are shown on the righthand side of the download dialogue.
===== Sur Windows :
image::images/DC_import_Bluetooth_Windows.png["FIGURE: Download Bluetooth on Windows", align="center"]
On _Windows_ platforms the _Local Bluetooth device details section_ on the
left is not displayed. To successfully initiate a scan (by pressing the
right is not displayed. To successfully initiate a scan (by pressing the
_Scan_ button) check that the Bluetooth device on the _Subsurface_ computer
is turned on.
The pairing step is checked and done automatically during the download
process. If the devices have never been paired the system will ask for your
permissions and put a message on the right side of the screen: _Add a
device, Tap to setup your DC device_. Always allow this pairing. After a
device, Tap to set up your DC device_. Always allow this pairing. After a
discovered item is selected, select the _Save_ button. Finally select the
_Download_ button on the _Download_ dialogue and wait for the process to
complete.
@ -649,7 +650,7 @@ information. The *Time* field reflects the date and time of the dive. By
clicking the date, a calendar is displayed from which one can choose the
correct date. Press ESC to close the calendar. The time values (hour and
minutes) can also be edited directly by clicking on each of them in the text
box and by overtyping the information displayed.
box and by over-typing the information displayed.
*Air/water temperatures*: Air and water temperatures during the dive are shown
in text boxes to the right of the Start time. Many dive computers supply water
@ -662,33 +663,45 @@ automatically supplied by
_Subsurface_ (following the _Preferences_, metric or imperial units will
be used).
*Location*: Here the name of the dive site can be entered, e.g. "Tihany, Lake
Balaton, Hungary". Dive locations are managed as a separate part of the dive log.
After entering the information for a particular dive site, and several dives are
performed at the same location, the information is re-used without requiring
full dive site information again. Existing dive location information
can be edited at any time by selecting (on the *Dive List* panel) a dive performed at that site
and by opening the location information by clicking the globe button on the
right of the location name (see image on the right, above). When entering a dive location name, auto location of
dive site names makes it easy to select a dive site that already exists in the dive log
(i.e. when typing the name of a dive site,
a dropdown list appears showing all sites with similar names). If the dive
site has been used before, click on the already-existing name.
*Location*:
[icon="images/icons/warning2.png"]
[WARNING]
Dive locations are managed as a *separate* part of the dive log. The dive
information in the *Notes* and *Equipment* tabs can therefore not be edited
at the same time as the dive site information. Save all the other dive
information (e.g. divemaster, buddy, protective gear, notes about the dive)
by selecting _Apply changes_ on the *Notes* tab before editing the dive site
information. Only then, supply a dive site name in the textbox labelled
_Location_ on the *Notes* tab.
If the present dive site has not been used before, a message appears as
follows (image *A* below):
Type the name of the dive site, e.g. "Tihany, Lake Balaton, Hungary". If
several dives are performed at the same location, the dive site information
for the first dive is re-used. Existing dive location information can be
edited at any time by selecting (on the *Dive List* panel) a dive performed
at that site and by opening the location information by clicking the globe
button on the right of the location name (see image on the right,
above). When entering a dive location name, auto location of dive site names
makes it easy to select an existing dive site name (i.e. when typing the
name of a dive site, a dropdown list appears showing all sites with similar
names). If the dive site has been used before, click on the already-existing
name. The dive site names in the dropdown list contain either a globe
symbol (indicating existing dive sites in the _Subsurface_ database) or a
*+* symbol (indicating dive site names that appear consistent with the
current dive site name but which have not been added to the dive site
database). Therefore, if the present dive site has not been used before, a
message appears as follows (image *A* below):
image::images/Locations1_f22.jpg["FIGURE:Location description panel", align="center"]
Click the + icon on the right hand side. A panel appears to enter the
Doubleclick on the new dive site name. A panel appears to enter the
coordinates and other important information about the site (image *B*,
above). The most important items are the coordinates of the site. There are
three ways of specifying the coordinates:
a. One can find the coordinates on the world map in the bottom right hand part
of the Subsurface window. The map displays an orange bar indicating "No
of the _Subsurface_ window. The map displays an orange bar indicating "No
location data - Move the map and double-click to set the dive
location". Upon a double-click at the appropriate place, the orange bar
location". Upon a doubleclick at the appropriate place, the orange bar
disappears and the coordinates are stored.
b. The coordinates can be obtained from the _Subsurface_ Companion app if the
@ -708,14 +721,26 @@ Southern hemisphere latitudes are given with a *S*, e.g. S30°, or with a
negative value, e.g. -30.22496. Similarly western longitudes are given with
a *W*, e.g. W07°, or with a negative value, e.g. -7.34323. Some keyboards
don't have the degree sign (°). It can be replaced by a *d* like this: N30d
W20d.
W20d. If both a dive site name and coordinates have been provided, Save the
dive site information by selecting the button _Apply changes_ at the top of
the panel.
*Important*: 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
name - so *saving* a dive site with only coordinates and no dive site name
causes unexpected behaviour (Subsurface will think that all of these
dives have the same location and try to keep their GPS coordinates the
same).
*Dive site name lookup:* If coordinates have been typed into the appropriate
text box, one can perform an automated name lookup based on the coordinates.
This is achieved when _Subsurface_ uses the Internet to find the name of the dive site
based on the coordinates that were typed. If a name has been found, it is
automatically inserted into the tags box. The list box
(Titled _Dive sites on same coordinates_") at the bottom
of the dive site panel contains the names of other dives sites used at the
current location. For instance if the dive site is "Blue Hole" and there are several
dive sites named "Blue Hole", all these sites are listed in this list box.
Enter any other textual information about the dive site (Description and
Notes), then select _Apply Changes_ to save the geolocation for this dive
site. At a later stage the dive site information can be edited by clicking
@ -1101,7 +1126,7 @@ b. Which data columns need to be imported into _Subsurface_? Is it a _CSV dive
editor and note the titles of the columns to be imported and their column
positions.
c. Is the numeric information (e.g. dive depth) in metric or in imperial unis?
c. Is the numeric information (e.g. dive depth) in metric or in imperial units?
Armed with this information, importing the data into _Subsurface_ is
straightforward. Select _Import -> Import Log Files_ from the main menu. In
@ -1131,7 +1156,7 @@ _Subsurface_ expects the column heading for Dive number (" # ") to be "Dive
# ". If the column heading that _Subsurface_ expects is not in the blue row,
then drag the appropriate balloon from the upper area and drop it in the
appropriate blue cell at the top of the table. To indicate the correct
column for "Dive #", drag the ballooned item labeled "Dive # " and drop it
column for "Dive #", drag the ballooned item labelled "Dive # " and drop it
in the blue cell immediately above the white cell containing " # ". This is
depicted in the image below.
@ -1403,7 +1428,7 @@ The settings below define the behaviour of the service:
_How does the background service work?_ Assuming the user sets 5 minutes and
50 meters in the settings above, the app will start by recording a location
at the current location, followed by another one at every 5 minutes *or*
every time one moves 50m from previous location. If subsequent locations
every time one moves 50 m from previous location. If subsequent locations
are within a radius of 50 meters from the previous one, a new location is
not saved. If the user is not moving, only one location is saved, but if the
user is moving, a trace of the route is obtained by saving a location every
@ -1461,7 +1486,7 @@ can only add dives using the manual mechanism.
One can edit the site name afterwards by selecting the dive from the dive
list and clicking on the site name. There are no other editable fields. The
dive list is automatically uploaded from the iphone to the webservice and
dive list is automatically uploaded from the iPhone to the webservice and
there is not an option to trigger upload manually.
@ -1572,7 +1597,7 @@ image::images/LoadImage3b_f20.jpg["FIGURE: Synchronisation dialog", align="cente
the exact time the photograph was taken, using the metadata that the camera stores within
each photo. In order to do this, use the bottom half of the _Time shift_ dialog. If one uses
the bottom part, the top part of the dialog is ignored. Click on
the horizontal bar entitled "_Select image of divecomputer showing time_. This brings up
the horizontal bar entitled "_Select image of dive computer showing time_. This brings up
a file browser with which one can select the photograph of the dive computer time. Select the
photograph using the file browser and click on _OK_. This photograph of the dive computer
appears in the bottom panel of the _Shift times_ dialog. Now _Subsurface_ knows exactly
@ -1688,16 +1713,16 @@ This is achieved by selecting from the Main Menu: _File -> Find moved image
[icon="images/icons/important.png"]
[IMPORTANT]
Software for the automated finger print calculation of existing photo
collections is under development. Currently single dives must be upgraded
one at a time. Select the toolbar button on the *Dive profile* panel that
enables the display of images. The thumbnails of images are shown on the
dive profile. Then open the dive and change anything in the *Notes* panel
that brings up the blue edit bar at the top of the notes panel to save the
edits. For instance, add a space character at the end of the _Notes_ text
box and immediately delete that space character. Select the option _Apply
changes_ in the blue edit bar to save the dive information. Fingerprints
are calculated while saving this specific dive.
_Subsurface_ automatically calculates fingerprints for all images that can
be accessed by _Subsurface_. When manipulating images, ensure that all the
images associated with the dive log can be accessed by _Subsurface_.
_Subsurface_ automatically checks and, if necessary, updates the
fingerprints associated with a single dive if:
- The images associated with that dive are visible as thumbnails on the *Dive
Profile*.
- One edits anything in the *Notes tab* panel and save the edits by selecting
_Apply changes_.
****
@ -1708,10 +1733,10 @@ are calculated while saving this specific dive.
==== Multicylinder dives
_Subsurface_ easily handles dives involving more than one
cylinder. Multicylinder diving usually happens (a) if a diver does not have
cylinder. Multi-cylinder diving usually happens (a) if a diver does not have
enough gas for the complete dive in a single cylinder; (b) if the diver
needs more than one gas mixture because of the depth or the decompression
needs of the dive. For this reason multicylinder dives are often used by
needs of the dive. For this reason multi-cylinder dives are often used by
technical divers who dive deep or long. As far as _Subsurface_ is concerned,
there are only two types of information that need to be provided:
@ -1741,11 +1766,11 @@ image::images/multicylinder_dive.jpg["FIGURE: Multicylinder profile", align="cen
==== Sidemount dives
Sidemount diving is just another form of multicylinder diving, often with
Sidemount diving is just another form of multi-cylinder diving, often with
both or all cylinders having the same gas mixture. Although it is a popular
configuration for cave divers, sidemount diving can be performed by
recreational divers who have completed the appropriate training. Sidemount
dive logging involves, exactly as with multicylinder dives, above, three
dive logging involves, exactly as with multi-cylinder dives, above, three
steps:
- *During the dive, record cylinder switch events*. Since sidemount diving normally involves two
@ -2495,7 +2520,7 @@ Users can unlink dives from the trip to which they belong. In order to do
this, select and right-click the relevant dives to bring up the context
menu. Then select the option *Remove dive(s) from trip*. The dive(s) now
appear immediately above or below the trip to which they belonged, depending
on the date and time of the unliked dive.
on the date and time of the unlinked dive.
==== Add a dive to the trip immediately above
@ -2592,28 +2617,34 @@ L'export des plongées vers _Facebook_ est géré différemment des autres types
d'export car une connexion vers _Facebook_ est nécessaire, nécessitant un
identifiant et un mot de passe. À partir du menu principal, si vous
sélectionnez _Fichier -> Préférences -> Facebook_, un écran de connexion est
présenté (voir l'image *A* sur la gauche, ci dessous). Entrez vos
identifiant et mot de passe _Facebook_. Une fois connecté à _Facebook_, le
panneau de l'image *B* ci dessous est présenté, avec un bouton _Déconnecter
de Facebook_ pour fermer la connexion _Facebook_.
présenté (image *A* sur la gauche, ci dessous). Entrez l'identifiant et le
mot de passe _Facebook_. Une fois connecté à _Facebook_, le panneau de
l'image *B* ci dessous est présenté, avec un bouton _Déconnecter de
Facebook_ pour fermer la connexion _Facebook_.
image::images/facebook1_f20.jpg["Figure: Facebook login", align="center"]
From the _Subsurface_ window it is easy to determe whether _Subsurface_ has
a valid connection to _Facebook_ From the *Main Menu*, select _Share on ->
Facebook_ (image *A*, below). Normally, the _Facebook_ option is greyed
out. But if there is a connection to _Facebook_, this option is active
(i.e. in black colour and can be selected).
Une fois qu'une connexion à _Facebook_ est établie, transférer un profil de
plongée vers _Facebook_ est facile. Assurez-vous que la plongée à transférer
est affichée dans le panneau *Profil de plongée* de _Subsurface_. Si vous
sélectionnez _Partager sur -> Facebook_ à partir du *menu principal*, une
fenêtre s'affiche, pour déterminer quelles informations seront transférées
avec le profil de plongée (voir l'image *B* ci-dessous). Pour transférer un
profil de plongée vers _Facebook_, le nom d'un album _Facebook_ doit être
fourni. Les cases à cocher sur la partie gauche permettent de sélectionner
des informations supplémentaires à transférer avec le profil de plongée. Ces
informations sont affichées dans le champs de texte sur la partie droite du
panneau. (voir l'image *B* ci dessous). Vous pouvez facilement modifier le
message qui sera envoyé avec le profil de plongée. Une fois les informations
supplémentaires ajoutées et vérifiées, sélectionner le bouton _OK_ qui lance
le transfert vers _Facebook_. Après un moment, une fenêtre apparait
indiquant le succès du transfert.
est affichée dans le panneau *Profil de plongée* de _Subsurface_. Si, à
partir du *menu principal*, vous sélectionnez _Partager sur -> Facebook_,
une fenêtre s'affiche, pour déterminer quelles informations seront
transférées avec le profil de plongée (voir l'image *B* ci-dessous). Pour
transférer un profil de plongée vers _Facebook_, le nom d'un album
_Facebook_ doit être fourni. Les cases à cocher sur la partie gauche
permettent de sélectionner des informations supplémentaires à transférer
avec le profil de plongée. Ces informations sont affichées dans le champs de
texte sur la partie droite du panneau. (image *B* ci dessous). Vous pouvez
facilement modifier le message qui sera envoyé avec le profil de
plongée. Une fois les informations supplémentaires ajoutées et vérifiées,
sélectionner le bouton _OK_ qui lance le transfert vers _Facebook_. Après un
moment, une fenêtre apparait indiquant le succès du transfert.
À la fois l'album créé et la publication sur votre ligne temporelle seront
marquées comme privés. Pour que vos amis puissent voir la publication,
@ -2722,7 +2753,7 @@ reason, facilities such as _divelogs.de_ and _Diving Log_ offer to store
dive log information on the Internet.
_Subsurface_ includes access to a transparently integrated cloud storage
backend that is available to all Subsurface users. Storing and retrieving a
back end that is available to all Subsurface users. Storing and retrieving a
dive log from the cloud is no more difficult than accessing the dives on the
local hard disk. The only requirement is that one should first register as
a user on the cloud. To use _Subsurface cloud storage_ , follow these
@ -2866,9 +2897,6 @@ image::images/print2_f22.jpg["FIGURE: Print one dive / page", align="center"]
- _Two Dives_: Print two dives per page, also showing the dive profiles.
- _Six Dives_: Print six dives per page, also showing the dive profiles.
- _Custom_: This option allows customisation of the print contents and
layout. This is
discussed at the end of this section.
Users can _Preview_ the printed page by selecting the _Preview_ button on
the dialogue (see image *A* at the start of this section). After preview,
@ -2889,7 +2917,7 @@ page.
image::images/Printpreview.jpg["FIGURE: Print preview page", align="center"]
=== Write a custom printing template (advanced)
=== Créer un modèle d'impression personnalisé (avancé)
Writing a custom template is an effective way to produce highly customized
printouts. Subsurface uses HTML templates to render printing. One can create
@ -2938,13 +2966,14 @@ suivantes peuvent être réalisées :
[[S_Preferences]]
== Setting user _Preferences_ for _Subsurface_
There are several settings within _Subsurface_ that the user can
specify. These are found when selecting _File -> Preferences_. The settings
are performed in five groups: *Defaults*, *Units*, *Graph*, *Language* and
*Network*. All five sections operate on the same principles: the user must
There are several user-definable settings within _Subsurface_, found by
selecting _File -> Preferences_. The settings are performed in seven groups:
*Defaults*, *Units*, *Graph*, *Language* and *Network*, *Facebook* and
*Georeference*, all of which operate on the same principles: the user must
specify the settings that are to be changed, then these changes are saved
using the *Apply* button. After applying all the new settings users can then
leave the settings panel by selecting *OK*.
leave the settings panel by selecting *OK*. If *Discard* is selected,
changes to the preferences are not saved.
=== Defaults
@ -2966,7 +2995,7 @@ image::images/Pref1_f20.jpg["FIGURE: Preferences defaults page", align="center"]
device that was initialised using the *Preferences* _Network_ tab (see below).
** *Display invalid*: Dives can be marked as invalid (when a user wishes to hide
dives that he/she don't consider valid dives, e.g. pool dives, but still want to
dives that he/she doesn't consider valid dives, e.g. pool dives, but still want to
keep them in the dive log). This controls whether those dives are displayed in
the dive list.
@ -2987,9 +3016,9 @@ image::images/Pref1_f20.jpg["FIGURE: Preferences defaults page", align="center"]
=== Units
image::images/Pref2_f20.jpg["FIGURE: Preferences Units page", align="center"]
Here user can choose between metric and imperial units of depth, pressure,
Here users can choose between metric and imperial units of depth, pressure,
volume, temperature and mass. By selecting the Metric or Imperial radio
button at the top, users can specify that all units are in the chosen
button at the top, one can specify that all units are in the chosen
measurement system. Alternatively, if one selects the *Personalise* radio
button, units can be selected independently, with some units in the metric
system and others in imperial.
@ -3009,21 +3038,21 @@ This panel allows two type of selections:
*Show*: Here users can specify the amount of information shown as part of
the dive profile:
** Thresholds: _Subsurface_ can display the nitrogen, oxygen and the helium partial pressures during
the dive. enabled using the toolbar on the left hand side of the *Dive Profile*
the dive, enabled by using the toolbar on the left hand side of the *Dive Profile*
panel. For each of these graphs users can specify a threshold value on the right-hand side of the
Preferences panel. If any of the graphs go above the specified threshold level, the graph is
highlighted in red, indicating that the particular partial presure threshold has been exceeded.
** _Max pO~2~ whn displaying MOD_ is the value used to calculate the maximum operative depth (MOD)
highlighted in red, indicating that the particular partial pressure threshold has been exceeded.
** _Max pO~2~ is used for calculating the MOD when displaying the maximum operative depth (MOD)
for a dive. Specify an appropriate partial pressure. A value of 1.4 is commonly used.
** _Draw dive computer reported ceiling red_: This checkbox allows exactly what it says. By default
the computer reported ceiling is shown in white.
Not all dive computers report ceiling values. If the dive computer does report it, it may differ
from the ceilings calculated by _Subsurface_. This is because of the different algorithms and
gradient factors available for calculating ceilings, as well as the dynamic way that a
from the ceilings calculated by _Subsurface_ because of the different algorithms and
gradient factors, as well as the dynamic way that a
dive computer can calculate ceilings during a dive.
** _Show unused cylinders in Equipment Tab_: This checkbox allows display of information about unused cylinders when viewing the *Equipment Tab*. Conversely, if this box is not checked, and any cylinders entered using the *Equipment Tab* are not used (e.g. there was no gas switch to such a cylinder), then these cylinders are omitted from that list.
** _Show unused cylinders in Equipment Tab_: This checkbox allows display of information about unused cylinders when viewing the *Equipment Tab*. Conversely, if this box is not checked, and if any cylinders entered using the *Equipment Tab* are not used (e.g. there was no gas switch to such a cylinder), then these cylinders are omitted from that list.
** _Show average depth_: If this box is checked, the *Dive Profile* panel contains a grey line that indicates
the mean depth of the dive up to any time instant during the dive. Normally this is a u-shaped line indicating the deepest average depth just before the
the mean depth of the dive up to any time instant during the dive. Normally this is a u-shaped line indicating the deepest mean depth just before the
ascent.
* *Misc*:
@ -3076,21 +3105,21 @@ image::images/Pref4_f20.jpg["FIGURE: Preferences Language page", align="center"]
A checkbox allows one to use the _System Default_ language which in most
cases will be the correct setting; with this _Subsurface_ simply runs in the
same language / country settings as the underlying OS. If this is for some
reason undesirable users can uncheck this checkbox and pick a language /
country combination from the list of included localizations. The _Filter_
text box allows one to list similar languages. For instance there are
several system variants of English or French. *This particular preference
requires a restart of _Subsurface_ to take effect*.
same language / country settings as the underlying operating system. If this
is for some reason undesirable one can uncheck this checkbox and pick a
language / country combination from the list of included localizations. The
_Filter_ text box allows one to list similar languages. For instance there
are several system variants of English or French. *This particular
preference requires a restart of _Subsurface_ to take effect*.
=== Network
This panel facilitates communication between _Subsurface_ and data sources
on the Internet. This is important, for instance, when _Subsurface_ needs
to communicate with Internet services such as Cloud storage, the
<<S_Companion,_Subsurface Companion app_>> or data export/import from
_Divelogs.de_. These Internet requirements are determined by one's type of
connection to the Internet and by the Internet Service Provider (ISP) used.
One's ISP should provide the appropriate information.
to communicate with Internet services such as Cloud storage or the
<<S_Companion,_Subsurface Companion app_>>. These Internet requirements are
determined by one's type of connection to the Internet and by the Internet
Service Provider (ISP) used. One's ISP should provide the appropriate
information.
image::images/Pref5_f20.jpg["FIGURE: Preferences Network page", align="center"]
@ -3104,12 +3133,12 @@ password are required so that _Subsurface_ can automatically pass
through the proxy server to access the Internet. This information is usually obtained
from one's ISP.
** _Subsurface cloud storage_: In order to store one's dive log in the cloud, a valid email address
** _Subsurface cloud storage_: To store one's dive log in the cloud, a valid email address
and password are required. This allows _Subsurface_ to email security information
regarding cloud storage to a user, and to set up the cloud storage appropriately.
Two additional options are given:
- _Sync to cloud in the background_: This option allows saving of dive information to the cloud storage
while the user performs other tasks inside _Subsurface_.
while the user performs other tasks within _Subsurface_.
- _Save password locally_: This allows local storage of the cloud storage password. Note that this
information is saved in raw text form, not encoded in any way.
@ -3135,8 +3164,16 @@ plongée vers Facebook] pour plus d'informations.
=== Georeference
_Subsurface_ provides a geo-lookup service (that is, an ability to look up
the geographic coordinates of a place name).
_Subsurface_ provides a geo-lookup service (that is, given the coordinates
of a dive site (derived from a click on the *Dive Map panel* at the bottom
right of the _Subsurface_ window, or from a GPS instrument or from the
_Subsurface_ Companion app), a lookup on the Internet is performed to find
the name of the closest known location. Obviously this function only works
if _Subsurface_ has an Internet connection. The preference of the dive site
name can be configured, e.g. _Country/State/City_ or _City/State/Country_
(see image below).
image::images/Pref7_f20.jpg["FIGURE: Facebook login panel", align="center"]
[[S_DivePlanner]]
== The _Subsurface_ dive planner
@ -3210,7 +3247,7 @@ image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window", alig
pressure of this cylinder. By leaving the oxygen concentration (O2%) filed
empty, the cylinder is assumed to contain air. Otherwise enter the oxygen
and/or helium concentration in the boxes provided in this dialogue. Add
additional cylinders by using the "+" icon to the top righthand of the
additional cylinders by using the "+" icon to the top right-hand of the
dialogue.
- The profile of the planned dive can be created in two ways:
@ -3231,21 +3268,23 @@ image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window", alig
==== Recreational dives
The _Subsurface_ dive planner allows a sophisticated way of planning
recreational dives, i.e. dives that remain within no-decompression limits.
The dive planner automatically takes into account the nitrogen load incurred
in previous dives. But conventional dive tables are also used in a way that
can take into account previous dives. Why use a dive planner for
recreational dives? Using recreational dive tables, the maximum depth of a
dive is taken into acount. However, few dives are undertaken at a constant
depth corresponding to the maximum depth (i.e. a "square" dive
profile). This means that dive tables overestimate the nitrogen load
incurred during previous dives. The _Subsurface_ dive planner calculates
nitrogen load according to the real dive profiles of all uploaded previous
dives, in a similar way as dive computers calculate nitrogen load during a
dive. This mean that the diver gets 'credit' in terms of nitrogen loading
for not remaining at maximum depth during previous dives, enabling planning
a longer subsequent dive. For the planner to work it is therefore crucial to
Recreational mode is what comes closest to planning a dive based on the
non-decompression limit (NDL). It computes the maximal time a diver can
stay at the current depth without incurring any mandatory decompression
stops and without using more than the existing gas (minus a reserve). The
planner automatically takes into account the nitrogen load incurred in
previous dives. But conventional dive tables are also used in a way that can
take into account previous dives. Why use a dive planner for recreational
dives? Using recreational dive tables, the maximum depth of a dive is taken
into account. However, few dives are undertaken at a constant depth
corresponding to the maximum depth (i.e. a "square" dive profile). This
means that dive tables overestimate the nitrogen load incurred during
previous dives. The _Subsurface_ dive planner calculates nitrogen load
according to the real dive profiles of all uploaded previous dives, in a
similar way as dive computers calculate nitrogen load during a dive. This
means that the diver gets 'credit' in terms of nitrogen loading for not
remaining at maximum depth during previous dives, enabling planning of a
longer subsequent dive. For the planner to work it is therefore crucial to
upload all previous dives onto _Subsurface_ before performing dive planning.
To plan a dive, the appropriate settings need to be defined.
@ -3268,14 +3307,26 @@ allows calculation of the nitrogen load incurred during previous dives.
- Define the amount of gas that the cylinder must have at the end of the
bottom section of the dive just before ascent. A value of 50 bar is often
used.
used. The reason for this reserve gas is to provide for the possible need
need to bring one's buddy to the surface using gas sharing. How much gas is
used in sharing depends on the depth of the ascent. This can be a bit hard
to estimate, so most agencies assume a fixed amount of gas, or actually of
pressure e.g. 40 or 50 bar or 25% or 33% (rule of thirds). But _Subsurface_
can do better because it knows about the ascent and that is why we add the
amount of gas during the ascent (i.e. the "deco gas“). Subsurface still
uses a fixed pressure „reserve“ but that is supposed to be for the
additional gas used around the realisation that there is a problem and one's
pulse rate goes up when one starts to buddy breathe. This reserve amount is
user configurable.
- Define the depth of the dive by dragging the waypoints (white dots) on the
dive profile or (even better) defining the appropriate depths using the
table under _Dive planner points_ as desribed under the previous heading. If
this is a multilevel dive, set the appropriate dive depths to represent the
dive plan by adding waypoints to the dive profile or by adding appropriate
dive planner points to the _Dive Planner Points_ table.
dive planner points to the _Dive Planner Points_ table. _Subsurface_ will
automatically extend the bottom section of the dive to the maximum duration
within the no-decompression limits (NDL).
- The ascent speed can be changed. The default ascent speeds are those
considered safe for recreational divers.
@ -3430,7 +3481,7 @@ On the bottom right of the dive planner, under _Dive Plan Details_, the
exact details of the dive plan are provided. These details may be modified
by checking any of the options under the _Notes_ section of the dive
planner, immediately to the left of the _Dive Plan Details_. If a _Verbatim
diveplan_ is requested, a detailed sentence-level explanation of the dive
dive plan_ is requested, a detailed sentence-level explanation of the dive
plan is given. If any of the management specifications have been exceeded
during the planning, a warning message is printed underneath the dive plan
information.
@ -3452,9 +3503,9 @@ accross the mouthpiece of the rebreather into account. If the
pO~2~ drops below what is considered a save value, a warning appears in the _Dive plan
details_. A typical pSCR configuration is with a single cylinder and one or more bail-out
cylinders. Therefore the setup of the _Available gases_ and the _Dive planner points_ tables
are very similar to that of a CCR dive plan, described above. However, no oxygen setpoints
are very similar to that of a CCR dive plan, described below. However, no oxygen setpoints
are specified for pSCR dives. Below is a dive plan for a pSCR dive. The dive is comparable
to that of the CCR dive above, but note the longer ascent duration due to the lower oxygen
to that of the CCR dive below, but note the longer ascent duration due to the lower oxygen
in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment.
image::images/Planner_pSCR1_f20.jpg["FIGURE: Planning a pSCR dive: setup", align="center"]
@ -3469,13 +3520,15 @@ the dropdown list, circled in blue in the image below.
diluent cylinder and for any bail-out cylinders. Do NOT enter the information for the oxygen
cylinder since it is implied when the _CCR_ dropdown selection is made.
*Entering setpoints*: Specify a default setpoint in the Preferences tab, by selecting _File -> Preferences -> Graph_ from the main menu. All user-entered segments in the _Dive planner points_ table
*Entering setpoints*: Specify a default setpoint in the Preferences tab, by selecting _File -> Preferences -> Graph_ from
the main menu. All user-entered segments in the _Dive planner points_ table
use the default setpoint value. Then, different setpoints can be specified for dive segments
in the _Dive planner points_ table. A zero setpoint
means the diver bails out to open circuit mode for that segment. The decompression is always calculated
using the setpoint of the last manually entered segment. So, to plan a bail out ascent for a
CCR dive, add a one-minute dive segment to the end with a setpoint value of 0. The decompression
algorithm does not switch deco-gases automatically while in CCR mode (i.e. when a positive setpoint is specified) but, of course, this is calculated for bail out ascents.
algorithm does not switch deco-gases automatically while in CCR mode (i.e. when a positive setpoint is specified) but,
of course, this is calculated for bail out ascents.
The dive profile for a CCR dive may look something like the image below.
@ -3642,7 +3695,6 @@ des sections de ce manuel traitant des opérations relatives.
== ANNEXE A : informations spécifiques au système d'exploitation utilisé pour importer les informations de plongées depuis un ordinateur de plongée.
=== Assurez-vous que les pilotes (drivers) nécessaires sont installés
@ -4386,8 +4438,9 @@ The buttons under the _Template_ dropdown box allows one to _Edit_,
_Delete_, _Import_ and to _Export_ templates (see image *A* above). New or
modified templates are stored as HTML files in the same directory as the
dive log being processed. In order to create or modify a template, select
the _Custom_ template from the template dropdown list in the print dialogue
(see image *B* above), then select _Edit_.
one of the templates from the template dropdown list in the print dialogue
(see image *B* above). Choose an existing template that resembles the final
desired printout. Then select _Edit_.
The Edit Panel comprises three tabs:
@ -4418,7 +4471,8 @@ image::images/Template2_f22.jpg["FIGURE:Template tab", align="center"]
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.
modified in this way. After completing the edits, use the _Export_ button in
the print dialogue to save the new template using a new template name.
To write a custom template the following elements must exist so that the
template will be correctly handled and rendered.