You are viewing the documentation for OpenSim 3.x. Are you looking for the latest OpenSim 4.0 Documentation?

Marker (.trc) Files

The topics covered in this section include:

Overview

The .trc (Track Row Column) file format was created by Motion Analysis Corporation to specify the positions of markers placed on a subject at different times during a motion capture trial. An example .trc file (subject01_walk1.trc) is provided in the Models/Gait2354_Simbody directory, which is part of the OpenSim distribution. A fragment of this file is shown in the figure below.


Figure: .trc File. The first few lines of the file are shown here.

The first three lines of the .trc file is a header, followed by two rows of column labels, followed by a blank row, followed by the rows of data. Each row of data contains a frame number followed by a time value followed by the (x, y, z) coordinates of each marker. As a plain text file, a .trc file is commonly tab-delimited. So, for example, the fourth line in the .trc file figure above would look like this in plain text:
Frame#<tab>Time<tab>R.ASIS<tab><tab><tab>L.ASIS<tab><tab><tab>V.Sacral… where <tab> indicates each tab character that would be present in the file.

DataRate, 60 in this case, indicates the sampling rate of the data in this .trc file in Hertz. So, for example, from frame 1 to frame 2, the time increases by 1/60 second. NumFrames, 900 in this case, indicates the number of frames (rows) of data in the whole .trc file. OrigDataStartFrame, 1 in this case, indicates the frame number of the first frame (row) of data in the .trc file. Thus, the time t at which frame f was captured is t = (f – OrigDataStartFrame) / DataRate.

Note that the fourth row, which contains column labels, contains the name of each marker in the first column where the marker's coordinates appear. In the fifth row, the individual coordinates of each marker are actually labeled as X1, Y1, Z1, X2, Y2, Z2, etc. If this format for the fourth and fifth rows is not followed by a .trc file, OpenSim may fail to read the file's data correctly.

The manual for Motion Analysis' EVaRT (EVa Real-Time Software) contains a description of the .trc file format. For example, in the EVaRT 4.2 manual, the .trc file format is described in Appendix G on pages G-4 and G-5.

Representing Marker Data in a .trc File

As mentioned earlier, marker data must be imported into OpenSim in a .trc file with all marker coordinates transformed to the model coordinate system. An example .trc file (subject01_walk1.trc) is provided in the examples/Gait2354_Simbody directory, which is part of the OpenSim distribution.

In addition, the chapter on Scaling has details on how to represent the marker set in an XML file. It is important that the names of the markers given in the XML file describing the marker set be exactly the same as the names of the markers in the fourth line of the .trc file.

 

OpenSim is supported by the Mobilize Center , an NIH Biomedical Technology Resource Center (grant P41 EB027060); the Restore Center , an NIH-funded Medical Rehabilitation Research Resource Network Center (grant P2C HD101913); and the Wu Tsai Human Performance Alliance through the Joe and Clara Tsai Foundation. See the People page for a list of the many people who have contributed to the OpenSim project over the years. ©2010-2024 OpenSim. All rights reserved.