HAS-Motion Software Documentation

This is an old revision of the document!

---

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. === link model name === 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. ==== static trial when subject is moving ==== 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 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**\\ selectrangeofframes1.png\\ 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.\\ selectrangeofframes2.png ==== multiple static trials ==== 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 ;-) 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.\\ multiple_static1.jpg\\ 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_static2.jpg\\ 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> ! clear workspace file_new ; ! for convenvience, prompt the user for the folder containing the data set_pipeline_parameter_to_folder_path /parameter_name=folder /parameter_value= ! /parameter_value_search_for= ! /parameter_value_replace_with= ! /parameter_value_append= ; ! create a pipeline parameter for each of the static trials ! pipeline parameter for static 1 set_pipeline_parameter /parameter_name=static1 /parameter_value=::folder&static1.c3d ! /parameter_value_search_for= ! /parameter_value_replace_with= ! /parameter_value_prefix= ! /parameter_value_append= ; ! pipeline parameter for static 2 set_pipeline_parameter /parameter_name=static2 /parameter_value=::folder&static2.c3d ! /parameter_value_search_for= ! /parameter_value_replace_with= ! /parameter_value_prefix= ! /parameter_value_append= ; ! prompt the user for the height and weight of the subject prompt_for_multiple_pipeline_parameter_values /global_parameter_name=weight+height /datatype=float+float /default_value=1+1 ; ! create the model from the first static trial and assign the height and weight create_hybrid_model /calibration_file=::static1 ! /range=all_frames ; set_subject_weight ! /calibration_file= /weight=::weight ; set_subject_height ! /calibration_file= /height=::height ; ! create a coda pelvis segment ! note that this command isn't available in the pipeline interface ! the syntax is available in the model template hybrid_segment ! /calibration_file= /type=coda /name=rpv /reference_object=r.asis+l.asis+r.psis+l.psis /reference_object_names=r.asis+l.asis+sacrum+sacrum /reference_object_types=target+target+target+target ! /use_cal_targets_for_tracking=true /tracking_types=target+target+target+target /tracking_names=r.asis+l.asis+sacrum+sacrum ! /use_optimal_tracking=true ! /kinematic_only=false ! /static_model=false /graphics_rot_x=0 /graphics_rot_y=0 /graphics_rot_z=0 /graphics_scale_x=1 /graphics_scale_y=1 /graphics_scale_z=1 /graphics_translate_x=0 /graphics_translate_y=0 /graphics_translate_z=0 ! /graphics_unit_scale=1.000000 ! /mass= ! /geometry= ! /prox_to_cg_axial= ! /prox_to_cg_ml= ! /prox_to_cg_ap= ! /ixx= ! /iyy= ! /izz= ! /ap_direction= ! /axial_direction= /objfile=pelviswrtasis.v3g ! /colfile= /depth=0.100538 ; ! it is necessary to build the model, so that the right_hip and left_hip landmarks will be created build_model ! /calibration_file= ! /rebuild_all_models=false ; ! create the rt_hip landmark relative to the thigh markers add_landmark /landmark_name=rt_hip ! /calibration_file= ! /user_generated=true ! /use_percentage=false ! /calibration_only=false /use_targets=true ! /segment_name= /target_types=target+target+target /target_names=rth1+rth4+rth2 /mcsx=-0.0828394 /mcsy=-0.135784 /mcsz=-0.235367 ! /landmark_location= /reference_location_name=right_hip /reference_location_type=landmark /use_reference_location=true ; ! build the model build_model ! /calibration_file= ! /rebuild_all_models=false ; ! create the second model using second static trial and assign the weight and height create_hybrid_model /calibration_file=::static2 ! /range=all_frames ; set_subject_weight ! /calibration_file= /weight=::weight ; set_subject_height ! /calibration_file= /height=::height ; ! add the rt_hip landmark ! 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 add_landmark /landmark_name=rt_hip ! /calibration_file= ! /user_generated=true ! /use_percentage=false ! /calibration_only=false /use_targets=true ! /segment_name= /target_types=target+target+target /target_names=rth1+rth4+rth2 /mcsx=::mcsx /mcsy=::mcsy /mcsz=::mcsz ! /landmark_location= /reference_location_name= /reference_location_type= /use_reference_location=false ; ! build model build_model ! /calibration_file= ! /rebuild_all_models=false ; </code> }}}}}}}}}}}}}}}}}}}}}}