This is an old revision of the document!
Table of Contents
Welcome to HAS-Motion’s Visual3D motion analysis software. The Visual3D software provides kinematics and kinetics (inverse dynamics) calculations for biomechanical analysis of 3D motion capture data.
Prior to beginning the tutorials, if you haven't done so already, we recommend that you look over the documentation on the Visual3D Philosophy. There is some beneficial information particularly for first time users in this section.
If you are a new user of Visual3D, here is a guide to suggest in which order the tutorials should be done for learning Visual3D. [image Learning Visual3D]
Visual3Ds native CMZ file format contains the entire Visual3D workspace, so the files can get quite big. If you need to send a file to support@has-motion.com please reduce the size of the file before sending it.
Tutorial Overview
To begin, an overview of the Visual3D workspace and the interface in the Visual3D Workspace page and the Getting Started page is recommended. Additionally, an overview of the Signals and Events interface will describe how data from a c3d file is stored in the Data Tree and plotted through 2D Interactive Graphs, and how motion files may be animated through the 3D Animation Viewer. In the original set of tutorials, each tutorial followed from the previous tutorial. Over time additional tutorials were added that don't follow on from previous tutorials; these can be attempted as standalone efforts.
All files for the tutorials can be found here.
This page begins with a list of tutorials intended for a beginner user, once those are completed the other tutorials can be followed as needed. The rest of the tutorials follow a typical order in which Visual3D is used, with more tutorials targeting specific and advanced commands.
Beginner Tutorials
Laboratory Checklist
There are many crucial steps in collecting “routine” motion capture data, and especially as a beginner, checklists are important to process oriented tasks (see, for example: https://gawande.com/the-checklist-manifesto The Checklist Manifesto).
The following partial list, Testing Setup Checklist, is a starting point for every Motion Capture Laboratory.
We encourage users to contribute to this list by sending additional tasks to support@has-motion.com
Typical Processing Session
These tutorials are meant to be followed for a first time user or a beginner. It will provide guidance for building a model, opening movement trials, assigning a model to motion trials, basic signal processing, model based items and reporting. The typical processing session tutorial provides an overview of the tutorials, but it is recommended to follow these tutorials listed in chronological order. Once these tutorials are finished you will be able to save a complete CMZ file.
* Tutorial: Building a 6 DOF Model: This tutorial will teach you the basics of building a model, defining various segments in a lower body gait model.
* Tutorial: Visualizing Data: This tutorial will teach you how to assign a model to motion files, and how to work with .c3d files.
* Tutorial: Command Pipeline: This tutorial will teach you how to use the command processing pipeline and how to work with Visual3D's pipeline commands.
* Tutorial: Signal Processing: This tutorial will teach you an overview of signal processing in Visual3D.
* Tutorial: Force Platforms: This tutorial will teach you the basics of processing force platform data into Visual3D.
* Tutorial: Event Processing: This tutorial will teach you how to create and edit events.
* Tutorial: Model-based Computations: This tutorial will teach you the basics of computing and understanding joint angles and moments.
* Tutorial: Creating a Report: This tutorial will teach you how to create and edit a report.
* Tutorial: IOR Gait Full-Body Model: This tutorial illustrates doing gait analysis using the IOR protocols.
* free CMO reader??
Pipeline for Creating Basic CMZ File
Once you feel like you understand the basics of how Visual3D works and processes your .c3d files, it is possible to complete all steps using pipeline commands. The Generic Pipeline to Create CMZ tutorial walks through the pipeline commands typically used to create a CMZ file. A full pipeline script for a typical processing session following these steps can be found here.
Support Email Format
We encourage you to reach out to support@has-motion.com for any questions or suggestions.
The following Support Format provides guidance on how to send scripts and data.
Building Models
It is important to fully understand how to build a model as it is typically one of the first things that is completed and needed for a proper analysis. The following tutorials go in depth on how to build a model, and common models.
Modeling Concepts
* Tutorial: Building a 6 DOF Model: This tutorial will teach you the basics of building a model, defining various segments in a lower body gait model. This tutorial is the same model building tutorial in the beginner section.
* Tutorial: Creating Landmarks: This tutorial shows the many different ways to create landmarks (virtual markers) in Visual3D.
* Tutorial: Building an IK Model:This tutorial demonstrates how to define Inverse Kinematic chain for use with a model in V3D. It also provides a video tutorial.
* Tutorial: Modeling the Thorax: This tutorial goes over how to model the thorax and abdominal segment.
Gait Models
* Tutorial: Building a Conventional Gait Model:This tutorial describes a lower body conventional gait model.
* Tutorial: IOR Gait Full-Body Model: This tutorial describes the Istituto Ortopedico Rizzoli's (IOR) full-body gait model.
* Tutorial: Plug-In Gait Lower-Limb: This tutorial describes the implementation of [https://www.vicon.com Vicon's] Plug-In gait using Visual3D. This tutorial only covers the lower-Extremities Plug-In gait model.
Upper-Body Models
* Tutorial: Plug-In Gait Upper-Body: This tutorial describes the implementation of [https://www.vicon.com Vicon's] Plug-In gait using Visual3D. This tutorial upper-body Plug-In gait model.
* Tutorial: Rab Upper Extremity Model:This tutorial describes the model based on the upper extremity model developed by Dr. George Rab, Kyria Petuskey, and Anita Bagley from Shriners Hospital for Children, Northern California. Refer to their paper “A Method for Determination of Upper Extremity Kinematics” Gait & Posture 15 (2002) 113-119 for the exact model specifics.
Foot Models
Visual3D is a general tool capable of modeling all of the different foot models. The following tutorials list variations of foot models for your choosing.
* Tutorial: Oxford Foot Model:This tutorial focuses on the Oxford Foot Model version implemented as a Plug-in option in Vicon's Nexus software. The Oxford Foot Model is a good choice for analyzing data from Children with Cerebral Palsy. If this is not your patient population, other options and other multi-segment foot models may be more appropriate. The following [References for Oxford Foot Model] provides an in-depth explanation of the Oxford Foot Model.
* Tutorial: IOR Foot Model 2014: This tutorial focuses on the updated 2014 Istituto Ortopedico Rizzoli's multi-segment foot model. The IOR foot analysis uses joint angles and planar angles to describe the motion of the foot. The following [References for IOR Foot model] provides an in-depth explanation of the IOR Foot Model.
* Tutorial: IOR Foot Model 2007: This tutorial focuses on the ORIGINAL 2007 Istituto Ortopedico Rizzoli's multi-segment foot model. The following [References for IOR Foot model] provides an in-depth explanation of the IOR Foot Model.
* Foot and Ankle Angles: This tutorial focuses on various ways of representing the foot segment, so that the foot angle (foot relative to the laboratory) and the ankle angle (foot relative to the shank) are defined in ways that are consistent with the common colloquial uses of the angles.
* ** Bicycle Pedal and Crank* **: This tutorial creates a crank and pedal segment, given a c3d file with one marker on each pedal of a stationary bicycle.