Building a 6 DOF Model


This is the first tutorial in the Visual3D typical processing session, each of the tutorials will go over the sequence of steps involved in handling and analyzing data in the application. This specific tutorial will go over building a 6 DoF Model from a motion capture dataset.

The techniques learned here will be consistent with all Visual3D models. However the model described in this tutorial is only designed to illustrate the principles of model building and should not be considered the Default Visual3D lower-body model. Once the user learns the basics of building models, it is up to them to decide what model and marker set is most appropriate for their analyses.

If you prefer, a video tutorial is available outlining the same process. It is available at this link: Visual3D Video Tutorial 1: Building a 6 DOF Model.

There are 6 basic steps to performing an analysis of motion capture data in Visual3D:

  1. Create a model of your subject using a standing trial and define the linked segments
  2. Explore your movement trials, and associate them with your model
  3. Perform any signal and event processing required
  4. Define any biomechanical model-based calculations (joint angles, moments, powers, etc.)
  5. Generate the desired reports
  6. If desired, export data for statistical processing

In this tutorial we will:

  1. Load a standing calibration trial
  2. Define various segments to create a lower-body a gait model.

Key Concepts

A calibration file (often referred to as a Standing Trial or a Static Trial) is a short motion capture of the subject in a stationary pose. Marker positions are averaged automatically over all frames to compensate for noise in the data. NOTE: If the subject moved during the standing trial, you can specify a subset of frames using the [[visual3d:documentation:definitions:static_trial|Modify Frame Range For Static Calibration]] command from the Model Menu items.

{{:tutorial1_1.gif}}

Anatomical markers or Calibration markers are placed at anatomically relevant locations (e.g. palpable bony landmarks near segment endpoints).
Tracking markers are placed at convenient locations for tracking the segments. Suggested rules for marker placement on rigid clusters is described in the following article:
Cappozzo A, Cappello A, Della Croce U, Pensalfini P (1997) Surface-Marker Cluster Design Criteria for 3-D Bone Movement Reconstruction. IEEE Transactions on Biomedical Engineering, 44 (12), p 1165-1174.


Preparing for the Tutorial


1. Ensure that version 3.0 or later of Visual3D has been downloaded and installed.
2. Download the Visual3D Tutorial 1 Sample Data.
3. Save this file in the folder where you plan to save your motion capture files.
    NOTE: The download contains the end result of this tutorial. It may be useful as a secondary resource for verifying your progress.
4. Launch the Visual3D program from the Start menu.
    The program will open to the main workspace.

Before completing this tutorial please review the [[visual3d:documentation:reports:3dvieweranimationcontrols|3D Viewer Animation Controls.]]

Create a Hybrid Model

1. From the Model menu, select Create -> Hybrid Model from C3D file.

2. A dialog titled Select the calibration file for the new model will appear;

Select Sub01_StandingStaticCal01.c3d Click Open.

{{:tutorial1_2.jpg}}


3. Visual3D will switch to Model Building mode automatically. The 3D viewer will display the average value of the marker locations from the standing file. The dialog bar to the left of the screen will contain a list of segments, which by default will contain only a segment representing the Laboratory (e.g. Motion Capture Volume).
Note: Your screen may look slightly different.

{{:tutorial1_4.jpg}}


3D View Options

Throughout this tutorial, play with some of the 3D view options to familiarize yourself with these options:

With your mouse, use the [[visual3d:documentation:reports:3dvieweranimationcontrols|3D Viewer Animation Controls.]] to rotate/pan your view of the model.

{{:TID.jpg}}

1. Click the View Target ID toggle button on the toolbar until the target names appear.

{{:ShowBonesButton.jpg}}

2. Click the View Segment toggle button on the toolbar until the pelvis bone disappears (the same effect can be achieved by pressing F5 on your keyboard).

{{:GeometryToggle.jpg}}

3. Click the View Segment Geometry toggle button on the toolbar until you toggle off geometric view the pelvis (the same effect can be achieved by pressing F7 on your keyboard).

{{:SegmentToggle.jpg}}

4. Click the View Segment Lines toggle button on the toolbar until you toggle off the yellow lines which connect the segment end points.


Creating the Pelvis Segment

There are many possible markers for a pelvis segment that make sense anatomically, and have a history in the biomechanics community. Visual3D offers 3 default pelvis segments:

1) [[visual3d:documentation:modeling:segments:visual3d_pelvis|Visual3D Pelvis]] - The default pelvis segment in Visual3D is labeled a Visual3D Pelvis since the pelvis can be constructed as any other segment. Visual3D inherited this definition from MOVE3D (the precursor software to Visual3D) and has been used by the staff in the Physical Disabilities Branch at the NIH for more than 20 years.

