Storage of SportTracks data

Frequenly Asked Questions

Moderator: FAQ Moderators

Storage of SportTracks data

Beitragvon gerhard » So Okt 12, 2008 2:54 pm

This section explains where SportTracks including plugins store data.

Question:

Where are SportTracks activities stored?

Answer:

Stored in the logbook. By default, the logbook file is stored under "My Documents" with the name like "USER's History.logbook" where USER in this case is the ST Athlete name.

You can store the logbook where you want and have several logbooks, for instance if several users share the same computer. This is the only essential data to save - most other data can be recreated or is normally not essential.

Note: This post previously contained information about all ST related information. This post has been moved below.
Zuletzt geändert von gerhard am So Okt 18, 2009 1:55 pm, insgesamt 6-mal geändert.
Benutzeravatar
gerhard
Contributor!
Contributor!
 
Beiträge: 2111
Registriert: Mo Nov 27, 2006 7:07 pm
Wohnort: Sweden

Beitragvon gerhard » Sa Jul 11, 2009 3:02 pm

Question:

Can the ST program and data paths be customized?

Answer:
Yes, to some extent. See below for some side effects.
This post explains the gory details about the paths.

Activities
The .logbook can be located where you want.

Program files
ST core application program files can be moved to another location, including the (old style) plugins in the Plugins folder.

User settings and data
Various locations, as explained above.
No known way.

Common program data
%PROGRAMDATA%\ZoneFiveSoftware\SportTracks\
This includes plugin data to some extent, see this post for details.

admin's description:
1) Open the file SportTracks.exe.config from the installation directory (C:\Program Files\...) with a text editor such as Notepad.
2) Find this section:
Code: Alles auswählen
<setting name="EnvironmentSettings_CommonApplicationDataFolderPath"

3) Replace this text:
Code: Alles auswählen
<value />

With this text
Code: Alles auswählen
<value>{custom folder}</value>

Where {custom folder} is the full path to your folder (eg F:\SportTracks Common Data). Note that the path should not include \ZoneFiveSoftware\SportTracks\2.0\

Some plugins may not yet recognize this setting.

------------
What are the side effects?

ST core program handles reallocation fine. However, some plugins may not find information where expected. There may be updates to the ST plugin API that simplifies this task, right now the handling in the plugin is quite complicated and occasionally incomplete.

So for instance, other plugins using for instance UniqueRoutes plugin will not find the plugin if the ST program files folder (and thereby the Plugin folder) is moved. Actually, the UniqueRoutes plugin itself may not work if ST is not started from the standard path.
Zuletzt geändert von gerhard am Mi Dez 23, 2009 7:57 am, insgesamt 2-mal geändert.
Benutzeravatar
gerhard
Contributor!
Contributor!
 
Beiträge: 2111
Registriert: Mo Nov 27, 2006 7:07 pm
Wohnort: Sweden

Beitragvon gerhard » Mi Okt 14, 2009 1:17 pm

Question:

How can several users handle their own activities on one PC?

Answer:

SportTracks has no limitation on the number of logbooks for a user. Each user can have as many logbooks as they like. Just use Logbook->New to create a new logbook.

Some of the setup is shared:

Separate logins
The SportTracks program and plugins are shared for all users. Also Map tiles and equipment pictures are shared.
Settings are unique for each user. So for instance plugins can be disabled separately for each users.

One login
All data but the logbook is shared. This means almost all settings are shared (some plugins store settings in the logbook though).
Note also that backup of activities at import is shared too.

Tips: Create shortcuts to the separate logbooks and use the shortcut to start ST. With this method you do not have to open the logbook from within ST and decrease the risk of using an incorrect logbook.
Benutzeravatar
gerhard
Contributor!
Contributor!
 
Beiträge: 2111
Registriert: Mo Nov 27, 2006 7:07 pm
Wohnort: Sweden

Beitragvon gerhard » So Okt 18, 2009 1:41 pm

Question:

Can I use ST from more than one computer?

Answer:
In most situations, the program must be installed on the separate PCs, including plugins and settings. See other posts in this thread that explains where different data is stored and how the paths can be customized. Foe simplicity, this post only mentions the logbook with activities.

Some alternatives:
* Store the logbook on a USB stick
* Store the logbook on a virtual drive, synchronized over internet. Some ST users recommends dropbox.

Keep in mind that there is no simple way to merge changes in logbooks.
Zuletzt geändert von gerhard am So Okt 18, 2009 2:21 pm, insgesamt 1-mal geändert.
Benutzeravatar
gerhard
Contributor!
Contributor!
 
Beiträge: 2111
Registriert: Mo Nov 27, 2006 7:07 pm
Wohnort: Sweden

Beitragvon gerhard » So Okt 18, 2009 1:47 pm

Question:

Where is all known files related to SportTracks stored?

Answer:
Note: The directory paths depends on the Windows version and language. Therefore, environment variables are used here. To open Windows Explorer and translate the variables (see caveeat for PROGRAMDATA and LOCALAPPDATA in XP), just paste the variable name in the Run or Vista quick search box. For instance, when opening the path %ProgramFiles% in English Windows, Windows opens the path "C:\Program Files".

Some examples using the paths etc in the English version of Windows XP installed on the C: drive with the user %USER% logged in. This differs in other Windows versions and in other language versions.
For instance "C:\Documents and Settings\%USER%\" would be "C:\Dokumente und Einstellungen\%USER%\" in German XP installation.

Further examples for English Windows:

%ProgramFiles%=C:\Program Files

