Inspect3D Overview: Difference between revisions

From Software Product Documentation
Jump to navigation Jump to search
No edit summary
No edit summary
Line 52: Line 52:




<span style="font-size:150%">
<!--<span style="font-size:150%">
<span style="font-family:Garamond;">
<span style="font-family:Garamond;">
<span style="color:darkblue">Inspect3D and the Visual3D CMO Library.</span>
<span style="color:darkblue">Inspect3D and the Visual3D CMO Library.</span>
</span>
</span>
</span>
</span>-->


=Inspect3D and the Visual3D CMO Library=


The Inspect3D program accesses [[CMO_Library|Visual3D's CMO library]] directly, and is thus ideal for exploring large amounts of data from the library. Visual3D tends to be a "session based" analysis tool, and is used to process data from one (or a few) data collection sessions, rather than a project based tool. Inspect3D was created to bridge the gap between the biomechanical analysis of the Motion Capture data collected from a single subject to the scientific enterprise of trying to make sense of data from a group or population.
The Inspect3D program accesses [[CMO_Library|Visual3D's CMO library]] directly, and is thus ideal for exploring large amounts of data from the library. Visual3D tends to be a "session based" analysis tool, and is used to process data from one (or a few) data collection sessions, rather than a project based tool. Inspect3D was created to bridge the gap between the biomechanical analysis of the Motion Capture data collected from a single subject to the scientific enterprise of trying to make sense of data from a group or population.

Revision as of 20:36, 28 April 2022

Language:  English  • français • italiano • português • español 

Inspect3D. Analytics and Data Exploration for Biomechanics.


Classify. Analyze. Reduce. Explore


The Quality of your Data matters. 3D Motion Capture is an incredibly powerful tool for recording the motion of markers attached to a subject. Anyone that records and analyzes 3D MoCap data for a living recognizes the subtle challenges of getting a good representation of the position and orientation of the skeleton of a subject in a repeatable and reliable way. As Murphy's law states, Anything that can go wrong, will go wrong.


Investigators must be tremendously diligent about the integrity of their data by developing principled processes for data collection and analyses, but artifacts do "slip in". Inspect3D is a tool that allows you to explore your Visual3D library of motion capture data (cmo files) to ensure that the signals that are used in your interpretation of the data or statistical analyses are as free from artifacts as possible.


Inspect3D then takes care of the bookkeeping required to keep track of the data in a supervised way, allowing you to return quickly to the original data files, and to allow systematic querying of all of your library for isolating the groups of signals that will be used for your analyses. By simply storing your query, you can return to your analyses at a future time (e.g. when the reviewer's have critiqued your article), or you can access the work of a colleague or trainee directly from your own desk.


Inspect3D provides a powerful tool for those who CARE about their data; Reduce the data to signals that are free from artifact or errors; Explore your data efficiently; Classify and Analyze your data statistically; or export the data to third party statistical analysis tools.

Visual3D

⇨CMO⇨

Inspect3D



Inspect3D and the Visual3D CMO Library

The Inspect3D program accesses Visual3D's CMO library directly, and is thus ideal for exploring large amounts of data from the library. Visual3D tends to be a "session based" analysis tool, and is used to process data from one (or a few) data collection sessions, rather than a project based tool. Inspect3D was created to bridge the gap between the biomechanical analysis of the Motion Capture data collected from a single subject to the scientific enterprise of trying to make sense of data from a group or population.

The CMO Library (more...)



Inspect3D is tightly coupled with Visual3D's CMO Library and is able to perform Structured Queries of the lab and retrieve the data for display, or as a collection to be exported for statistical processing in third party applications.


The Visual3D library is defined by a root directory. All cmo.cmx files within the root directory and sub directories are part of the cmo library.


caption



Structured Queries of the Visual3D CMO Library.


Permits the user to query the library by group (Visual3D Tag), signal (Joint Angle), temporal range (Heel Strike to Heel Strike), plus a variety of metric values (age, height). The flexibility to mix and match or to sequentially refine a query allows deep exploration of the data.


Structured Queries (more....)


There are three categories for queries; events, signals, and refinement.


Events: Allows the user to specify the desired event sequence (e.g Heel Strike to Heel Strike)
Signals: Allows the user to perform signal selection
Refinement: Allows the user to refine their selected signals


Tutorial_1


caption



Exporting Data from the Visual3D CMO Library.


Many of our customers currently export data from Visual3D to be used in Statistics programs. The problem with this approach is that the elaborate "model definitions, signal definitions, signal history" properties of the signals that is generated by Visual3D and stored in the cmo library, gets lost. This forces the user to derive their own bookkeeping strategies for their data, which at best are a replication of the cmo library, and at worst are completely lost. Inspect3D allows you to preserve the rich legacy of the data, while still getting data files formatted for your favorite statistical package.


Exporting Data (more...)


Visual3D has a default ASCII file format that is flexible and comprehensive, but often needs to be transformed before it can be easily imported into other applications. Inspect3D provides the capability to elaborate the possible formats for this data. Rather than the Visual3D ASCII file format, the user will be able to create the exported data in the format they want. |Inspect3D Tutorial 2


caption



Inspect3D as a Quality Assurance Tool.


During the development of Inspect3D we discovered that it was incredibly useful for exploring data quickly, and its role in "Quality Assurance" dominated our early use of the tool. Many research studies involve data collected by multiple investigators from multiple labs - differences that are liable to lead to artifact. The Quality Assurance function of Inspect3D is particularly helpful for lab managers (or supervisors of students) who may not be familiar with the raw data, or for collaborators that were not involved in the data collection process. For instance, Inspect3D allows the user to check the force assignments of all their files at once, and then easily correct any artifacts that are found.


Thanks to [XKCD.com]


Most, if not all, Motion Capture data contains artifact of some sort, and it is a nuisance, at best, and a catastrophe, at worst, if these affect the statistical analysis, and consequent interpretation of data. Inspect3D's ability to provide a straightforward way to examine all data used in any statistical analysis has generated considerable interest with academic and industrial researchers, during many discussions we have held at various conferences and lab visits, all over the world, this year.



These two figures contain data from the same cmo library. Several of the signals in the left figure were artifacts that were removed from the analysis by Inspect3D. Each signal can be traced back to its source data file to verify that there was something wrong, or that the problem was correctable (e.g. Motion Capture markers may have been mislabeled). Clearly stats performed on the left graph will be different that the same stats on the right graph.


Inspect3D takes a necessary chore that may take hours using other software into a streamlined process that takes minutes to perform.


Data Quality Assurance (more....)

If an errant signal is found in these other packages, it can be both difficult and time consuming to trace the issue back to a cmo file and individual trial. Inspect3D is tightly coupled with the cmo library.


For a step-by-step example of how to use Inspect3D as a Quality Assurance tool see our Quality Assurance Tutorial.



Simply selecting a trace on a graph allows that signal to be tracked back to the corresponding frames of data in the original c3d file. This means that if the artifact is correctable (e.g. an event was labeled incorrectly, or markers names were swapped during labeling), Visual3D can be launched and the issue resolved. Likewise if the issue is unresolvable (e.g. a double foot contact on a force platform during an inverse dynamic analysis), the c3d file can be removed. Once done, simply saving the cmo file after the 'fix', updates the cmo library automatically.


caption



This clean data set has more veracity than the "messy" data set.


caption



This figure displays the mean and standard deviation for the "messy" data set shown above.


caption



Removing artifact is important to the correct interpretation of any differences (or lack of difference) between the two experimental conditions. Note that the data on the mean and standard deviation in the messy data set could easily be used to produce results should there not be a convenient way to identify artifact.


caption



Biomechanical Waveform Data.


Many biomechanical signals (eg. joint angles or joint moments) are represented by a time series of data and should be compared statistically as time series.


Zero dimensional analyses of one dimensional signals (more....)


Pataky TC, Vanrenterghem J, Robinson MA (2016) [The probability of false positives in zero-dimensional analyses of one-dimensional kinematic, force and EMG trajectories] J. Biomech, in press


Abstract
A false positive is the mistake of inferring an effect when none exists, and although α controls the false positive (Type I error) rate in classical hypothesis testing, a given α value is accurate only if the underlying model of randomness appropriately reflects experimentally observed variance. Hypotheses pertaining to one-dimensional (1D) (e.g. time-varying) biomechanical trajectories are most often tested using a traditional zero-dimensional (0D) Gaussian model of randomness, but variance in these datasets variance is clearly 1D. The purpose of this study was to determine the likelihood that analyzing smooth 1D data with a 0D model of variance will produce false positives. We first used random field theory (RFT) to predict the probability of false positives in 0D analyses. We then validated RFT predictions via numerical simulations of smooth Gaussian 1D trajectories. Results showed that, across a range of public kinematic, force and EMG datasets, the median false positive rate was 0.382 and not the assumed α=0.05, even for a simple two-sample t test involving N=10 trajectories per group. The median false positive rates for experiments involving three-component vector trajectories was p=0.764. This rate increased to p=0.945 for two three-component vector trajectories, and to p=0.999 for six three-component vectors. This implies that experiments involving vector trajectories have a high probability of yielding 0D statistical significance when there is, in fact, no 1D effect. Either (a) explicit a priori identification of 0D metrics or (b) adoption of 1D methods can more tightly control α.


Each of the signals in the figure is time normalized to 101 points (common in most gait studies), resulting in more than 10,000 data points in this figure. In the figure there is data from two groups of subjects. Identifying differences between groups (typically an important statistical goal) is challenging because of the substantial variability within each group. The challenge is to identify the most salient features of the data that discriminate the two groups without removing important information.


Principal Component Analysis.


The original intention of Inspect3D was actually to perform waveform based Principal Component Analysis (PCA). PCA was developed in Collaboration with Dr. Kevin Deluzio at Queen's University, and follows the explanation of the analysis described in Research methods in Biomechanics.


Principal Component Analysis (more....)

For a step-by-step example of how to use Inspect3D PCA see our Principal Components Analysis Tutorial.



From each signal we could identify many isolated metrics (e.g. maximum and minimum values) and compare the signals based on a comparison of these metrics. Given that there is a common underlying shape to all of these signals, it might be better to use a multivariate statistical technique that can capture this basic shape and compare the shape of each signal to this underlying shape.


caption


Principal component analysis (PCA) is a multi-variate statistical analysis that reduces the high-dimensional matrix of correlated, time varying signals into a low-dimensional and statistically uncorrelated set of principal components (PC). The PC scores represent the most important features of the data, e.g. the overall magnitude or the shape of the time series at a particular point in the stride cycle. The value of each particular subject’s score represents how strongly that feature was present in the data. Each of the principal components explains variance in the original signals


Our implementation of Principal Component Analysis is based on the following article:


Deluzio KJ and Astephen JL (2007) Biomechanical features of gait waveform data associated with knee osteoarthritis. An application of principal component anslysis. Gait & Posture 23. 86-93 (pdf)


Abstract
This study compared the gait of 50 patients with end-stage knee osteoarthritis to a group of 63 age-matched asymptomatic control subjects. The analysis focused on three gait waveform measures that were selected based on previous literature, demonstrating their relevance to knee osteoarthritis (OA): the knee flexion angle, flexion moment, and adduction moment. The objective was to determine the biomechanical features of these gait measures, related to knee osteoarthritis. Principal component analysis was used as a data reduction tool, as well as a preliminary step for further analyses to determine gait pattern differences between the OA and the control groups. These further analyses included statistical hypothesis testing to detect group differences, and discriminant analysis to quantify overall group separation and to establish a hierarchy of discriminatory ability among the gait waveform features at the knee. The two groups were separated with a misclassification rate (estimated by cross-validation) of 8%. The discriminatory features of the gait waveforms were, in order of their discriminatory ability: the amplitude of the flexion moment, the range of motion of the flexion angle, the magnitude of the flexion moment during early stance, and the magnitude of the adduction moment during stance.
Retrieved from ""