2) [[visual3d:documentation:modeling:segments:coda_pelvis|CODA Pelvis]] - The CODA pelvis defines the location of the Hip Joint Centers using regression equations from the Bell and Brand articles.

3) [[visual3d:documentation:modeling:segments:helen_hayes_davis_pelvis|Helen Hayes (Davis) Pelvis]] - The Helen Hayes (Davis) pelvis defines the location of the Hip Joint Centers using regression equations from the Davis article.

In this tutorial we are presenting the CODA pelvis:

1. On the segments tab:

1. From the Segment Name box, select Pelvis.
2. From the Segment Type box, select Coda.
3. Click Create.

{{:SegmentName_CodaPelvis.jpg}}


2. In the Coda Segment Markers dialog box, enter these values:

1. Define Calibration targets:
(Right/Left Anterior and Posterior Iliac Crest Markers)
R.ASIS RIAS
L.ASIS LIAS
R.PSIS RIPS
L.PSIS LIPS
2. Check Use Calibration Targets for Tracking
3. Close Coda Segment Markers dialog box

{{:CodaSegmentMarkers.jpg}}


3. Click Build Model to build the segment. You should now see a pelvis segment on your standing model. If you do not see the pelvis segment after clicking Build Model, double check the values you entered in the last step.

{{:CompletedCodaPelvis.jpg}}

View the Pelvis Segment Coordinate System

It is often helpful to isolate the segment's coordinate system in order to validate that it is setup correctly. This view can also help you visualize where the center of gravity for a segment is located. Follow the procedure below to isolate the segment's coordinate system by toggling off the other views. When you are done you will be left with the Coordinate System of the Pelvis as represented by a Red Line (x-axis), Green Line (y-axis) and a Blue Line (z-axis).

Note: Each of the view buttons is a toggle button and will either toggle on or off a particular view.

  1. Click the Views Segment toggle button {{:ShowBonesButton.jpg}} on the toolbar until the pelvis bone disappears (the same effect can be achieved by pressing F5 on your keyboard).
  2. Click the Views Segment Geometry toggle button {{:GeometryToggle.jpg}} on the toolbar until you toggle off geometric view the pelvis (the same effect can be achieved by pressing F7 on your keyboard).
    Note: If you have followed this tutorial exactly this view may already be off.
  3. Click the Views Segment Lines toggle button {{:SegmentToggle.jpg}} on the toolbar until you toggle off the yellow lines which connect the segment end points.


{{:CompletedCodaPelvis_nobones.jpg}}

Segment Properties

At this point, the Segment Properties for the Pelvis can be modified if you would like. More information about Segment Properties, can be found here.

A little fun with the Graphics

You may skip to this section if you wish. It is possible to replace the ”bones” with another bone or object file. As a ridiculous example, you can change the pelvis model to display a skull rather than the pelvis bones. This example can be found here.

Save the data

Save often to prevent loss of files due to power outages or Windows errors.

Save the Workspace to a .cmz file

Maintain a series of .cmz files as you work so that you can revert to a previous step.

  1. From the File menu, click on Save As.
  2. In the Save As dialog box label your file MyTutorial1.cmz, navigate to the location of your choice and click Save.

Save the Model Template

Save the segment definitions as a model template (mdh) file to allow you to re-create models using the same marker set.
From the Model menu select Save Model Template.
In the Save As dialog box label your file Tutorial_ModelTemplate.mdh, navigate to the location of your choice and click Save.

Apply the Model Template

Now that the model template exists, you can use this template on other data sets.
From the Model menu select Apply Model Template
In the dialog box select the appropriate .mdh file.

Define the Remaining Segments

Create the Right Thigh Segment

1. Create Thigh Segment:

  1. From the Segments tab, select Right Thigh in the Segment Name drop down list box
  2. Click Create. A new tab labeled Right Thigh will open.
  3. In the Right Thigh tab, enter these values:

    4.    Define Proximal Joint and Radius
       Lateral: None     Joint: RIGHT_HIP     Medial: None     
       Radius: 0.5*DISTANCE(RIGHT_HIP,LEFT_HIP)

       Define Distal Joint and Radius
       Lateral: RFLE     Joint: None     Medial: RFME     

       Select Tracking Targets:
          RTH1, RTH2, RTH3, RTH4

  4. Click Build Model. A 3D image of a thigh will appear.
    Note: If you receive an error message about inertial properties and custom segments, you may have entered an incorrect number for the proximal radius.
  5. Click Close Tab before proceeding.
    Note: Closing the tab will not affect the model in any way.

