iSMARTtrain for OS X

ReadMe - May 2011 - Version 3.0.9 Beta 2

iSMARTtrain

iSMARTtrain is a Macintosh application for recording athletic training sessions and displaying these in a tabular or graph form. For the latest release version of iSMARTtrain, visit http://www.ismarttrain.com/

This release is a universal binary for both PowerPC and Intel Macs. It requires Mac OS X 10.5 or newer.

This release of iSMARTtrain has the ability to download data from Polar Heart Rate Monitors, such as the Polar Accurex, XTrainer, RS200, RS200sd, RS300x, CS200, CS200cad, FT80, S410, S510, S520, S610, S625x, S710, S720i, S725 and S810, SRM PowerControl (Version V), Ergomo Pro, PowerTap Cervo & Joule and Garmin Foreruner 50, 60, 301, 205, 305, 301xt, 405 & 405cx and Edge 205, 305, 605 & 705. More devices will be added in future releases.

Installation

To install the application, simply drag the icon “iSMARTtrain” to a location, such as the Applications folder, your hard drive.

To use the program, double-click on the icon named iSMARTtrain.

Creating a New Log File

On running iSMARTtrain for the first time, a new Log File, containing 3 default sports - Running, Cycling & Swimming - will be created. These sports can be added to or deleted from the Log file using 'Manage Sports' in the 'Manage' menu.

Managing Sports

Add New Sport

To add a new sport, select ‘Manage Sports’ from the ‘Manage’ menu to display the Sports Dialog box. Type the name of the sport, and select the desired units for distance and speed. A sport can have 'None' for its distance or pace units. This is to allow for sports such as Triathlon, or for sessions, such as stretching or yoga, that you wish to record but which do not fit into the distance/time/speed concept. Click on the rectangle next to ‘Colour’ to set the colour that will be used to display this particular sport in the graphs, etc. Finally, click ‘Add’ to add the sport to the list box.

Edit Sport

To edit the details of a sport, simply click on the sport in the list box, and its details will be displayed. Once the changes have been made, click the ‘Update’ button to save the changes.

Delete Sport

To delete a sport, select the sport in the list box and click the 'Delete' button. If you delete a sport for which you have already entered sessions, these sessions will deleted. A dialog box, warning you of this, will be displayed before the sessions are deleted.

Default Sport

If the 'Default' box is checked for a particular sport, then this sport will be automatically selected in the 'Add Session' dialog box when it is opened to add a new session. This is useful if, for instance, most of your training is running, but you occasionally cycle or swim. The default sport is shown in bold in the listbox.

Manage Equipment

iSMARTtrain allows you to monitor the usage of the equipment used in your training sessions. For instance, you can track the mileage of your running shoes or race wheels.

Add Equipment

To add a piece of equipment, select ‘Manage Equipment’ from the ‘Manage’ menu. Then, simply enter the details in the dialog box and click ‘Add’.

Edit Equipment

The edit the details of an piece of equipment, select the equipment in the list box, and its details will be displayed. Once the details have been amended, click ‘Update’ to save the changes.

Reset Details

The 'Reset' button zeros the session, distance and time settings for the currently selected piece of equipment..

Managing Routes

iSMARTtrain has the concept of ‘Routes’, which are frequently used training sessions. These are then displayed in a popup menu in the ‘Manage Sessions’ dialog to save the user the trouble of repeatedly entering the same information. Although the name implies a route, this feature can be equally used for particular training sessions which are repeated, such as interval or pyramid sessions. In future versions of iSMARTtrain it will be possible to compare sessions which have the same route, thus giving an indication of improvement in performance over a fixed course. To specify that the distance specified for a Route overwrites the distance downloaded form an HRM, tick the 'Route Distance overwrites HRM Distance' checkbox.

Add Route

To add a route, select ‘Manage Routes’ from the ‘Manage’ menu. Then, simply enter the details in the dialog box and click ‘Add’.

Edit Route

The edit the details of an existing route, select the route in the list box, and its details will be displayed. Once the details have been amended, click ‘Update’ to save the changes. Any changes made to a route do not affect existing sessions already in the log.

Delete Route

To delete a route, select the route in the list box, and click the delete button.

Managing Sessions

Sessions are the core of iSMARTtrain. Each session reflects the activities of one training session or race.

Add a Session

To add a session, select ‘Add Session’ from the ‘Add’ menu or press ‘Apple-Alt-A’ on the keyboard. The Add Session dialog will then be displayed. Enter the date and time of the session and select the sport from the pop-up menu. The sports displayed are those entered in the Sports dialog box above.

