HAS-Motion Software Documentation

This is an old revision of the document!

---

.c3d files]], [[visual3d:documentation:definitions:file_formats:cmz_format_|.cmz files]], and that sift 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 ===== sift_signalsandtraces.png.png 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 ===== sift_metric_example.png 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. }}