{{:CompletedRightThigh.jpg}}

Create the Right Shank Segment

1. Create Virtual Knee Joint Center:

  1. Click Landmarks button
  2. Click Add New Landmark button
  3. Create Landmark: RIGHT_KNEE

       Landmark Name: RIGHT_KNEE

       Define Orientation Using:
       Starting Point: RFLE
       Ending Point: RFME
  4. Offset Using the Following AXIAL Offset: 0.5
  5. Check: Offset by Percent (1.0 = 100%)
  6. Check: Calibration Only Landmark

{{:VirtualRightKneeCenter.jpg}}

2. Create Shank Segment:

  1. In the Segments tab, select Right Shank in the Segment Name box.
  2. Click on the Create Segment button.
  3. In the Right Shank tab, enter these values:

       Define Proximal Joint and Radius
       Lateral: None     Joint: RIGHT_KNEE     Medial: None     
       Radius: RTH_DISTAL_RADIUS

       Define Distal Joint and Radius
       Lateral: RFAL     Joint: None     Medial: RTAM     

       Select Tracking Targets:
         RSHK1, RSHK2, RSHK3, RSHK4
  4. Click on Build Model. A 3D image of a shank will appear distal to the thigh.
  5. Click on Close Tab before proceeding.

{{:YTT_RightShank.jpg}}


Create Right Foot Segment

1. Create Virtual Knee Ankle Center:

  1. Click Landmarks button
  2. Click Add New Landmark button
  3. Create Landmark: RIGHT_ANKLE

       Landmark Name: RIGHT_ANKLE

       Define Orientation Using:
       Starting Point: RFAL
       Ending Point: RTAM
  4. Offset Using the Following AXIAL Offset: 0.5
  5. Check: Offset by Percent (1.0 = 100%)
  6. Check: Calibration Only Landmark

{{:VirtualRightAnkleCenter.jpg}}

2. Create Virtual Toe Ankle Center:

  1. Click Landmarks button
  2. Click Add New Landmark button
  3. Create Landmark: RTOE_FT

       Landmark Name: RTOE_FT

       Define Orientation Using:
       Starting Point: RFCC
       Ending Point: R5MH
       Lateral Object: R1MH
       Project From: RTOE
  4. Do NOT Check: Offset by Percent (1.0 = 100%)
  5. Check: Calibration Only Landmark

{{:VirtualRightToeCenter.jpg}}

3. Create Foot Segment:

  1. In the Segments tab, select Right Foot in the Segment Name box.
  2. Click on the Create Segment button.
  3. In the Right Foot tab, enter these values:

       Define Proximal Joint and Radius
       Lateral: None     Joint: RIGHT_ANKLE     Medial: None     
       Radius: RSK_DISTAL_RADIUS

       Define Distal Joint and Radius
       Lateral: None     Joint: RTOE_FT     Medial: None     
       Radius: 0.5*DISTANCE(R1MH,R5MH)

       Extra Target to Define Orientation
       Location: Lateral     R5MH

       Select Tracking Targets:
         R1MH, R5MH, RFCC, RTOE
  4. Click on Build Model. A 3D image of a foot will appear distal to the shank.
  5. Click on Close Tab before proceeding.

{{:YTT_RightFoot.jpg}}

Create the Left Thigh Segment

1. Create Thigh Segment:

  1. In the Segments tab, select Left Thigh in the Segment Name box.
  2. Click on the Create Segment button.
  3. To Automatically Populate Left Thigh Information:

    Click Guess Properties button

    NOTE:The segment information should auto populate. Make sure to check all values.
    The segment definitions are based off the information entered for the right thigh.
  4. OR Manually Enter Left Thigh Information:

    In the Left Thigh tab, enter these values:

       Define Proximal Joint and Radius
       Lateral: None     Joint: LEFT_HIP     Medial: None     
       Radius: 0.5*DISTANCE(RIGHT_HIP,LEFT_HIP)

       Define Distal Joint and Radius
       Lateral: LFLE     Joint: None     Medial: LFME     

       Select Tracking Targets:
         LTH1, LTH2, LTH3, LTH4

  5. Click on Build Model. A 3D image of a thigh will appear.
  6. Click on Close Tab before proceeding.

{{:CompletedLeftThigh.jpg}}

Create Landmarks for Left Segments