Vista:
%USERPROFILE%=C:\Users\%USER%
%ALLUSERSPROFILE%=C:\ProgramData
%APPDATA%=%USERPROFILE%\AppData\Roaming

%LOCALAPPDATA%=%USERPROFILE%\AppData\Local
%PROGRAMDATA%=%ALLUSERSPROFILE%

XP:
%USERPROFILE%=C:\Documents and Settings\%USER%
%ALLUSERSPROFILE%=C:\Documents and Settings\All Users
%APPDATA%=%USERPROFILE%\Application Data

The following are only variables in Vista, must be manually translated in XP
%LOCALAPPDATA%=%USERPROFILE%\Local Settings\Application Data
%PROGRAMDATA%=%ALLUSERSPROFILE%

Note: Some paths with version numbers depends on the version. This post assumes that ST 3.0 is used. With 2.1 or 2.0 version replace the blue version (3) numbers with 2.1/2.0 and red (3) with 2.0.

Note2: If you have installed Windows on another drive than c: use variable %SystemDrive% instead.

--------------------------
Customization

Some paths can be customized. See previous post for details.

--------------------------
Activities

Stored in the logbook. By default, the logbook file is stored under "My Documents" with the name like "USER's History.logbook" where USER in this case is the ST Athlete name.

You can store the logbook where you want and have several logbooks, for instance if several users share the same computer. This is the only essential data to save - most other data can be recreated or is normally not essential.

----------------------
Program Files

ST core program is installed in %ProgramFiles%\Zone Five Software\SportTracks 3

Plugin installation files

There are several locations for ST plugin installations. If a plugin is found in more than one location, the first is used.

%PROGRAMDATA%\ZoneFiveSoftware\SportTracks\3\Plugins\Installed
- New style plugins, with .st3plugin extension. Each plugin is installed under the plugin GUID.
This includes all ST3 plugins (and most ST2 plugins released after June 2008).

ST2 only: Relative the directory ST was started from, in folder Plugins. By default, this is:
%ProgramFiles%\Zone Five Software\SportTracks 2.1\Plugins
- Old style, without installer (this includes some plugins included by default with ST as well). Most plugins have been updated to .st2plugin format
Examples of plugins with this setup as of July 2009: ST builtin Garmin USB, ST WUnderground, ST Terraserver, OldManBiking plugins before March 2009, Training, Kristian Bisgaard Lassen plugins before 2010, FTPplugin, ExportCRS
Some plugins that recently changed: Training Load, Elevation Correction, OldManBiking plugins after March 2009

ST2 only: %ProgramFiles%\Zone Five Software\SportTracks 2.0\Plugins
- ST 2.1.3326 Uses this directory for compatibility checks, to include old style plugins after the upgrade.

----------------------
User Specific Settings and Data

The ST settings (and most for plugins) controlling theme, smoothing etc. The settings are specific to the logged in user.
%LOCALAPPDATA%\ZoneFiveSoftware\SportTracks\3\Preferences.System.xml

Backup at import of activities
A copy of the imported data before post processing has been done.
%LOCALAPPDATA%\ZoneFiveSoftware\SportTracks\3\Imported

Plugins
Some plugins store settings also in other locations. In some situations, it is difficult to distinguish between settings and data for plugins, see next section.

old_man_biking's plugins and marioz/racerfern plugins store custom data data (like CustomConfig.xml, ActivityDocumentation Templates and TrainingPlan) and log files here:
%LOCALAPPDATA%\ZoneFiveSoftware\SportTracks\3\

WhereInWorld, BenBun's plugins and wbruessler's plugin, as well as older versions of GPSrunning and Matrix store data in %APPDATA%\
BBBS_Year_View
HighScorePlugin
OverlayPlugin
PerformancePredictorPlugin
SportTracks\MatrixPligIn
SportTracksExportToCsvPlugin
TRIMPPlugin
UniqueRoutesPlugin
WhereInWorld

Logs

The core ST logfile is created in the directory where ST is started from (normally %ProgramFiles%\ZoneFiveSoftware\SportTracks\3. Vista will redirect the file to %USERPROFILE%\AppData\Local\VirtualStore\Program Files\Zone Five Software\SportTracks 3

OldManBiking plugins logs data for own (and occasionally other output?) to %LOCALAPPDATA%\ZoneFiveSoftware\SportTracks\3\Plugins\OMBPlugins.log

----------------------
Non user specific data

Some data common for all users (for both core program and some plugins) stored in
%PROGRAMDATA%\ZoneFiveSoftware\SportTracks\3\

This includes the following:
Web Files\ - Cached information, both for core ST and plugins
- MapTiles\ - Cached map tiles
- Images\ - Athlete and Equipment images
- Weather\WUData\ - Information about ST weather (on the summary page)

Plugin data

Plugins store data in various locations. Data related to activities are normally stored in the logbook. Most settings are stored with the system settings, some settings stored in separate files as described above. Some plugins like map plugins and Activity Pictures store files like map tiles and images in same folders as the core ST equivalents. For instance, the SRTM tiles for the Elevation Correction plugin is stored here:
%PROGRAMDATA%\ZoneFiveSoftware\SportTracks\3\Web Files\SRTM tiles\

To the FAQ writer's knowledge, there are no problems copying these directories and putting them on the new computer (like registry settings etc). This can also be used to get map tiles for offline computers. There could be paths in the files though.
Benutzeravatar
gerhard
Contributor!
Contributor!
 
Beiträge: 2111
Registriert: Mo Nov 27, 2006 7:07 pm
Wohnort: Sweden


Zurück zu FAQ

Wer ist online?

Mitglieder in diesem Forum: 0 Mitglieder und 1 Gast