Changeset 4e375f56 in subsurface

Jan 6, 2017, 2:16:33 PM (11 months ago)
Subsurface <dirk@…>
bb4bf63, e3a7782
Salvador Cuñat <salvador.cunat@…> (01/06/17 02:45:14)
Subsurface <dirk@…> (01/06/17 14:16:33)

Add info about SmartTrak? import

Signed-off-by: Salvador Cuñat <salvador.cunat@…>

1 edited


  • Documentation/user-manual.txt

    r2fe69ea r4e375f56  
    12381238the limits of the parser used. When encountering problems with _CSV_ imports, first try with
    12391239a smaller file to make sure everything works.
     1242==== Importing SmartTrak divelogs
     1244SmartTrak is a Windows based propietary software by Uwatec (today Scubapro).
     1245It works through Access databases, which makes it difficult to integrate the
     1246importer in _Subsurface_ core application, and stores the full raw data from
     1247the DC along with a plethora of other data manually added by the user, ranging
     1248from dive points to buddies data or DAN survey info.
     1250A little stand alone tool has been developed to import the .slg files
     1251generated by SmartTrak to Subsurface's .xml format. It can be built together
     1252with _Subsurface_ for linux systems. Two dependencies need to be installed in
     1253your system before building: libglib2.0 and libmdb2.
     1255Assuming installed those dependencies and _Subsurface_ source tree placed in a
     1256directory like ~/src/subsurface, then:
     1260- Move to the source tree directory.
     1261- Run  " $ ccmake build " and set SMARTTRAK_IMPORT option to *on* (off by
     1262  default).
     1263- Generate with [c] and save and exit with [g].
     1264- Build as you prefer, using script (recomended) or moving to build
     1265  directory and running make.
     1266- After a successful build, there will be an executable in the build directory
     1267  named smtk2ssrf, copy or move it to a directory in your $PATH, e.g. ~/bin
     1271smtk2ssrf accepts 0, 2 or more parameters. If it's launched without
     1272parameters and you are on a graphical environment a simple window will be
     1273displayed letting you choose the file(s) to import and a file to store the
     1274subsurface formatted data.
     1278Previous data in the output file will be
     1279erased, so *DO NOT* use your regular subsurface divelog file as output. It's
     1280advisable to set a brand new file to do the import.
     1282If launched from command line with 2 or more parameters like:
     1284        $ smrtk2ssrfc /input/file_1.slg /input/file_2.slg /output/file.xml
     1286Files file_1.slg and file_2.slg in input directory will be imported and stored
     1287in file.xml in output directory.
     1289Check warning and error messages in console or graphical window, some may be
     1290interesting, as support for Galileo and family DCs is still a work in
     1295Open the brand new imported file in _Subsurface_ and check the dives and data.
     1296If everything is fine, close the .xml file and open your regular divelog.
     1297Then from _Main menu_ select _Import -> Import log file_ and choose the
     1298imported .xml file.  The imported dives will show in the _Dive List_, time
     1299ordered, along with the previous dives.
     1300The new dives, although time ordered, will keep the numbering system from
     1301SmartTrak, so a renumbering action is needed. See xref:S_Renumber[Renumbering
     1302the dives] section in this manual for instructions about this topic.
Note: See TracChangeset for help on using the changeset viewer.