1. Create Virtual Knee Joint Center:

  1. Click Landmarks button
  2. Click Add New Landmark button
  3. Create Landmark: LEFT_KNEE

       Landmark Name: LEFT_KNEE

       Define Orientation Using:
       Starting Point: LFLE
       Ending Point: LFME
  4. Offset Using the Following AXIAL Offset: 0.5
  5. Check: Offset by Percent (1.0 = 100%)
  6. Check: Calibration Only Landmark

{{:VirtualLeftKneeCenter.jpg}}

2. Create Virtual Knee Ankle Center:

  1. Click Landmarks button
  2. Click Add New Landmark button
  3. Create Landmark: LEFT_ANKLE

       Landmark Name: LEFT_ANKLE

       Define Orientation Using:
       Starting Point: LFAL
       Ending Point: LTAM
  4. Offset Using the Following AXIAL Offset: 0.5
  5. Check: Offset by Percent (1.0 = 100%)
  6. Check: Calibration Only Landmark

{{:VirtualLefttAnkleCenter.jpg}}

3. Create Virtual Toe Ankle Center:

  1. Click Landmarks button
  2. Click Add New Landmark button
  3. Create Landmark: LTOE_FT

       Landmark Name: LTOE_FT

       Define Orientation Using:
       Starting Point: LFCC
       Ending Point: L5MH
       Lateral Object: L1MH
       Project From: LTOE
  4. Do NOT Check: Offset by Percent (1.0 = 100%)
  5. Check: Calibration Only Landmark

{{:VirtualLeftToeCenter.jpg}}

Create the Left Shank Segment

1. Create Shank Segment:

  1. In the Segments tab, select Left Shank in the Segment Name box.
  2. Click on the Create Segment button.
  3. To Automatically Populate Left Shank Information:

    Click Guess Properties button

    NOTE:The segment information should auto populate. Make sure to check all values. The segment definitions are based off the information entered for the right thigh.
  4. OR Manually Enter Left Shank Information:

    In the Left Shank tab, enter these values:

       Define Proximal Joint and Radius
       Lateral: None     Joint: LEFT_KNEE     Medial: None     
       Radius: LTH_DISTAL_RADIUS

       Define Distal Joint and Radius
       Lateral: LFAL     Joint: None     Medial: LTAM     

       Select Tracking Targets:
         LSHK1, LSHK2, LSHK3, LSHK4
  5. Click on Build Model. A 3D image of a shank will appear distal to the thigh.
  6. Click on Close Tab before proceeding.

{{:CompletedLeftShank.jpg}}

Create the Left Foot Segment

1. Create Foot Segment:

  1. In the Segments tab, select Left Foot in the Segment Name box.
  2. Click on the Create Segment button.
  3. To Automatically Populate Left Shank Information:

    Click Guess Properties button

    NOTE:The segment information should auto populate. Make sure to check all values. The segment definitions are based off the information entered for the right thigh.
  4. OR Manually Enter Left Shank Information:

    In the Left Foot tab, enter these values:

       Define Proximal Joint and Radius
       Lateral: None     Joint: LEFT_ANKLE     Medial: None     
       Radius: LSK_DISTAL_RADIUS

       Define Distal Joint and Radius
       Lateral: None     Joint: LTOE_FT     Medial: None     
       Radius: 0.5*DISTANCE(L1MH,L5MH)

       Extra Target to Define Orientation
       Location: Lateral     L5MH

       Select Tracking Targets:
         L1MH, L5MH, LTOE, LFCC

  5. Click on Build Model. A 3D image of a foot will appear distal to the shank.
  6. Click on Close Tab before proceeding.

{{:CompletedLeftFoot.jpg}}

Create Kinematic Only Foot Segments

Kinematic Only feet are often created for more clinically relevant ankle joint angles.

For more information about kinematic only foot segments, please go [[visual3d:documentation:kinematics_and_kinetics:normalized_joint_angle_-_method_2|here]].

Completing the Model

  1. When all segments have been defined, click on Build Model.
  2. In the File menu, click on Save to save the file for use in another tutorial.
  3. Save the template as Tutorial_ModelTemplate.mdh.

Verify the model template

  1. Clear the Visual3D Workspace - Select File New
  2. Repeat the initial steps in this tutorial.
    1. Open the movement trial
    2. Create a hybrid model using the standing trial
    3. Assign the movement trial to the model
    4. Apply the model template. You will find this option under the Model Menu Item.

Proceed to next [[visual3d:tutorials:reports:visualizing_data|Tutorial: Visualizing Data]]