User guide

Charnwood Dynamics Ltd. Coda cx1 User Guide – Reference IV-3
CX1 USER GUIDE - COMPLETE.doc 26/04/04 147/162
A text-format data file does not include the marker in-view flags, Comments, nor any of the
derived data types (Velocity, Acceleration, Joint Angle etc.)
Loading Text data
Tabulated text data may be loaded into Codamotion Analysis with File: Open.... The file
format is recognized automatically from the label in line 1 (the filename extension does not
need to be ‘TXT’). Each line must end with either a newline character (‘\n’ ASCII(10)) or a
return-newline pair (‘\r’’\n’ ASCII(13) + ASCII(10)). The Tab character is ASCII(9). Spaces are
not acceptable in place of Tabs.
Line 1: must begin “CODAmotion Analysis Text”. (Any more text before the end-of-line is
ignored.)
Line 2: Anything in this line is loaded as text Comments data (displayed in the Comments
View).
Line 3: must contain the data-type labels “Time” and “Markers” in columns 1 and 2
respectively.
The ‘Time’ label must be followed by a single Tab character, and the ‘Markers’ label
must be followed by a number of Tab characters equal to the total number of marker
data columns (minus 1 if there is no force data following). If analogue force channel
data is present, the label “ForcePlate” must follow, followed by (8n - 1) Tab
characters.
Line 4: Channel names: There must be a name for each data column, followed by a single
Tab character, except for the last name. Column 1 should be “Time”.
Marker channel names must be repeated for each coordinate dimension, and suffixed
“.X”, “.Y”, “.Z”. Analogue channel (Force) channel names must be suffixed “.1”, “.2”,
“.3”, etc., and must be present in groups of 8.
(Currently (version 2.52), these names are not restored to the Codamotion Analysis
Setup - you need to create a new Setup or re-load the original Setup manually. Also,
the data is assumed to be in x, y, z order: the dimension characters are not checked.)
Line 5: Units: There must be a units name for each column, enclosed in parentheses, e.g.
“(mm)”, and followed by a Tab character, except the last.
(Currently (version 2.52), these names are not used by Codamotion Analysis: Time
data is assumed to be in seconds, and coordinate data is assumed to be in mm.)
Lines 6 to EOF (end-of-file): Data: One line per epoch.
Values are read as floating point. Each value must be followed by a Tab character,
except the last. There must be no blank entries (except wholly blank lines).
Data lines are read to the end of file mark.
Entirely blank rows (nothing but Tab characters) are ignored.
The time resolution of the data (epoch period) is calculated from the first 10 Time values;
subsequent Time values are ignored.
If data is saved from a Microsoft Excel worksheet as ‘Tabulated Text’, the formatting will be
accepted by Codamotion Analysis. The text for lines 1 and 2 should be in the leftmost cells.