Changes

From Fellrnr.com, Running tips
Jump to: navigation, search

SportTracks Dailymile Plugin

176 bytes added, 09:52, 19 March 2015
no edit summary
[[File:SportTracksTrainingAnalytics.jpg|right|thumb|400px|An example of the analytics graph from the plugin.]]
This plugin performs training analytics, such as [[Running Efficiency Calculator|Running Efficiency]], [[Training Monotony]] and [[Training Stress BalanceModeling Human Performance| models that predict performance]], as well as publishing workouts from [[SportTracks]] to [[Dailymile]] and [[Runkeeper]]. This plugin is [http://en.wikipedia.org/wiki/Shareware Shareware] and can be purchased from [http://store.kagi.com/cgi-bin/store.cgi?storeID=6FHVC_LIVE Kagi]. ==How to install the plugin==
* Install SportsTracks normally.
* Download the plugin and save it on your hard drive. The file should save automatically as a '.st3plugin' file, but some browsers get confused and try to save it as a '.zip'. If that happens, rename the file to '.st3plugin'. The plugin is available at http://fellrnr.com/Utilities/FellrnrDailyMilePlugin/FellrnrDailyMilePlugin_2FellrnrDailyMilePlugin_3.3.1.2st3plugin** The latest beta is normally available at http://fellrnr.com/Utilities/FellrnrDailyMilePlugin/FellrnrDailyMilePlugin_3.3.3_beta.st3plugin
* Double click the .st3plugin file to install.
* Check the plugin is installed correctly
** Start [[SportTracks]]
** Click on settings <br/>http://fellrnr.com/images/settings.jpg
** Click on plugins <br/>http://fellrnr.com/images/settings-plugins.jpg
** Check that 'Fellrnr's DailyMile [[Dailymile]] Plugin' is shown <br/>http[[File://fellrnr.com/images/settings-plugins-dailymile.jpg]]==Viewing the analytics=Workout Analytics=
* Click on 'select view', then 'daily activity' <br/>http://fellrnr.com/images/SelectDailyActivity.jpg
* Click on an activity to select it
* Click on the drop down menu on the top right of the activity window and select 'Fellrnr Analytics'
[[File:SportTracksActivityAnalyticsMenu.jpg]]
* You will then see the analytics of that workout
[[File:SportTracksActivityAnalytics.jpg]]
==Viewing Analytics Report=Graphs=* Click on 'select view', then 'Activity ReportsFellrnr Analytics'
[[File:DailyMile Activity Reports.jpg]]
* Click on the 'Fellrnr Analytics' button to display You will then see the graph of workout information. You can click on the various check boxes to display different information. The graph shows the workouts selected in To get more help, hover your mouse over the top windowcontrols.
[[File:SportTracksTrainingAnalytics.jpg]]
==Exporting Workouts to Dailymile.com (Easy Mode)=and/or RunKeeper.com=* You must have a dailymile[[Dailymile]].com and/or RunKeeper.com account setup.* Start [[SportTracks ]] if it's not already running.
* Click on 'select view', then 'daily activity' <br/>http://fellrnr.com/images/SelectDailyActivity.jpg
* Click on an activity to select it for export.** Multiple activities can be selected, but this may take a long time and dailymile[[Dailymile]].com limits the rate of uploads, so you may experience errors.* Click on 'export' then select:** 'Publish to [[Dailymile]].com (easy)', and then choose how you feltfor just Dailymile. com** 'Publish to [[File:ExportEasy.jpgDailymile]]* The first time you use the plugin, a popup will ask you to log into dailymile.com and authorize the plugin. Runkeeper'''Logging on with your Facebook account causes problems - please log on directly.'''** This popup uses the browser settings for the HTTP proxy rather than the SportTracks settings. (Don't worry if that doesn't mean anything to and then choose how you. You shouldn't have felt to worry about it.)** The authorization token is stored in the logbook, so different SportTracks users can have different dailymile.com accounts.** You can clear the authorization information by looking under the plugin specific settings.* A browser window should popup with your workout in Dailymile.com ==Exporting Workouts publish to Dailymile.com (Advanced Mode)==* You must have a dailymile.com account setupboth sites* Start SportTracks if it's not already running* Click on 'select viewPublish to Runkeeper', then 'daily activity' <br/>http://fellrnr.com/images/SelectDailyActivity.jpg* Click on an activity to select it for export** Multiple activities can be selected, but this may take a long time and dailymile.com limits the rate of uploads, so you may experience errors* Click on 'export' then 'Publish to Dailymilejust Runkeeper.com (Advanced)', then choose how you felt.
[[File:ExportAdvanced.jpg]]
* The first time you use the plugin, a popup will ask you to log into dailymile.com Dailymile and/or RunKeeper and authorize the plugin. '''Logging on with your Facebook account causes problems - please log on directly.'''** This popup uses the browser settings for the HTTP proxy rather than the [[SportTracks ]] settings. (Don't worry if that doesn't mean anything to you. You shouldn't have to worry about it.)** The authorization token is stored in the logbook, so different [[SportTracks ]] users can have different dailymile.com accounts.
** You can clear the authorization information by looking under the plugin specific settings.
* You will see a popup allowing you to customize the data exported to Dailymile.com. Note that you can get help by hovering your mouse over a field, as shown below.
[[File:DailyMile SportTracks Screenshot full.jpg]]
** The plugin attempts to guess what the correct activity type is from the activity category in [[SportTracks ]] as described below. (If you think it should make better guesses, let me know.) You can change the activity type. If you hit okay, your workout will be posted and a browser window will popup with your workout in [[Dailymile]].com. Note that the text of your workout is in the windows clipboard, so you can paste it into another site such as Google+==Select Laps Dialog==
This dialog allows you to select specific laps for publication. This is useful if you are doing interval training and only want to publish the work intervals. <br/>
http://fellrnr.com/images/SelectLaps.jpg
* To select laps, click on a lap. Holding the control key will add to the selection, holding the shift key will select ranges. * Pressing "Select Odd" will select the odd numbered intervals. The selection can then be modified by clicking on laps with the control key pressed. * Pressing "Select Even" will select the even numbered intervals. The selection can then be modified by clicking on laps with the control key pressed. * Pressing "Guess Intervals" will look at the start and end heart rate [[Heart Rate]] to determine the work intervals. The 'interval threshold' is used to determine the work intervals. A lap will be selected if the finish heart rate [[Heart Rate]] is greater than the start heart rate [[Heart Rate]] by at least the threshold value. select the even numbered intervals. The selection can then be modified by clicking on laps with the control key pressed.==How SportTracks Activity Categories are mapped to Dailymile Activity Types==This plugin looks at the text of the [[SportTracks ]] Activity Category and guesses the appropriate [[Dailymile ]] Activity Type
* If category contains "running" then Activity type is running
* If category contains "cycling", "biking", or "bike" then Activity type is cycling
* If category contains "walk" then Activity type is walking
* Otherwise default Activity type to fitness
There is support for other languages; click on 'show category translations' at the bottom of the settings page.=Calculating TRIMP=The plugin will calculate [[TRIMP]] from heart rate and duration, but it can also use the intensity to calculate TRIMPcr. I recommend setting the calculation method to "Normalized Heart Rate & Intensity" in the [[SportTracks Dailymile Plugin]] settings page:[[File:TRIMPCalculation.jpg|none]]If the intensity is set on a workout, that intensity overrides the heart rate calculation:[[File:SportTracksIntensity.jpg|none]]=Missing Features==Some features are missing because they are not yet supported in the [[Dailymile]].com API. These include
* Max and average HR
* Weather icon
* Keywords
When these are added to the API, I will add support in the plugin.
==Purchasing a License==The plugin will prompt you if you do not have a license with the message shown below.<br/>http://fellrnr.com/images/BuyNow.jpg Clicking Yes will bring up the online store in your browser and display the license dialog shown below.<br/>http://fellrnr.com/images/PromptForLicense.jpg Enter the license you received, taking care in case line breaks have been inserted in the license string. The license key should looks something like this (this is not a valid key!)<pre>WWVIwMTEtz0xMLDMSywwSkZT,c08SIHlsBIzSGNGI7uOh5TDq4wc8GUW9BXJHz8sy0qJbax4yRFDRpwg3lgVN/GeZjfRWHnd0LzWFZVuaZZuFxNqYHwvN4TezuvEMUjaXE2hmt6Ad0+ROf7Q+5o6mHCFjSOldIwPr+Jukb2nLKgU1+6vFLlYI/Xb39+7PgEmLnEU=</pre> ===Direct Purchase===Licenses are purchased via http://store.kagi.com/cgi-bin/store.cgi?storeID=6FHVC_LIVE which will provide you with a license key. ===Manually entering the license key===The license key can be viewed and edited on the plugin settings page.* Click on settings <br/>http://fellrnrChanging Dailymile.com/images/settings.jpg* Click on plugins <br/>http://fellrnr.com/images/settings-plugins.jpg* Click on 'Fellrnr Daily Mile Settings', then 'Enter License...'<br/>http://fellrnr.com/images/DMPluginSettings.jpg* Enter license key in the dialog.<br/>http://fellrnr.com/images/PromptForLicense.jpg==Changing dailymileor RunKeeper.com Accounts==If you change your account on dailymile[[Dailymile]].com, or RunKeeper.com you'll need to clear the token that this plugin stores. * You may need to clear your Internet Explorer cookies, as this plugin uses the browser for authentication. Clearing the cookies is documented at http://support.microsoft.com/kb/278835 * Start [[SportTracks]]
* Click on settings <br/>http://fellrnr.com/images/settings.jpg
* Select "Fellrnr Daily Mile SettingSettings" and click on "Clear OAuth Token" for the site you want to change.<br/> [[File:ClearOAuth.JPG]]* You'll be prompted to log on next time you publish to dailymile.com ==Facebook Authorization=Authentication to Dailymile=There are a few problems with accessing [[Dailymile]].com using Facebook credentials, and it is better to log in with an email address and password. ==Support==
For support, email plugin <at> fellrnr <dot> com.
==Change History==* 3.3.1** Fix graphing of TRIMP when there are multiple workouts per day.* 3.3.0** Analytics graphing*** Change graphing to be a new view rather than on the reports page*** Add smoothing, including an auto smoothing*** Add option to project performance forward one month*** Improve tool tip (mouse over) text** Implement Banister and Busso models for performance prediction** The 'force recalculations' now does a full recalculation** Support normalized TRIMP values** Use local time for TRIMP** Better support for TRIMPcr10** Changes to performance optimization** More translations for "running"* 3.2.0** The category mapping now learns from input, so if you select a different category, the plugin will default to that next time** Support non-ASCII characters for [[Dailymile]] and [[Runkeeper]]** Fix the 'use current time' to default to not set if workout is not for today** [[Runkeeper]] changes*** The raw [[Heart Rate]] data is exported*** Use the correct case for [[Runkeeper]] everywere*** Change post Dialog box title to [[Runkeeper]]*** Split posted message into shorter lines to prevent '500 server error'.*** Reduce the number of comments posted* 3.1.0** Better support for [[Runkeeper]]*** Write extra details to comment fields, one line per comment*** Support posting GPS track*** Support posting [[Heart Rate]] track*** Post calories*** [http://runkeeper.com/user/sporttracksplugin/activity/143162460 Example Runkeeper workout]** Use dialog box for [[Runkeeper]] as well as [[Dailymile]]** Remove 'easy' option** Add cumulative total for number of runs over a given distance (set on options page)* 3 (.0.0** Plugin is now free** Add cumulative time totals** Add [[Heart Rate]] and Efficiency Drift** Add smoothed elevation* 2.1.4** Correct bug in beta)cumulative totals timezone handling* 2.1.3** For cumulative totals, convert activity times to local timezoneand always use the second level category rather than the [[Dailymile]] equivalent
** Convert elevation to selected units
** Support custom and distance splits for laps
** Fix a bug that caused a fresh install to have bad default values for the plugin settings (caused Monotony to be capped at zero)
** Change title to 'Fellrnr Analytics' to match menu item
** Fix a bug so that entered HR was used to calculate [[TRIMP ]] rather than estimate [[TRIMP]]
** Add option on report to show all or selected activities (defaults to all)
* 2.1.1
** Add a report of the analytics over time
* 1.2.1
** Add basic runkeeper[[Runkeeper]].com support.** Fix some authentication issues with dailymile[[Dailymile]].com.** Performance improvements posting to dailymile[[Dailymile]].com.
** Add more options to the advanced dialog.
* 1.1.3 ** Add ability to post the GPS data to [[Dailymile]].com.
** Add a button to the advanced dialog to save the checked options as a future default.
** Change menu so that you select 'felt' as part of the export.
** Give the option to post workout using the current time rather than the start time of the workout. This is only available for workouts completed today.
** Correct a bug that stops manually entered workouts from having a distance.
** Use the smoothed heart rate [[Heart Rate]] and cadence [[Cadence]] data rather than raw values.
** Default to all laps selected on the select laps dialog.
[[Category:Software]]

Navigation menu