HAS-Motion Software Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Data Types in Inspect3D ======

Inspect3D's main purpose is to help users explore their data in a way that is both intuitive and meaningful. That being the case, it's helpful to understand the types of data that are stored in [[Visual3D:Documentation:C3D_Signal_Types:C3D_Format|.c3d files]], [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|.cmz files]], and that Inspect3D is able to handle.

==== Parameters ====

[[Visual3D:Documentation:C3D_Signal_Types:C3D_Format#C3D_Parameter_Format|Parameters]] are individual metadata items from a .c3d file. These define the data collection process (e.g., the number of analog channels or the sampling rate) and specify the location and type of data within the file. Parameters may be as simple as a single number or as complex as a list of names.

==== Signals ====

[[File:SignalsAndTraces.PNG|{{:SignalsAndTraces.PNG?600x356|"An example of many time-normalized traces plotted for the AnkleAngleX signal."}}]]

An example of many time-normalized traces plotted for the AnkleAngleX signal.


Signals are data items recorded over time by your motion-capture or data-acquisition system. Mathematically, signals are discretely sampled functions whose independent variable is time. Signals may be scalar-valued (e.g., a single voltage output by a strain gauge) or vector-valued (e.g., the x,y,z coordinates of a target marker).

==== Traces ====

A trace can be thought of as the actual data (such as the time series {1.1, 1.7, 1.3, 0.9, 1.2,...}) associated with a particular signal (e.g., LAnkleMoment_X) at a particular time (e.g., frames 341-1518 of a recording). Traces are generally taken from the time period [[Visual3D:Documentation:Pipeline:Event_Commands:Event_Define_Event_Sequence|defined by an event sequence]], such as RON (Right Foot On) followed by ROFF (Right Foot Off), and then time-normalized to allow for comparison between traces.


==== Events ====

Events indicate specific moments in a .c3d file with semantic meaning, such as Right Heel Strike for walking or Arm Cock Start for throwing. Visual3D can [[Visual3D:Documentation:Pipeline:Event_Commands:Automatic_Gait_Events|automatically create gait events]] if the .c3d file includes force platform assignments, otherwise it is necessary to [[Visual3D:Documentation:Pipeline:Event_Commands:Example_-_Gait_Events_using_Kinematic_Data|reconstruct these events]] from the file's kinematic data.

==== Metrics ====

[[File:Metric.PNG|{{:Metric.PNG?600x356|"An example of many maximum ground reaction force metrics plotted. "}}]]\\
An example of many maximum ground reaction force metrics plotted.


It is sometimes useful to compute quantities which in some way collapse the time dimension of traces (e.g., the mean value of a trace over a duration) or the spatial dimension of models (e.g., the center of mass of entire model). These quantities are called [[Visual3D:Documentation:Visual3D_Signal_Types:METRIC_Data_Type|metrics]] and they do not vary as a function of time or any other variable. A number of [[Visual3D:Documentation:Pipeline:Metric_Commands:Metric_Commands_Overview|pipeline commands]] exist to calculate common metrics from signals.