Select one of the already-defined routes (see above) or enter details for this particular session. Next, enter the distance (this field may be filled if a pre-defined route was selected), and the duration of the session. The average pace/speed for the session will be calculated, depending on the pace units for the sport selected. The climb field is used to store the total climb for the session. In future versions, this field will be graphed. The equipment used for the session can also be selected.

Once several sessions have been entered, the data can be viewed either as a table or a graph. The total number of sessions, distance and time per week or month can also be tracked.

Add Session Using Heart Rate Monitor

Polar Accurex/XTrainer Devices

To add a session using data from a Polar Accurex/XTrainer Monitor, select the 'Download' tab in the Add Session dialog box. You will then be presented with a dialog box which will show the progress of the transfer. Select the port to which your interface is connected, and the type of your Heart Rate Monitor. If you check the 'Save Raw Data' checkbox, you will be prompted to save a file containing the binary data from the HRM once the transmission has completed. This is useful for sending to OTAG Technologies when debugging or adding new devices.

Click the 'Read' button, and the activity indicator will change from 'Idle' to 'Waiting'. Start the data transmission from your Polar HRM and you will see the activity indicator changing to 'Receiving'.

Once all the data has been transmitted from the HRM, you will be presented with the a message box.

Polar RS200, RS200sd, CS200, CS200cad, S410, S510 & S520

This version of iSMARTtrain supports SonicLink data transmission from the RS200, RS200sd, CS200, CS200cad, S410, S510 & S520 HRMs. To add a session using data from a Polar Heart Rate Monitor, select the 'Download' button in the toolbar. Select 'SonicLink' in the 'Port' popup menu. Next, select relevant device from the Devices Popup and click 'OK'.

You'll see a dialog box displayed with three buttons. Click the 'Settings' button to select the audio input you are using. Put your watch into connect mode, then click the 'Start Recording' button. Next, start your watch transmitting - you should see the bar on the left of the window showing the recording level - it should peak at more that half the level of the bar.

Once the watch has finished transmitting, click 'Finish'. After a short delay, you'll see a message box telling you if the download was successful or not. If the download was sucessful, you'll see the data from the watch, such as the date, time ,duration, etc.) in the 'Add Session' dialog. Add the session your log file, and you'll be able to view the HR data.

If the download failed, try changing the 'Gain' using the 'Settings' button in the SonicLink dialog box. The position of the watch is also critical, in my experience. Using our iBook internal microphone, we have to hold the back of the watch within millimeters of the actual microphone to get a successful result. The method for downloading will be tidied up as development of the beta progresses.

Polar S610/S625x/S710/S720i/S725/S810

To use the Add Sessions feature, select 'Download Sessions' from the 'Add' Menu or click the 'Download' button from the toolbar. Select the port that the interface is connected to in the dialog box, and click the 'OK' button. The transmission of data from the HRM will begin. Once the transmission has finished, a dialog box will be displayed, showing the all the sessions stored in the HRM. Sessions shown in italics are session which are already in the currently open log file. Select the sessions to be added by checking the tickboxes next to each session. Click the 'Add' button to add the selected sessions.

SRM Power Controller Devices

To add a session using data from an SRM Power Controller, select 'Download Multiple Sessions' from the 'Add' Menu or click the 'Download' button from the toolbar. Select the port that the interface is connected to in the dialog box, and 'SRM Training System' from the 'Device' menu, then click the 'OK' button. The transmission of data from the controlled will begin. Once the transmission has finished, a dialog box will be displayed, showing the all the sessions stored in the unit. Sessions shown in italics are session which are already in the currently open log file. Select the sessions to be added by checking the tickboxes next to each session. Click the 'Add' button to add the selected sessions.

Ergomo Pro Devices

To add a session using data from an Ergomo Pro, select 'Download Multiple Sessions' from the 'Add' Menu or click the 'Download' button from the toolbar. Select the port that the interface is connected to in the dialog box, and 'Ergomo' from the 'Device' menu, then click the 'OK' button. The transmission of data from the controlled will begin. Once the transmission has finished, a dialog box will be displayed, showing the all the sessions stored in the unit. Sessions shown in italics are session which are already in the currently open log file. Select the sessions to be added by checking the tickboxes next to each session. Click the 'Add' button to add the selected sessions.

PowerTap Devices

Downloading from the PowerTap devices requires the FTDI driver to be installed. This driver can be download from http://www.ismarttrain.com/drivers/PowerTap USB Drivers.pkg.zip. This is the same driver that is installed by the PowerTap PowerAgent software. Only the USB download cradle is supported at this time.

