HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » definitions » Static Trial
visual3d:documentation:definitions:static_trial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:definitions:static_trial [2024/06/19 12:47] – sgrangervisual3d:documentation:definitions:static_trial [2024/11/15 15:48] (current) – wikisysop
Line 1: Line 1:
-{{{{{{{{{{{{{{{{{{{{{{{{the relationship between a static trial, movement trial and link model+===== Static Trial =====
  
-visual3d identifies models, static trials and motion trials in much the same way—using the name of the corresponding c3d data file—but it’s very important to understand the distinctions between these types of files.+This page covers the relationship between a static trial, a dynamic movement trial, and the link model. Visual3D names models, static trials, and motion trials in much the same way—using the name of the corresponding C3D data file—but it’s very important to understand the distinctions between these types of files.
  
-===== motion trial =====+==== Static Trial ====
  
-a recording of your subject moving through a prescribed sequence is called a motion trial.+A recording made with the participant stationary. This information is used when defining the link model. Within this documentation or in talking with support at HAS-Motion you will probably note that we use the terms standing trial, calibration trial, and static trial interchangeably. The most important feature, regardless of the use of the term, is that we are referring to the trial used to define the link model.
  
-===== static trial =====+Only marker-based motion capture requires a static trial. Markerless motion capture systems output [[visual3d:documentation:c3d_signal_types:rotation_data_type|rotation matrices]] that represent the participant's [[visual3d:documentation:kinematics_and_kinetics:pose_estimation|pose]].
  
-a recording made with the subject stationary.+=== Average Location of Markers ===
  
-within this documentation or in talking with support at c-motion you will probably note that we use the terms standing trial, calibration trial, and static trial interchangeably. the most important feature, regardless of the use of the term, is that we are referring to the trial used to define the link model.+When the model is created, the average location for each marker in the static trial is determined using all frames of data. Because of this, the participant should be standing as motionless as possible, i.e., statically, since this will reduce any noisy artifacts in the average locations. If necessary, you can use a file which does exhibit motion, even an actual motion trial data file, and identify a short sub-range of capture frames which Visual3D should interpret as a static trial. This can be done using the command **Modify Frame Range For Static Calibration**, located in the Model Menu items.
  
-==== average location of markers ====+== Maximum Standard Deviation Warning ==
  
-when the model is created, the average location of all markers are determined using all frames of data.+When constructing a model from the static trial, a **The Maximum Standard Deviation of the marker locations** warning may appear. The warning indicates that there was movement in the markers and you should do something about it. There should be no movement in the static trial. 
 +  - Sometimes the movement is real (e.g. the subject isn't stationary). In this case you should select the option to use fewer frames of data for the static pose. 
 +  - Sometimes the movement is artifact related to poor marker identification. This should be attended to and care should be taken to select an appropriate subset of frames. 
 +  - Sometimes the movement is related to ghost markers in the motion capture system, and since these ghost markers aren't used for defining the model, they can be ignored.
  
-normally, the marker trajectories recorded in a static trial will exhibit almost no motion, because the subject is standing still, but this need not be the case. if necessary, you can use a file which does exhibit motion (even an actual motion trial data file), and identify a short sub-range of capture frames which visual3d should interpret as a static trial.+We highly recommend you determine the source of the movement and determine what is an appropriate choice of frames. Do not ignore the warning.
  
-=== maximum standard deviation warning ===+**NOTE:** If the subject moved during the standing trial, a subset of frames, in which the subject is stationary, can be selected for computing the average locations of the markers. The command **Modify Frame Range For Static Calibration** is located in the Model Menu items.
  
-when constructing a model from the static trial, a **the maximum standard deviation of the marker locations** may appear. the warning indicates that there was movement in the markers and you should do something about it. there should be no movement in the static trial.+=== Static Trial When Subject is Moving ===
  
-  * sometimes the movement is real (e.g. the subject isn't stationary). in this case you should select the option to use fewer frames of data for the static pose.+There are many situations in which it is convenient to use only part of a trial for building a model. Examples include subjects that can not stand still (e.g. babies), subjects that moved inadvertently during the static trial, or no static trial was collected (e.g. a movement trial is used instead).
  
-  * sometimes the movement is artifact related to poor marker identification. this should be attended to and care should be taken to select an appropriate subset of frames.+The solution to this problem is to specify the range of frames that are used for the model. Under the model menu item you will find an option **Modify Frame Range for Static Calibration**\\
  
-  * sometimes the movement is related to ghost markers in the motion capture system, and since these ghost markers aren't used for defining the model, they can be ignored.+{{:SelectRangeOfFrames1.png}}
  
-we highly recommend you determine the source of the movement and determine what is an appropriate choice of frames. do not ignore the warning.+Select the range of frames the best reflect a standing trial. If this is a movement trial, you may only want to select one frame of data.\\
  
-**note:** if the subject moved during the standing trial, a subset of frames, in which the subject is stationary, can be selected for computing the average locations of the markers. the command **modify frame range for static calibration** is located in the model menu items.+{{:SelectRangeOfFrames2.png}}
  
-==== link model ====+=== Multiple Static Trials ===
  
-the link model is a collection of segments, landmarks, and muscles. the connection between the model and the movement trials is the homologous markers contained in the static c3d file. in order for visual3d's algorithms to function properly all [[visual3d:documentation:kinematics_and_kinetics:six_degrees_of_freedom#6_dof_tracking|tracking markers]] must exist in both the static trial and the movement trial with the same names and with the same location on the subject.+Visual3D's core structures were developed assuming that there was only one static trial per model. There are many circumstances in which multiple static trials are required. Visual3D does not handle this situation very well, but it is possible, and may be instructive anyways ;-)
  
-it is imperative that the tracking markers be in exactly the same location in the static trial and the movement trial. if a marker is removed (or falls off), it is highly recommended that another static trial be collected.+For example, the cameras may be placed in such a way that all tracking markers are in view, but one or more markers used to define a segment is obscured. One static trial has 3 markers that can be used to define a [[Visual3D:Documentation:Modeling:Segments:Coda_Pelvis|CODA pelvis]], which automatically creates landmarks defining the location of the left and right hip relative to the pelvis segment.
  
-=== link model name ===+{{:multiple_static1.jpg}}
  
-visual3d uses the standing-trial c3d file’s name as a label to identify the model, which can be misleading. the model and the c3d file are not the same.+The other static trial does not have the sacrum marker, so it isn't possible to compute the location of the hip joint center relative to a pelvis segment.
  
-==== static trial when subject is moving ====+{{:multiple_static2.jpg}}\\
  
-there are many situations in which it is convenient to use only part of a trial for building a model. examples include subjects that can not stand still (e.g. babies), subjects that moved inadvertently during the static trial, or no static trial was collected (e.g. a movement trial is used instead).+The following steps will create a landmark for the hip joint center relative to 3 of the thigh markers from one static trial, so that is can be used in the other static trial.
  
-the solution to this problem is to specify the range of frames that are used for the model. under the model menu item you will find an option **modify frame range for static calibration**\\+  - Create a hybrid model from the first static trial and create a Coda Pelvis segment
  
 +{{:multiple_static3.jpg}}
  
-selectrangeofframes1.png\\+  - Select the appropriate markers
  
 +{{:multiple_static4.jpg}}
  
-select the range of frames the best reflect a standing trial. if this is a movement trial, you may only want to select one frame of data.\\+{{:multiple_static9.jpg}}
  
 +  - Hip joint landmarks will be created automatically according to the regression equations in **Bell AL, Pederson DR, and Brand RA** (1989) Prediction of hip joint center location from external landmarks. Human Movement Science. 8:3-16:
  
-selectrangeofframes2.png+{{:multiple_static5.jpg}}
  
-==== multiple static trials ====+  - These landmarks are created relative to the pelvis segment, which won't be of any use in the other static trial, so we create a new landmark for the right hip relative to three of the thigh markers.
  
-visual3d's core structures were developed assuming that there was only one static trial per model. there are many circumstances in which multiple static trials are required. visual3d does not handle this situation very well, but it is possible, and may be instructive anyways ;-)+{{:multiple_static6.jpg}}
  
-for example, the cameras may be placed in such a way that all tracking markers are in view, but one or more markers used to define a segment is obscured.+  - Select the Apply button to update the offsets. **Note**: the edit boxes will be grayed out because they are linked with the RIGHT_HIP landmark
  
-one static trial has 3 markers that can be used to define a [[visual3d:documentation:modeling:segments:coda_pelvis|coda pelvis]], which automatically creates landmarks defining the location of the left and right hip relative to the pelvis segment.\\+{{:multiple_static7.jpg}}
  
 +  - Now select the button to use the offsets, which will remove the dependence on the RIGHT_HIP landmark
  
-multiple_static1.jpg\\+{{:multiple_static8.jpg}}
  
 +  - This RT_HIP landmark is now independent of the Pelvis segment. Save the model template, create a model for the second static trial, and apply this model template. An error message will appear because it isn't possible to build the pelvis segment, but the RT_HIP landmark will be created.
  
-the other static trial does not have the sacrum marker, so it isn't possible to compute the location of the hip joint center relative to a pelvis segment.\\+{{:multiple_static10.jpg}}
  
 +Now you can remove the Pelvis segment and its associated landmarks RIGHT_HIP and LEFT_HIP.
  
-multiple_static2.jpg\\+== Multiple Static Trials using a Pipeline ==
  
- +This process can also be accomplished using a pipeline, which is actually a little cleaner because it can be incorporated into an existing pipeline. **Note:** the **HYBRID_SEGMENT** command isn't available in the pipeline workshop interface but the syntax is available in the [[Visual3D:Documentation:Modeling:Model_Templates|Model Templates]].
-the following steps will create a landmark for the hip joint center relative to 3 of the thigh markers from one static trial, so that is can be used in the other static trial. +
- +
-create a hybrid model from the first static trial and create a coda pelvis segment\\ +
- +
- +
-multiple_static3.jpg\\ +
- +
- +
-select the appropriate markers\\ +
- +
- +
-multiple_static4.jpg\\ +
- +
- +
-multiple_static9.jpg\\ +
- +
- +
-hip joint landmarks will be created automatically according to the regression equations +
- +
-**bell al, pederson dr, and brand ra** (1989) prediction of hip joint center location from external landmarks. human movement science. 8:3-16:\\ +
- +
- +
-multiple_static5.jpg\\ +
- +
- +
-these landmarks are created relative to the pelvis segment, which won't be of any use in the other static trial, so we create a new landmark for the right hip relative to three of the thigh markers.\\ +
- +
- +
-multiple_static6.jpg\\ +
- +
- +
-select the apply button to update the offsets +
- +
-note that the edit boxes will be grayed out because they are linked with the right_hip landmark\\ +
- +
- +
-multiple_static7.jpg\\ +
- +
- +
-now select the button to use the offsets, which will remove the dependence on the right_hip landmark\\ +
- +
- +
-multiple_static8.jpg\\ +
- +
- +
-this rt_hip landmark is now independent of the pelvis segment. +
- +
-save the model template, create a model for the second static trial, and apply this model template. an error message will appear because it isn't possible to build the pelvis segment, but the rt_hip landmark will be created.\\ +
- +
- +
-multiple_static10.jpg\\ +
- +
- +
-now you can remove the pelvis segment and its associated landmarks right_hip and left_hip.\\ +
- +
- +
-=== multiple static trials using a pipeline === +
- +
-this process can also be accomplished using a pipeline, which is actually a little cleaner because it can be incorporated into an existing pipeline. **note:** the **hybrid_segment** command isn't available in the pipeline workshop interface but the syntax is available in the [[visual3d:documentation:modeling:model_templates|model templates]].+
  
 <code> <code>
-! clear workspace +! Clear workspace 
-file_new+File_New
 ; ;
  
-! for convenvience, prompt the user for the folder containing the data +! For convenvience, prompt the user for the Folder containing the data 
-set_pipeline_parameter_to_folder_path +Set_Pipeline_Parameter_To_Folder_Path 
-/parameter_name=folder +/PARAMETER_NAME=FOLDER 
-/parameter_value= +/PARAMETER_VALUE= 
-! /parameter_value_search_for= +! /PARAMETER_VALUE_SEARCH_FOR= 
-! /parameter_value_replace_with= +! /PARAMETER_VALUE_REPLACE_WITH= 
-! /parameter_value_append=+! /PARAMETER_VALUE_APPEND=
 ; ;
  
-! create a pipeline parameter for each of the static trials+! Create a pipeline parameter for each of the static trials
  
-! pipeline parameter for static 1 +! Pipeline Parameter for Static 1 
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=static1 +/PARAMETER_NAME=STATIC1 
-/parameter_value=::folder&static1.c3d +/PARAMETER_VALUE=::FOLDER&static1.c3d 
-! /parameter_value_search_for= +! /PARAMETER_VALUE_SEARCH_FOR= 
-! /parameter_value_replace_with= +! /PARAMETER_VALUE_REPLACE_WITH= 
-! /parameter_value_prefix= +! /PARAMETER_VALUE_PREFIX= 
-! /parameter_value_append=+! /PARAMETER_VALUE_APPEND=
 ; ;
  
-! pipeline parameter for static 2 +! Pipeline Parameter for Static 2 
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=static2 +/PARAMETER_NAME=STATIC2 
-/parameter_value=::folder&static2.c3d +/PARAMETER_VALUE=::FOLDER&static2.c3d 
-! /parameter_value_search_for= +! /PARAMETER_VALUE_SEARCH_FOR= 
-! /parameter_value_replace_with= +! /PARAMETER_VALUE_REPLACE_WITH= 
-! /parameter_value_prefix= +! /PARAMETER_VALUE_PREFIX= 
-! /parameter_value_append=+! /PARAMETER_VALUE_APPEND=
 ; ;
  
-! prompt the user for the height and weight of the subject +! Prompt the user for the height and weight of the subject 
-prompt_for_multiple_pipeline_parameter_values +Prompt_For_Multiple_Pipeline_Parameter_Values 
-/global_parameter_name=weight+height +/GLOBAL_PARAMETER_NAME=WEIGHT+HEIGHT 
-/datatype=float+float +/DATATYPE=float+float 
-/default_value=1+1+/DEFAULT_VALUE=1+1
 ; ;
  
-! create the model from the first static trial and assign the height and weight +! Create the model from the first static trial and assign the height and weight 
-create_hybrid_model +Create_Hybrid_Model 
-/calibration_file=::static1 +/CALIBRATION_FILE=::STATIC1 
-! /range=all_frames+! /RANGE=ALL_FRAMES
 ; ;
  
-set_subject_weight +Set_Subject_Weight 
-! /calibration_file= +! /CALIBRATION_FILE= 
-/weight=::weight+/WEIGHT=::WEIGHT
 ; ;
  
-set_subject_height +Set_Subject_Height 
-! /calibration_file= +! /CALIBRATION_FILE= 
-/height=::height+/HEIGHT=::HEIGHT
 ; ;
  
-! create a coda pelvis segment +! Create a Coda Pelvis Segment 
-! note that this command isn't available in the pipeline interface +! Note that this command isn't available in the pipeline interface 
-! the syntax is available in the model template +! The syntax is available in the model template 
-hybrid_segment +HYBRID_SEGMENT 
-! /calibration_file= +! /CALIBRATION_FILE= 
-/type=coda +/TYPE=Coda 
-/name=rpv +/NAME=RPV 
-/reference_object=r.asis+l.asis+r.psis+l.psis +/REFERENCE_OBJECT=R.ASIS+L.ASIS+R.PSIS+L.PSIS 
-/reference_object_names=r.asis+l.asis+sacrum+sacrum +/REFERENCE_OBJECT_NAMES=R.ASIS+L.ASIS+SACRUM+SACRUM 
-/reference_object_types=target+target+target+target +/REFERENCE_OBJECT_TYPES=TARGET+TARGET+TARGET+TARGET 
-! /use_cal_targets_for_tracking=true +! /USE_CAL_TARGETS_FOR_TRACKING=TRUE 
-/tracking_types=target+target+target+target +/TRACKING_TYPES=TARGET+TARGET+TARGET+TARGET 
-/tracking_names=r.asis+l.asis+sacrum+sacrum +/TRACKING_NAMES=R.ASIS+L.ASIS+SACRUM+SACRUM 
-! /use_optimal_tracking=true +! /USE_OPTIMAL_TRACKING=TRUE 
-! /kinematic_only=false +! /KINEMATIC_ONLY=FALSE 
-! /static_model=false +! /STATIC_MODEL=FALSE 
-/graphics_rot_x=0 +/GRAPHICS_ROT_X=0 
-/graphics_rot_y=0 +/GRAPHICS_ROT_Y=0 
-/graphics_rot_z=0 +/GRAPHICS_ROT_Z=0 
-/graphics_scale_x=1 +/GRAPHICS_SCALE_X=1 
-/graphics_scale_y=1 +/GRAPHICS_SCALE_Y=1 
-/graphics_scale_z=1 +/GRAPHICS_SCALE_Z=1 
-/graphics_translate_x=0 +/GRAPHICS_TRANSLATE_X=0 
-/graphics_translate_y=0 +/GRAPHICS_TRANSLATE_Y=0 
-/graphics_translate_z=0 +/GRAPHICS_TRANSLATE_Z=0 
-! /graphics_unit_scale=1.000000 +! /GRAPHICS_UNIT_SCALE=1.000000 
-! /mass= +! /MASS= 
-! /geometry= +! /GEOMETRY= 
-! /prox_to_cg_axial= +! /PROX_TO_CG_AXIAL= 
-! /prox_to_cg_ml= +! /PROX_TO_CG_ML= 
-! /prox_to_cg_ap= +! /PROX_TO_CG_AP= 
-! /ixx= +! /IXX= 
-! /iyy= +! /IYY= 
-! /izz= +! /IZZ= 
-! /ap_direction= +! /AP_DIRECTION= 
-! /axial_direction= +! /AXIAL_DIRECTION= 
-/objfile=pelviswrtasis.v3g +/OBJFILE=PelvisWrtAsis.v3g 
-! /colfile= +! /COLFILE= 
-/depth=0.100538+/DEPTH=0.100538
 ; ;
  
-! it is necessary to build the model, so that the right_hip and left_hip landmarks will be created +! It is necessary to build the model, so that the RIGHT_HIP and LEFT_HIP landmarks will be created 
-build_model +Build_Model 
-! /calibration_file= +! /CALIBRATION_FILE= 
-! /rebuild_all_models=false+! /REBUILD_ALL_MODELS=FALSE
 ; ;
  
-! create the rt_hip landmark relative to the thigh markers +! Create the RT_HIP landmark relative to the thigh markers 
-add_landmark +Add_Landmark 
-/landmark_name=rt_hip +/LANDMARK_NAME=RT_HIP 
-! /calibration_file= +! /CALIBRATION_FILE= 
-! /user_generated=true +! /USER_GENERATED=TRUE 
-! /use_percentage=false +! /USE_PERCENTAGE=FALSE 
-! /calibration_only=false +! /CALIBRATION_ONLY=FALSE 
-/use_targets=true +/USE_TARGETS=TRUE 
-! /segment_name= +! /SEGMENT_NAME= 
-/target_types=target+target+target +/TARGET_TYPES=TARGET+TARGET+TARGET 
-/target_names=rth1+rth4+rth2 +/TARGET_NAMES=RTH1+RTH4+RTH2 
-/mcsx=-0.0828394 +/MCSX=-0.0828394 
-/mcsy=-0.135784 +/MCSY=-0.135784 
-/mcsz=-0.235367 +/MCSZ=-0.235367 
-! /landmark_location= +! /LANDMARK_LOCATION= 
-/reference_location_name=right_hip +/REFERENCE_LOCATION_NAME=RIGHT_HIP 
-/reference_location_type=landmark +/REFERENCE_LOCATION_TYPE=LANDMARK 
-/use_reference_location=true+/USE_REFERENCE_LOCATION=TRUE
 ; ;
  
-! build the model +! Build the model 
-build_model +Build_Model 
-! /calibration_file= +! /CALIBRATION_FILE= 
-! /rebuild_all_models=false+! /REBUILD_ALL_MODELS=FALSE
 ; ;
  
-! create the second model using second static trial and assign the weight and height +! Create the second model using second static trial and assign the weight and height 
-create_hybrid_model +Create_Hybrid_Model 
-/calibration_file=::static2 +/CALIBRATION_FILE=::STATIC2 
-! /range=all_frames+! /RANGE=ALL_FRAMES
 ; ;
  
-set_subject_weight +Set_Subject_Weight 
-! /calibration_file= +! /CALIBRATION_FILE= 
-/weight=::weight+/WEIGHT=::WEIGHT
 ; ;
  
-set_subject_height +Set_Subject_Height 
-! /calibration_file= +! /CALIBRATION_FILE= 
-/height=::height+/HEIGHT=::HEIGHT
 ; ;
  
-! add the rt_hip landmark +! Add the RT_HIP landmark 
-! note the use of the previous parameters for mcsx, mcsy, and mcsz +! Note the use of the previous parameters for MCSX, MCSY, and MCSZ 
-! these are available because the pipeline remembers their values from the last time they were used +! These are available because the pipeline remembers their values from the last time they were used 
-add_landmark +Add_Landmark 
-/landmark_name=rt_hip +/LANDMARK_NAME=RT_HIP 
-! /calibration_file= +! /CALIBRATION_FILE= 
-! /user_generated=true +! /USER_GENERATED=TRUE 
-! /use_percentage=false +! /USE_PERCENTAGE=FALSE 
-! /calibration_only=false +! /CALIBRATION_ONLY=FALSE 
-/use_targets=true +/USE_TARGETS=TRUE 
-! /segment_name= +! /SEGMENT_NAME= 
-/target_types=target+target+target +/TARGET_TYPES=TARGET+TARGET+TARGET 
-/target_names=rth1+rth4+rth2 +/TARGET_NAMES=RTH1+RTH4+RTH2 
-/mcsx=::mcsx +/MCSX=::MCSX 
-/mcsy=::mcsy +/MCSY=::MCSY 
-/mcsz=::mcsz +/MCSZ=::MCSZ 
-! /landmark_location= +! /LANDMARK_LOCATION= 
-/reference_location_name= +/REFERENCE_LOCATION_NAME= 
-/reference_location_type= +/REFERENCE_LOCATION_TYPE= 
-/use_reference_location=false+/USE_REFERENCE_LOCATION=FALSE
 ; ;
  
-! build model +! Build Model 
-build_model +Build_Model 
-! /calibration_file= +! /CALIBRATION_FILE= 
-! /rebuild_all_models=false+! /REBUILD_ALL_MODELS=FALSE
 ; ;
 </code> </code>
  
 +==== Dynamic Motion Trial ====
 +
 +A recording of your participant moving through a prescribed sequence is called a motion trial. This file contains the movement of interest to be analysed.
 +
 +Both marker-based and markerless motion capture systems record dynamic motion trials.
 +
 +==== Link Model ====
 +
 +The [[visual3d:documentation:visual3d_signal_types:link_model_based_data_type|link model]] is a collection of segments, landmarks, and muscles. The connection between the model and the movement trials is the homologous markers contained in the static C3D file. In order for Visual3D's algorithms to function properly all [[Visual3D:Documentation:Kinematics_and_Kinetics:Six_Degrees_of_Freedom#6_DOF_Tracking|tracking markers]] must exist in both the static trial and the movement trial with the same names and with the same location on the subject.
 +
 +It is imperative that the tracking markers be in exactly the same location in the static trial and the movement trial. If a marker is removed (or falls off), it is highly recommended that another static trial be collected.
 +
 +**NOTE**: Visual3D uses the standing-trial C3D file’s name as a label to identify the model, which can be misleading. The model and the C3D file are not the same.
  
-}}}}}}}}}}}}}}}}}}}}}}}} 
visual3d/documentation/definitions/static_trial.1718801243.txt.gz · Last modified: 2024/06/19 12:47 by sgranger