Changeset 4e375f56 in subsurface


Ignore:
Timestamp:
Jan 6, 2017, 2:16:33 PM (3 months ago)
Author:
Subsurface <dirk@…>
Branches:
master
Children:
bb4bf63, e3a7782
Parents:
2fe69ea
git-author:
Salvador Cuñat <salvador.cunat@…> (01/06/17 02:45:14)
git-committer:
Subsurface <dirk@…> (01/06/17 14:16:33)
Message:

Add info about SmartTrak? import

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • 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.
     1240
     1241[[S_SmartTrakImport]]
     1242==== Importing SmartTrak divelogs
     1243
     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.
     1249
     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.
     1254
     1255Assuming installed those dependencies and _Subsurface_ source tree placed in a
     1256directory like ~/src/subsurface, then:
     1257
     1258*BUILDING*
     1259
     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 build.sh 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
     1268
     1269*RUNNING*
     1270
     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.
     1275
     1276[icon="images/icons/warning2.png"]
     1277[WARNING]
     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.
     1281
     1282If launched from command line with 2 or more parameters like:
     1283
     1284        $ smrtk2ssrfc /input/file_1.slg /input/file_2.slg /output/file.xml
     1285
     1286Files file_1.slg and file_2.slg in input directory will be imported and stored
     1287in file.xml in output directory.
     1288
     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
     1291progress.
     1292
     1293*MERGING*
     1294
     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.
    12401303
    12411304
Note: See TracChangeset for help on using the changeset viewer.