Wiki Documentation Site

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » model_commands » Add Functional Joint Landmark
visual3d:documentation:pipeline:model_commands:add_functional_joint_landmark

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:pipeline:model_commands:add_functional_joint_landmark [2026/06/10 13:35] – [Dialog] wikisysopvisual3d:documentation:pipeline:model_commands:add_functional_joint_landmark [2026/09/17 19:08] (current) – [Pipeline Command] theo
Line 36: Line 36:
 ; ;
 </code> </code>
- 
 ==== Command Parameters ==== ==== Command Parameters ====
  
 |**/LANDMARK_NAME=**                          |The name of the landmark to be created.                                                                                                                                                                                                 | |**/LANDMARK_NAME=**                          |The name of the landmark to be created.                                                                                                                                                                                                 |
 +|**/ALGORITHM=**                              |The name of the functional joint algorithm to be used.                                                                                                                                                                                                 |
 |**/CALIBRATION_FILE=**                       |The name of the hybrid model. Use the full pathname.                                                                                                                                                                                    | |**/CALIBRATION_FILE=**                       |The name of the hybrid model. Use the full pathname.                                                                                                                                                                                    |
 +|**/USE_TRACKING_SEGMENT=**                   |TRUE or FALSE to use a tracking segment.                                                                                                                                                                                                 |
 |**/TRACKING_SEGMENT_NAME=**                  |The joint landmark is created relative to an existing segment. For example, for the hip joint center, the pelvis is used.                                                                                                               | |**/TRACKING_SEGMENT_NAME=**                  |The joint landmark is created relative to an existing segment. For example, for the hip joint center, the pelvis is used.                                                                                                               |
 |**/TRACKING_TYPES=**                         |The types of reference markers used for defining the landmark.                                                                                                                                                                          | |**/TRACKING_TYPES=**                         |The types of reference markers used for defining the landmark.                                                                                                                                                                          |
 |**/TRACKING_NAMES=**                         |The names of reference markers used for defining the landmark                                                                                                                                                                           | |**/TRACKING_NAMES=**                         |The names of reference markers used for defining the landmark                                                                                                                                                                           |
 |**/TRACKING_FOLDER=**                        |The folder containing the tracking markers                                                                                                                                                                                              | |**/TRACKING_FOLDER=**                        |The folder containing the tracking markers                                                                                                                                                                                              |
 +|**/USE_OTHER_SEGMENT=**                      |TRUE or FALSE to use the other segment.                                                                                                                                                                                                 |
 |**/OTHER_SEGMENT_NAME=**                     |The name of the other segment (e.g. the landmark does not refer to this segment                                                                                                                                                         | |**/OTHER_SEGMENT_NAME=**                     |The name of the other segment (e.g. the landmark does not refer to this segment                                                                                                                                                         |
-|**/SIGNAL_TYPES=**                           |The types of signals used for the tracking markers.                                                                                                                                                                                     | +|**/OTHER_TYPES=**                           |The types of signals used for the tracking markers.                                                                                                                                                                                     | 
-|**/SIGNAL_NAMES=**                           |The names of signals used for the tracking markers. Any number of tracking markers may be used.                                                                                                                                         | +|**/OTHER_NAMES=**                           |The names of signals used for the tracking markers. Any number of tracking markers may be used.                                                                                                                                         | 
-|**/SIGNAL_FOLDER=**                          |The folders for signals used for the tracking markers.                                                                                                                                                                                  | +|**/OTHER_FOLDER=**                          |The folders for signals used for the tracking markers.                                                                                                                                                                                  | 
-|**/MOTION_FILE=**                            |The full pathname of the motion file used. This command allows only one movement file to be used. The user should make sure that a full range of motion about all axes is contained in one file.                                        | +|**/MOTION_FILE=**                            |The full pathname of the motion file used. This command allows only one movement file to be used. The user should make sure that a full range of motion about all axes is contained in one file.                                                                                                                                                                                                                      | 
-|**/EVENT_START=**                            |The start frame for the range of data to be used.                                                                                                                                                                                       | +|**/COMPUTE_SECOND_LANDMARK_ON_AXIS=**        |TRUE or FALSE compute a second landmark that lies on an axis (used for computing a joint axis)                                                                                                                                                  |
-|**/EVENT_STOP=**                             |The Stop frame for the range of frames of data to use.                                                                                                                                                                                  | +
-|**/COMPUTE_SECOND_LANDMARK_ON_AXIS=**        |TRUE= compute a second landmark that lies on an axis (used for computing a joint axis)                                                                                                                                                  |+
 |**/SECOND_LANDMARK_DISTANCE=0.1**            |The location of the second landmark relative to the joint center                                                                                                                                                                        | |**/SECOND_LANDMARK_DISTANCE=0.1**            |The location of the second landmark relative to the joint center                                                                                                                                                                        |
-|**/MINIMUM_HELICAL_ROTATION_ACCEPTED=**      |Any combination of three frames for which the helical rotation angle is less than 5 degrees are rejected                                                                                                                                | +|**/EVENT_SEQUENCE=**                         |Sequence of two events (e.g., `LTO`, `LHS`) to restrict the search range.                                                                                                                                                                                                 | 
-|**/CREATE_100_REPRESENTATIVE_LANDMARKS=**    |a random selection of the intermediate Centers of Rotation will be saved as Landmarks.                                                                                                                                                  |+|**/EXCLUDE_EVENTS=**                         |If any listed event occurs in the sequence, it is skipped.                                                                                                                                                                                                                                                                                                                           | 
 +|**/EVENT_SEQUENCE_INSTANCE=**                |Index of the sequence instance to evaluate (0 = all, 1 = first, etc.).                                                                                                                                                                                                                                                                                                                           | 
 +|**/DOWNSAMPLE_RATIO=**                       |Factor by which the sampling rate is divided                                                                                                                                                                                                                                                                                                                           | 
 +|**/MINIMUM_HELICAL_ROTATION_DELTA_ACCEPTED=**|Minimum helical rotation required for a movement to be included in the functional joint calculation.                                                                                                                                                                                                                                                                                                                          |
 |**/APPROXIMATE_NUMBER_OF_COMBINATIONS_USED=**|If there are a large number of frames of data, the possible combinations of 3 frames becomes very big. The can specify an estimate of the number of combination used (these are selected randomly from the total number of combinations)| |**/APPROXIMATE_NUMBER_OF_COMBINATIONS_USED=**|If there are a large number of frames of data, the possible combinations of 3 frames becomes very big. The can specify an estimate of the number of combination used (these are selected randomly from the total number of combinations)|
-|**/SEARCH_WINDOW=**                          |Only Centers of Rotation within the search radius are used for the mean value.                                                                                                                                                          | +
-|**/RATE_OF_VOLUME_REDUCTION=**               |The rate at which the domain of possible solutions is reduced.                                                                                                                                                                          | +
-|**/NUMBER_OF_ITERATIONS_REDUCING_RADIUS=**   |The number of times the radius is reduced. At each iteration the cell containing the most crossings is used as the center for the next iteration.                                                                                       | +
-|**/MINIMUM_NUMBER_OF_VALUES_IN_RADIUS=**     |When the number of landmarks within the current radius falls below this number, the mean value is determined from these markers.                                                                                                        |+
  
 ==== Dialog ==== ==== Dialog ====
Line 83: Line 83:
 If OTHER_SEGMENT_NAME is specified, SIGNAL_TYPES, SIGNAL_NAMES, SIGNAL_FOLDER are ignored and can be left blank. If OTHER_SEGMENT_NAME is specified, SIGNAL_TYPES, SIGNAL_NAMES, SIGNAL_FOLDER are ignored and can be left blank.
  
-If OTHER_SEGMENT_NAME is balcn, SIGNAL_TYPES, SIGNAL_NAMES, SIGNAL_FOLDER must be specified.+If OTHER_SEGMENT_NAME is blank, SIGNAL_TYPES, SIGNAL_NAMES, SIGNAL_FOLDER must be specified. 
 + 
 + 
 +==== Example ==== 
 +  
 +The following pipeline will compute a functional joint (e.g. the location of the tip of the ROD relative to the LAB) and another landmark defined as the location of the tip relative to 3 of the tracking markers on the ROD.  
 + 
 +<code> 
 +The following pipeline will compute a functional joint (e.g. the location of the tip of the ROD relative to the LAB) and another landmark defined as the location of the tip relative to 3 of the tracking markers on the ROD. 
 +File_New 
 + 
 +; 
 +Set_Pipeline_Parameter  
 +/PARAMETER_NAME=FOLDER  
 +/PARAMETER_VALUE=c:demo filesCalTesterDimensions 
 + ; 
 +For_Each 
 +/ITERATION_PARAMETER_NAME=INDEX 
 +! /ITERATION_PARAMETER_COUNT_NAME= 
 +! /ITERATION_PARAMETER_COUNT_BUFFER= 
 +/ITEMS=1+2 
 +; 
 +Set_Pipeline_Parameter  
 +/PARAMETER_NAME=MOVE  
 +/PARAMETER_VALUE=::FOLDER&move&::INDEX&.c3d 
 + ; 
 +Set_Pipeline_Parameter  
 +/PARAMETER_NAME=STATIC  
 +/PARAMETER_VALUE=::FOLDER&static&::INDEX&.c3d 
 + ; 
 +Create_Hybrid_Model  
 +/CALIBRATION_FILE=::STATIC  
 +; 
 +Set_Subject_Weight  
 +/CALIBRATION_FILE=::STATIC  
 +/WEIGHT=1.0 
 + ; 
 +Set_Subject_Height  
 +/CALIBRATION_FILE=::STATIC  
 +/HEIGHT=1  
 +; 
 +Open_File  
 +/FILE_NAME=::MOVE 
 + ; 
 +Assign_Model_File  
 +/CALIBRATION_FILE=::STATIC 
 +/MOTION_FILE_NAMES=::MOVE  
 +; 
 +Add_Functional_Joint_Landmark 
 +/LANDMARK_NAME=TIP&::INDEX 
 +! /ALGORITHM=GILETTE 
 +/CALIBRATION_FILE=::STATIC 
 +/USE_TRACKING_SEGMENT=TRUE 
 +/TRACKING_SEGMENT_NAME=LAB 
 +/TRACKING_TYPES=TARGET 
 +/TRACKING_FOLDER=ORIGINAL 
 +/TRACKING_NAMES=UP1+UP2+UP3+UP4+UP5 
 +! /USE_OTHER_SEGMENT=FALSE 
 +! /OTHER_SEGMENT_NAME= 
 +! /OTHER_TYPES=TARGET 
 +! /OTHER_FOLDERS=ORIGINAL 
 +! /OTHER_NAMES= 
 +/MOTION_FILE=::MOVE 
 +! /COMPUTE_SECOND_LANDMARK_ON_AXIS=FALSE 
 +! /SECOND_LANDMARK_DISTANCE=0.1 
 +! /EVENT_SEQUENCE= 
 +! /EXCLUDE_EVENTS= 
 +! /EVENT_SEQUENCE_INSTANCE=0 
 +! /DOWNSAMPLE_RATIO=1 
 +/MINIMUM_HELICAL_ROTATION_DELTA_ACCEPTED=5 
 +/APPROXIMATE_NUMBER_OF_COMBINATIONS_USED=1000000
  
 +;
  
 +Add_Landmark 
 +/LANDMARK_NAME=CALTIP&::STATIC 
 +/CALIBRATION_FILE=::STATIC
 + ! /USER_GENERATED=TRUE 
 +! /USE_PERCENTAGE=FALSE 
 +! /CALIBRATION_ONLY=FALSE
 + /USE_TARGETS=TRUE
 + ! /SEGMENT_NAME= 
 +/TARGET_TYPES=TARGET+TARGET+TARGET 
 +/TARGET_NAMES=UP1+UP2+UP3
 +!/MCSX= 
 +!/MCSY=
 +!/MCSZ= 
 +! /LANDMARK_LOCATION= 
 +/REFERENCE_LOCATION_NAME=TIP&::INDEX
 + /REFERENCE_LOCATION_TYPE=LANDMARK
 + /USE_REFERENCE_LOCATION=TRUE ;
 +</code>
  
visual3d/documentation/pipeline/model_commands/add_functional_joint_landmark.1781098500.txt.gz · Last modified: by wikisysop