tcx2hrm is a Java based command line tool to convert Garmin TCX training files into Polar HRM data files. It offers a variety of features<\/a> to influence the conversion, however in most cases the default settings should be sufficient for most applications.<\/p>\n Note, that the information given below always applies to the latest version of tcx2hrm. Please refer to the version history<\/a> for information on previous functionality.<\/p>\n Download<\/a> the latest version of the application and extract it to your favourite directory. The distributable comes as GZIP compressed file, any unzip tool should be sufficient. Ensure that Java<\/a> at least version 1.6 is installed on your machine, that’s it!<\/p>\n The application is compiled with a 32 bit JDK, however I recommend to run a 64 bit state of the art JRE which is fully backwards compatible.<\/p>\n Running the application is quite simple if you do not need to use extended parameters:<\/p>\n This will start the tool with the TCX file inputname<\/em> with default settings. The tool will analyze the input file, extract the first track of the first lap and convert it to an HRM file in the local directory. The HRM filename will follow Polar’s convention: To make a long story short, the tool supports the following list of command line options:<\/p>\n Fully qualified name of the TCX file. This is a mandatory parameter in normal operation mode.<\/p>\n Fully qualified name of the HRM file to create. If not used, the Polar standard convention will be used (see above).<\/p>\n Selects the sport session to use in a so-called „MultiSportSession“ record. Defaults to 1. Please refer to your Garmin device manual for more information on multi sport sessions. Use the Selects the method to be applied for converting<\/a> the input data. For This is mainly related to the difference on data recording between TCX (time variance) and HRM (fixed time interval). During conversion, tcx2hrm calculates one<\/em> data record per second<\/em>.<\/p>\n If this option is provided, the GPS data will be stored in a separate GPX<\/a> compatible XML file. A GPX file<\/a> is used by various applications to manage recorded GPS information. For example, Polar Pro Trainer uses GPX files together with Google Earth<\/a> in case the Polar device used a G3 sensor to record GPS coordinates.<\/p>\n Using this option the filename of the GPX file will be equal to the HRM file, except of the file extension being „gpx“, as both files belong together. tcx2hrm will store waypoint, route and track information per default. Lap information will be kept, as the track is segmented accordingly. Use Note, that GPX file data will be compiled out of the raw TCX file content, no data manipulation will be applied.<\/p>\n The more advanced version of the Note, this switch is for advanced users only, who are experienced in GPS data. Default values are designed to be applicable for most users. In fact Prints out the help splash screen with a short summary on available command line options. No further operations will be executed.<\/p>\n Selects the time interval the data will be aligned to in the HRM output file. According to the specifications, following values are available for the parameter Selects a lap, that should be considered for data conversion. Sets the Polar device, which is used as the virtual source for the data. Following values are supported for parameter Default values is S725X. Setting this to a different value might cause issues, as tcx2hrm does not check, whether the monitor supports all the data which is in the HRM file. However, the list only covers monitors with data download capabilities.<\/p>\n Selects the method to be applied for normalizing<\/a> the input data. For <\/p>\n Use this option to define the (restrictive) log level. Following values are available:<\/p>\n Setting the level to 1 means, that info, warning and error messages will be printed.<\/p>\n Analyses the TCX input file and prints out statistical data. No further operations will be executed.<\/p>\n Selects a track, that should be considered for data conversion. Requests unit conversion, any data values will be converted from SI units (km\/h, km, m) to US units (mp\/h, miles, ft). TCX data is always in SI units, HRM supports both.<\/p>\n Sets the HRM file version to be used as output format. String Version can be V102, V105, V106 or V107. Default is V107 which provides the most flexibility. Using a different version restricts the support for specific data content, monitors and further options in the HRM file.<\/p>\n For any questions you would like to dig into in terms of data accuracy, please refer to this article<\/a>.<\/p>\n Since v0.22 tcx2hrm supports an external configuration file, storing static fitness data. tcx2hrm searches for a file Beside of creating an outputfile (default operation), the tool returns different exit codes, depending on the stop condition. Those can be evaluated, e.g. via shell or batch script:<\/p>\n Introduction tcx2hrm is a Java based command line tool to convert Garmin TCX training files into Polar HRM data files. It offers a variety of features to influence the conversion, however in most cases the default settings should be sufficient … Weiterlesen Installation<\/h3>\n
Running the application<\/h3>\n
java -jar tcx2hrm.jar inputname<\/em><\/code><\/p>\nYYYYMMDD.hrm<\/code>, where YYYY<\/code> is the year, MM<\/code> the month and DD<\/code> the day of the month, filled up with leading zero’s if required. The HRM file content will follow the specifications for version v1.07 with a virtual S725X monitor and five second interval. This ensures, that most of the TCX training data can be transferred to the HRM format. If you want to understand in detail, what is going on during conversion, please refer to this page<\/a>.<\/p>\nAdvanced parameters<\/h3>\n
java -jar tcx2hrm.jar tcxfilename [hrmfilename] [-a N] [-c N] [-g] [-G XYZ] [-i Interval] [-l N] [-m Monitor] [-o N] [-s] [-t N] [-u] [-v Version]<\/em> <\/em><\/code><\/p>\ninputname<\/em><\/code><\/p>\noutputname<\/em><\/code><\/p>\n-a N<\/em><\/code><\/p>\n-s<\/code> switch if you are not sure, whether a multi sport session was recorded.<\/p>\n-c N<\/em><\/code><\/p>\nN<\/code> use the following values:<\/p>\n\n
-g<\/em><\/code><\/p>\n-G<\/code> option to influence behaviour as required.<\/p>\n-G XYZ
\n<\/em><\/code><\/p>\n-g<\/code> option. XYZ is a three digit, numeric value, where tcx2hrm expects:<\/p>\n\n
-G 111<\/code> would give the same result as -g<\/code>.<\/p>\n-h<\/em><\/code><\/p>\n-i Interval <\/em><\/code><\/p>\nInterval<\/code>:<\/p>\n\n
-l N<\/em><\/code><\/p>\nN<\/code> is the positive integer number of the lap, starting with 1. Setting this value to zero forces the application to combine all laps into one output file but keep lap information in the intermediate times section. Default = 1.<\/p>\n-m Monitor<\/em><\/code><\/p>\nMonitor<\/code>:<\/p>\n\n
-n N<\/em><\/code><\/p>\nN<\/code> use the following values:<\/p>\n\n
-o N<\/em><\/code><\/p>\n\n
-s<\/em><\/code><\/p>\n-t N<\/em><\/code><\/p>\nN<\/code> is the positive integer number of the track, starting with 1. Settings this value to\u00c2\u00a0 zero triggers the concatenation mode, where all tracks (of the selected lap) are concatenated. Default = 1.<\/p>\n-u<\/em><\/code><\/p>\n-v Version<\/em><\/code><\/p>\nConfiguration file<\/h3>\n
tcx2hrm.cfg<\/code> on startup. The (text) configuration file follows a quite simple convention, where the application expects a single parameter\/value pair per line, separated via „=“. Following parameters are supported:<\/p>\n\n
\nInteger value of your maximum heart rate in bpm. Default is 0.<\/li>\n
\nInteger value of your resting heart rate in bpm. Default is 0.<\/li>\n
\nInteger value of your maxium oxygen consumption<\/a> value in ml\/kg\/min. Default is 0. Only used in HRM file version 1.06 or higher.<\/li>\n
\nInteger value of your weight in kg. Default is 0. Only used in HRM file version 1.06 or higher<\/li>\n
\nUse these parameters to define your personal HR zones, which will be written in the corresponding section in the HRM file. X<\/span> starts with one (zone 1 upper limit) and ends with eleven (zone 10 lower limit), e.g. HRM_ZONE5<\/li>\n
\nUse this parameter with value „1“ in case you want to override the check for heartrate presence in the input file. tcx2hrm will then be forced to zero fill heartbeat information in the output file.<\/li>\n
\nIf this parameter is provided with the value „1“, breaks within laps will be interpolated. Use this, if the lap segmentation in the exercise data is not desired.<\/li>\n
\nIf this parameter is provided with the value „1“, breaks within tracks will be interpolated. Use this, if the track segmentation in the exercise data is not desired.<\/li>\n<\/ul>\nReturn values<\/h3>\n
\n