To add a session using data from the PowerTap, select 'Download Multiple Sessions' from the 'Add' Menu or click the 'Download' button from the toolbar. Select the port that the interface is connected to (usually displayed as 'USB <-> Serial') in the dialog box, and 'PowerTap' from the 'Device' menu, then click the 'OK' button. The transmission of data from the controlled will begin. Once the transmission has finished, a dialog box will be displayed, showing the all the sessions stored in the unit. Sessions shown in italics are session which are already in the currently open log file. Select the sessions to be added by checking the tickboxes next to each session. Click the 'Add' button to add the selected sessions.

Garmin Devices

To add a session using data from a Garmin device, select 'Download Multiple Sessions' from the 'Add' Menu or click the 'Download' button from the toolbar. Select 'USB' from the port popup menu in the dialog box, and either 'Garmin Edge 605/705' or 'Garmin Forerunner/Edge' from the 'Device' menu, then click the 'OK' button. The transmission of data from the controlled will begin. Once the transmission has finished, a dialog box will be displayed, showing the all the sessions stored in the unit. Sessions shown in italics are session which are already in the currently open log file. Select the sessions to be added by checking the tickboxes next to each session. Click the 'Add' button to add the selected sessions.

To import from Garmin Forerunner 50, 60, 405 & 310xt, first sync your watch to your Mac using Garmin Ant Agent, then follow the steps above, selecting 'USB' for the port and 'Garmin Forerunner 405, 310xt & 50' as the device.

Polar HRM Files

iSMARTtrain can also import .HRM files from Polar windows software. To import these, select 'Import' from the 'File' menu.

You can then select the relevant sport, route, etc., and click the 'OK' button to add the session to the iSMARTtrain file.

The session will be shown in the summary box in the main window, and will have a small heart icon on the bottom, left, corner, indicating that the session contains Heart Rate data.

Edit Session

To edit an existing session, either double-click on the entry in the Session Diary, or Control-Click on the entry and select 'Edit' from the popup menu.

Delete a Session

To delete a session, Control-Click on the session, and select 'Delete' from the popup menu.

View Sessions Diary

The Sessions Diary shows the details of the session in either a list or a month calendar.

List View

In the list view, the sessions are grouped by week, separated by a single horizontal line. To display the full details of a session, click on it, and the details will be shown in the right panel of the window. It is also possible to edit a session by double-clicking on it, or by Control-Clicking on it. To delete a session, Control-Click on the session, and select 'Delete' from the popup menu.

Month View

The Month view allows the sessions to be viewed on a calendar-like view, by month. To show the Month view, select ‘Month’ from the ‘View’ menu. Each session in the month displayed will be shown in the respective day of the month, showing the Sport for the session. If the mouse cursor is moved over a particular session, the time and distance details of the session will be displayed in a popup window. To see the full details of a session, simply click on the sport name in the particular day. To edit a session, Control-Click and select 'Edit' from the popup menu. To move from one month to the next or previous month, use the buttons at the top of the window.

Filtering Session

To setup a filter to show sessions based on a search criteria, select 'Set Filter' from the 'Edit' Menu. You can set the filter to display sessions based on distance, time, date or duration. Once the filter has been set it will be applied to the currently open log file. To clear the filer, click on the 'Apply Filter' item in the 'Edit' menu. When a filter is applied, this menu item will have a tick against it.

View Graph

To view the sessions as a bargraph, select ‘Graph’ from the ‘View’ menu. Initially, the graph shows the number of session per week from the last 12 weeks. Popup menus at the top of the window allow this to be changed to display one sport or all the sports, to display sessions, time or distance for periods of 12, 24 or 48 weeks or 3, 6, 12 or 24 months. To select the date of the last week shown on the graph, click the 'from' button and select a date. Closing the date selection window causes the graph to update.

View Totals

The Totals window is displayed by selecting ‘Totals’ from the ‘View’ menu. Initially, it displays the Totals for each week. This can be changed from the Popup menu at the top of the window to display totals by Week, Month or Year. There is an option in the Preferences to show a grand total for each period, showing the total time and number of sessions.

View Keywords

The Keywords window is displayed by selecting ‘Keywords’ from the ‘View’ menu. The window will show the values of the keywords entered in the sessions as a graph. The period, end date and keyword displayed can be changed using the controls in the keyword graph menu.

View Heart Rate Data

The view the heart rate data downloaded from the HRM, the following options are available:

HR Data

HR Data displays the heart rate data and any associated speed, altitude and cadence data in a table. The left-most column shows the time since the start of the training session.

HR Graph

HR Graph shows the heart rate data plotted against time. Speed data can also be shown.

HR Distribution

HR Distribution shows the time spent in each heart rate band. The size (in HR beats) can be changed in the preferences ('iSMARTtrain' Menu).

HR Zones

