User Tools

Site Tools


visual3d:documentation:pipeline:model_commands:add_landmark

Add Model Landmark

Overview

The Add Landmark command is used to create a landmark while creating a model. This command is found in the Pipeline Workshop in the Model Building folder. Landmarks can be added to help define the model beyond just tracking markers. They help provide reference for building segments, locating joints, and help in future calculations.

Pipeline Command

The command, as seen in the pipeline workshop, is below.

Add_Landmark
/LANDMARK_NAME=
! /CALIBRATION_FILE=
! /USER_GENERATED=TRUE
! /USE_PERCENTAGE=FALSE
! /CALIBRATION_ONLY=FALSE
! /USE_TARGETS=FALSE
! /SEGMENT_NAME=
! /TARGET_TYPES=
! /TARGET_NAMES=
! /MCS_ML=0.0
! /MCS_AP=0.0
! /MCS_AXIAL=0.0
! /LANDMARK_LOCATION=
! /REFERENCE_LOCATION_TYPE=
! /REFERENCE_LOCATION_NAME=
! /USE_REFERENCE_LOCATION=FALSE
;

Command Parameters

The following table shows the command parameters and descriptions:

LANDMARK_NAMEThe name of the landmark to be created
CALIBRATION_FILEThe name of the hybrid model. Use the full pathname
USER_GENERATEDCreate the landmark as a user-generated landmark
USE_PERCENTAGEOffset by percent (1.0=100%) (Meters when FALSE)
CALIBRATION_ONLYOnly used in static trial (calibration) not generated for motion file(s)
USE_TARGETSUse target markers to define the landmark location.
SEGMENT_NAMEThe segment associated with the landmark
TARGET_TYPESThe types of targets used to define the landmark
TARGET_NAMESThe names of the targets used
MCS_MLMedial-Lateral offset in the segment coordinate system
MCS_APAnterior-Posterior offset in the segment coordinate system
MCS_AXIALAxial offset in the segment coordinate system
LANDMARK_LOCATIONLocation of the landmark relative to the selected reference
REFERENCE_LOCATION_TYPEThe type of reference used to define the landmark location
REFERENCE_LOCATION_NAMEThe name of the reference landmark, marker, or point
USE_REFERENCE_LOCATIONUse a reference location when calculating the landmark position

Dialog

The command can be edited in a text editor or in a dialog form. To edit in the dialog pop up form either click on the Edit button in the pipeline workshop or double-click on the pipeline command. The dialog is shown below.

Examples

Adding Right Knee Landmark

The following examples shows the command used for defining a right knee landmark. Note the RFLE and RFME are the Medial and Lateral epicondyle's allowing this landmark to be at the center of the knee.

Add_Landmark
/LANDMARK_NAME=RIGHT_KNEE
/CALIBRATION_FILE=C:\Users\22qhsw\source\repos\Regression_Tests_2024_02_20_Updated\Pipeline_Favourites\Training Data\CMZStatic.c3d
! /USER_GENERATED=TRUE
/USE_PERCENTAGE=TRUE
/CALIBRATION_ONLY=TRUE
/USE_TARGETS=TRUE
! /SEGMENT_NAME=
/TARGET_TYPES=TARGET+TARGET
/TARGET_NAMES=RFLE+RFME
! /MCS_ML=0.0
! /MCS_AP=0.0
/MCS_AXIAL=0.5
! /LANDMARK_LOCATION=
! /REFERENCE_LOCATION_TYPE=
! /REFERENCE_LOCATION_NAME=
! /USE_REFERENCE_LOCATION=FALSE
;
visual3d/documentation/pipeline/model_commands/add_landmark.txt · Last modified: by wikisysop