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

User manual: update importing dive log data from other software

Browse source 
Minor changes and slight reorganization.

Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
Dirk Hohndel 2013-12-12 19:38:47 +01:00
parent deead2a613
commit 586c7fbd90
1 changed files with 14 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
Documentation/user-manual.txt
View file

@ -341,14 +341,12 @@ The information entered in the *Dive Notes* tab, the *Equipment* tab can be save
[[S_ImportingAlienDiveLogs]] [[S_ImportingAlienDiveLogs]]
Maybe you have a lot of dives logged using other dive log software. You don't have to type all information by hand into Maybe you have a lot of dives logged using other dive log software. You don't have to type all information by hand into
_Subsurface_, because you can probably import your divelog. _Subsurface_ will import divelogs from a range of other dive log software, including _Subsurface_, because you can probably import your divelog. _Subsurface_ will import divelogs from a range of other dive log software. Some software is supported natively (e.g. divelogs.de, JDiveLog, MacDive, and Suunto DM4), for others you have to export your logbook to XML and then _Subsurface_ can import that XML file (Suunto DM3, DivingLog). _Subsurface_ can also import UDDF and UDCF files that are used by some divelog software and even some divecomputers like the Heinrichs & Weikamp DR5. Finally, for some divelog software we currently suggest to import your logbook first into a webservice like divelogs.de and then import them from there with _Subsurface_, as divelogs.de supports a few additional logbook formats that _Subsurface_ currently cannot parse.
XML exports from DivingLog, divelogs.de and Suunto
DiveManager. Native format of JDiveLog and MacDive are imported as well.
When importing dives, _Subsurface_ tries to detect multiple records for When importing dives, _Subsurface_ tries to detect multiple records for
the same dive and merges the information as best as it can. If the same dive and merges the information as best as it can. If
there are no time zone issues (or other reasons that would cause the there are no time zone issues (or other reasons that would cause the
beginning time of the dives to be almost simmultaneous) _Subsurface_ beginning time of the dives to be significantly different) _Subsurface_
will not create duplicate entries. will not create duplicate entries.
[[S_ImportingDivesSuunto]] [[S_ImportingDivesSuunto]]
@ -359,7 +357,6 @@ have to export the dives you want to import. _Subsurface_ does not import
directly from the 'Suunto Divemanager' log files. The following procedures directly from the 'Suunto Divemanager' log files. The following procedures
can be used for Linux and Windows. can be used for Linux and Windows.
===== Export from *Suunto Divemanager* ===== Export from *Suunto Divemanager*
- Start 'Suunto Divemanager' and log in with the name containing the logs - Start 'Suunto Divemanager' and log in with the name containing the logs
@ -440,18 +437,6 @@ The import of dive information from _divelogs.de_ is simple, using a single dial
image::images/Divelogs1.jpg["FIGURE:Download from Divelogs.de",align="center"] image::images/Divelogs1.jpg["FIGURE:Download from Divelogs.de",align="center"]
[[S_ImportingDR5]]
==== Importing dives from Heinrichs Weikamp DR5
When mounted as a USB drive the Heinrichs Weikamp DR5 saves a single UDDF file for every dive.
Mark all the dives you'd like to
import or open, _Subsurface_ is tested to work with DR5.
Note: The DR5 does not seem to store gradient factors nor deco information, so for
_Subsurface_ it is not possible to display them. Adjust the gradient
factors in the Tec Settings in _Subsurface_ to generate a deco overlay in the _Subsurface_ *Dive Profile* panel
to get deco displayed but please note that the deco calculated by _Subsurface_
will most likely differ from the one display at the DR5.
==== Importing dives from *MacDive* ==== Importing dives from *MacDive*
Importing logs from MacDive is as easy as it gets. Do the following Importing logs from MacDive is as easy as it gets. Do the following
@ -542,6 +527,18 @@ Make sure you are not using compressed files when importing to _Subsurface_
_Subsurface_ supports UDDF as a generic import format. _Subsurface_ supports UDDF as a generic import format.
Some attributes in your file may not get processed properly. Select _Import->Import Files_ from the Main Menu. Then select the UDDF file to be imported. Some attributes in your file may not get processed properly. Select _Import->Import Files_ from the Main Menu. Then select the UDDF file to be imported.
[[S_ImportingDR5]]
==== Importing dives from Heinrichs Weikamp DR5
When mounted as a USB drive the Heinrichs Weikamp DR5 saves a single UDDF file for every dive.
Mark all the dives you'd like to import or open.
Note: The DR5 does not seem to store gradient factors nor deco information, so for
_Subsurface_ it is not possible to display them. Adjust the gradient
factors in the Tec Settings in _Subsurface_ to generate a deco overlay in the _Subsurface_ *Dive Profile* panel
to get deco displayed but please note that the deco calculated by _Subsurface_
will most likely differ from the one display at the DR5.
[[S_Companion]] [[S_Companion]]
=== Importing GPS coordinates with the Subsurface Companion app for mobile phones === Importing GPS coordinates with the Subsurface Companion app for mobile phones