HR Zones shows the time spent in each heart rate zone. The size and end points can be changed in the preferences ('iSMARTtrain' Menu for Mac OS X version).

HR Laps

HR Summary shows the lap times obtained from the HRM.

Preferences

The Preferences Dialog allows you to set the day that is used as the start of the week to either Saturday, Sunday or Monday. The units used for the ‘All Sports’ distance graph are also set here. To access the Preferences, select ‘Preferences’ from the ‘Edit’ Menu.

An option in the preferences dialog allows you to specify a file to be opened automatically by iSMARTtrain when it starts. You can also specify that it automatically opens the last file that was open when the application was quit.

Changes to V3.0.1

Pace/Speed is now calculated correctly in 'Add Session'.
If System date changes, 'Add Session' date now reflects this.
Using Filter causes crash when 'More Than' duration is used.
Filter now works correctly for 'Distance'.
Import of V2.0 files is now quicker.
Fixed crash importing V2.0 Logs.
Column Widths are now saved in list view.

Changes to V3.0.2

With certain international settings, HR Zones in Summary area are no longer lost after editing session.
Ascent calculation is now correct for garmin tcx files.
Laps are now correctly imported from garmin tcx.
No longer freezes when recalculating trimps/zones for sessions.

Changes to V3.0.3

Polar Temperature is now correct for Imperial units
SRM Downloading Improved
No longer crashes importing certain .hrm files
Changing Distance for RS200 sessions no longer looses duration for certain International settings

Changes to V3.0.4

Data Graph are no longer drawn incorrectly for Sessions with an Interval greater than 10 Seconds.

Changes to V3.0.5

Now correctly imports lap data from iSMARTtrain xml files
PowerTap downoading introduced
Preliminary support for downloading from Garmin devices introduced.

Changes to V3.0.6

Now support Garmin FR 310xt, 405 and 50 devices
Now supports Polar RS300x & FT80 devices with Flowlink interface.

Improvements and bug fixes in downloading from SRM, Ergomo, Garmin & PowerTap devices
Many other bug fixes and improvements.

Changes to V3.0.7

Now correctly imports laps in .FIT files/Germin Edge 500
Now shows moving time for .FIT files/Gamin Edge 500

Improved importing of Polar PPP data and Suunto STE Files
Speed in Laps window is now correct
Fixed permissions issue downloading from Soniclink devices with a non-admin account.

Changes to V3.0.8

Now correctly imports Altitude from SRM files
Imports CycleOps Joule .bin files
Moving time is now correctly calculated for PowerTap Cervo downloads
Improved import of .FIT files and correct import on PowerPC Macs
Support for Garmin Edge 800
Polar ppd import now correctly uses units set in PPP/Protrainer
Correctly imports run cadence from .tcx files.

Now correctly imports speed, distance and cadence from Garmin devices where GPS is switched off, and footpod is used

Changes to V3.0.9 Beta 1

Now uses Average & Max Power data from .FIT & .TCX files
Now correctly imports duration from FT80 & RS300x devices
No longer crashes on startup if preferences are corrupt

Changes to V3.0.9 Beta 2

Now correctly recognises FT80 GPS sessions as having speed data

Feedback

Please provide your thoughts, bug reports, suggestions and ideas for iSMARTtrain to Yellow Field Technologies, either in the forum on our website or by email to stuart@yellowfield.co.uk.

SonicLink Import

The component for decoding the SonicLink data is based on 'S410' from Tomás Oliveira e Silva. A copy of the original can be downloaded from http://www.ieeta.pt/~tos/software/polar_s410.html

The component for decoding the RS200Decode data is based on 'Polar RS200 decoder' from Jani Hursti. A copy of the original can be downloaded from http://sourceforge.net/projects/rs200-decoder

The component for downloading from Garmin devices is based on 'JEEPS' which is part of GPSBabel. A copy of the original can be downloaded from http://www.gpsbabel.org/

The source code for the modified versions of these applications, included with iSMARTtrain, is available on request from OTAG Technologies Ltd.

These components are released under the GNU general public license (version 2 or any later version); see the gpl.txt file (or the page http://www.gnu.org/licenses/gpl.html) for details.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Disclaimer

iSMARTtrain is supplied 'as-is' and no liability is accepted for any loss of data or damage caused by the use of this program. Use of this program implies acceptance of these terms. Please backup your important data.

About Yellow Field Technologies

Yellow Field Technologies were formed in 2010 to provide programming, web development and database technologies to industry. We are based near Aberdeen in Scotland.

Contact

OTAG Technologies Ltd. - http://www.yellowfield.co.uk
Stuart Tevendale
stuart@yellowfield.co.uk (sales, administration, etc.)
support@yellowfield.co.uk (bugs, problems, questions)