Differences

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

--- visual3d:documentation:modeling:landmarks:landmark_types [2024/06/19 12:48] – sgranger
+++ visual3d:documentation:modeling:landmarks:landmark_types [2024/07/17 15:45] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{landmarks provide a powerful method of representing significant locations within space or locations defined by the model. landmarks are created by either specifying a location in a segment coordinate system or by transforming markers or other landmarks into a significant location.
+====== Landmark Types ======
-landmarks are like virtual markers, whose positions are computed automatically by visual3d based on the positions of the actual markers, segments, or equations, according to rules which you define.
+Landmarks provide a powerful method of representing significant locations within space or locations defined by the model. Landmarks are created by either specifying a location in a segment coordinate system or by transforming markers or other landmarks into a significant location.
-the landmark mechanism is the key to visual3d’s highly flexible modeling capabilities. a single example suffices to suggest the usefulness of markers. frequently, target markers are mounted on short posts which protrude away from the skin surface, and consequently, defining a segment using medial and lateral markers as described above will tend to over-estimate the segment’s radii. you can eliminate this problem by creating landmarks which are like "shadow versions" of the actual markers, moved inward by the length of the marker posts to better approximate the skin surface, and then define your segments based on these landmarks.
+Landmarks are like virtual markers, whose positions are computed automatically by Visual3D based on the positions of the actual markers, segments, or equations, according to rules which you define.
-===== pipeline commands =====
+The landmark mechanism is the key to Visual3D’s highly flexible modeling capabilities. A single example suffices to suggest the usefulness of markers. Frequently, target markers are mounted on short posts which protrude away from the skin surface, and consequently, defining a segment using medial and lateral markers as described above will tend to over-estimate the segment’s radii. You can eliminate this problem by creating landmarks which are like "shadow versions" of the actual markers, moved inward by the length of the marker posts to better approximate the skin surface, and then define your segments based on these landmarks.
-if you want to [[visual3d:documentation:pipeline:model_commands:modeling_commands#add_landmark|create a landmark using a pipeline command]] and you already know how to create the landmark interactively in model builder mode, you can save the model template to disk. open the model template and search for the landmark definition. you can then cut-and-paste the definition into a pipeline. the only difference will be that you must specify the model that is to be used; e.g. the model template already defines which model is to be used to create the landmark.
+==== Pipeline Commands ====
-===== landmark extent =====
+If you want to [[Visual3D:Documentation:Pipeline:Model_Commands:Modeling_Commands#Add_Landmark|create a landmark using a pipeline command]] and you already know how to create the landmark interactively in Model Builder Mode, you can save the model template to disk. Open the model template and search for the Landmark definition. You can then cut-and-paste the definition into a pipeline. The only difference will be that you must specify the Model that is to be used; e.g. the model template already defines which model is to be used to create the landmark.
-landmarks can be 'calibration only' or can be calculated for the motion files.
+==== Landmark Extent ====
-==== calibration only ====
+Landmarks can be 'calibration only' or can be calculated for the motion files.
-used only for segment calibration, but are not needed (or produced) for any associated motion file(s).
+=== Calibration Only ===
-==== generated for assigned motion files ====
+Used only for segment calibration, but are not needed (or produced) for any associated motion file(s).
-generated for the calibration file, and the associated motion files. these landmarks may be used for tracking a segment.
+=== Generated for Assigned Motion Files ===
-===== landmark types =====
+Generated for the calibration file, and the associated motion files. These landmarks may be used for tracking a segment.
-there are several landmark types or ways to create landmarks. landmarks can be created:
+==== Landmark Types ====
+There are several landmark types or ways to create landmarks. Landmarks can be created:
   - as a point relative to one marker/landmark
-  - as a point on a line
+  - as a point on a Line
-  - as a point in a plane
+  - as a point in a Plane
-  - as a point projected on a line
+  - as a point Projected on a Line
-  - as a point projected on a plane
+  - as a point Projected on a Plane
   - as offsets
   - relative to segments
   - digitized with a pointer
   - as a functional point
-  - to create muscles which are defined by linear segments connecting a series of landmarks.
+  - to create muscles which are defined by linear segments connecting a series of Landmarks.
-==== point projected on a line ====
+=== Point Projected on a line ===
-point projection onto a line can be used at the shoulder to project a lateral target on to a vertical line passing through the acromium or it can be used at the knee to project lateral or medial targets on a functional axis.
+Point projection onto a line can be used at the shoulder to project a lateral target on to a vertical line passing through the acromium or it can be used at the knee to project lateral or medial targets on a functional axis.
-to define a landmark as a point projected on a line (two other points define a line in space), select the targets and/or landmarks radio button. select 2 targets and/or landmarks for the reference/axial starting point and axial ending point. select a point to project using the projected from combo box.
+To define a landmark as a point projected on a line (two other points define a line in space), select the Targets and/or Landmarks radio button. Select 2 targets and/or landmarks for the Reference/Axial Starting Point and Axial Ending Point. Select a point to project using the Projected From combo box.
-in the image below, the **ranklecenter** is the point that is created by projecting the **rhl** heel marker onto the line created from the lateral and medial ankle markers **rla** and **rma**.
+In the image below, the **RAnkleCenter** is the point that is created by projecting the **RHL** heel marker onto the line created from the lateral and medial ankle markers **RLA** and **RMA**.
-landmark_point_projected_onto_a_line.jpg
+{{:landmark_point_projected_onto_a_line.jpg}}
-another example can be found on this page, [[visual3d:documentation:modeling:landmarks:projecting_a_marker_onto_a_line|project onto a line]].
+Another example can be found on this page, [[Visual3D:Documentation:Modeling:Landmarks:Projecting_a_marker_onto_a_line|Project onto a line]].
-==== point projected on to a plane ====
+=== Point Projected on to a plane ===
-by projecting multiple landmarks onto the same plane you can build segment coordinates systems in a specific plane. to define a landmark as a point projected onto a plane defined by 3 points, select the targets and/or landmarks radio button. select three targets and/or landmarks for the reference/axial starting point, axial ending point and lateral object to define a plane. select a point to project using the projected from combo box.
+By projecting multiple landmarks onto the same plane you can build segment coordinates systems in a specific plane. To define a landmark as a point projected onto a plane defined by 3 points, select the Targets and/or Landmarks radio button. Select three targets and/or landmarks for the Reference/Axial Starting Point, Axial Ending Point and Lateral object to define a plane. Select a point to project using the Projected From combo box.
-in the image below, the **rppinplane** is the point that is created by projecting the **rpp** marker on the illiac crest onto the plane created from the right and left asis's (**rasi**,**lasi**) and the right psis **rps** marker.
+In the image below, the **RPPinPlane** is the point that is created by projecting the **RPP** marker on the illiac crest onto the plane created from the right and left ASIS's (**RASI**,**LASI**) and the right PSIS **RPS** marker.
-landmark_point_projected_onto_a_plane.jpg
+{{:landmark_point_projected_onto_a_plane.jpg}}
-=== example 1: project the hip joint onto a plane passing through the gt's ===
+== Example 1: Project the hip joint onto a plane passing through the GT's ==
-this example will illustrate how one would project a hip joint center landmark onto frontal plane of the pelvis passing through the greater trochanters.
+This example will illustrate how one would project a hip joint center landmark onto frontal plane of the pelvis passing through the greater trochanters.
-=== example 2: project onto a principal plane ===
+== Example 2: Project onto a principal plane ==
-this is an example of how one would project a heel marker, rheel on the floor or x-y plane of the laboratory.
+This is an example of how one would project a heel marker, RHEEL on the floor or X-Y plane of the laboratory.
-==== offsets ====
+=== Offsets ===
-landmarks are often offsets from existing target markers. the origin of the offset is the starting point (reference point). the offset is specified as an absolute distance in meters, or as a percentage. the percentage is relative to a segment or markers.
+Landmarks are often offsets from existing target markers. The origin of the offset is the starting point (reference point). The offset is specified as an absolute distance in meters, or as a percentage. The percentage is relative to a segment or markers.
-=== use regression equations as offset ===
+== Use regression equations as offset ==
-one can use regression equations as an offset in the landmark definition (i.e. hip joint centers) see the example in the previous section [[visual3d:documentation:modeling:landmarks:projecting_a_marker_onto_a_plane|example 1: project the hip joint onto a plane passing through the gt's]].
+One can use regression equations as an offset in the landmark definition (i.e. Hip joint centers) see the example in the previous section [[Visual3D:Documentation:Modeling:Landmarks:Projecting_a_marker_onto_a_plane|Example 1: Project the hip joint onto a plane passing through the GT's]].
-== hip landmark ==
+= Hip Landmark =
-landmarks defining the location of the hip joint center are not particularly notable except that two of the default pelvis segment types (coda and helen hayes) create hip joint landmarks automatically when the segment is created.
+Landmarks defining the location of the hip joint center are not particularly notable except that two of the default Pelvis segment types (Coda and Helen Hayes) create hip joint landmarks automatically when the segment is created.
-== bell and brand hip ==
+= Bell and Brand Hip =
-specifying the hip joint landmark using bell and brand. this page will also illustrate how to create a generic pelvis technical coordinate system and hip landmarks.
+Specifying the Hip Joint Landmark using Bell and Brand. This page will also illustrate how to create a generic pelvis technical coordinate system and hip landmarks.
-== hip landmark from custom regression equation ==
+= Hip Landmark from Custom Regression Equation =
-specifying the hip joint landmark using a custom regression equation
+Specifying the Hip Joint Landmark using a custom regression equation
-=== relative to a segment ===
+== Relative to a segment ==
-landmarks can be created relative to a segment (in the segment coordinate system).
+Landmarks can be created relative to a segment (in the segment coordinate system).
-to define a landmark in a segment coordinate system, in the **landmarks** mode, select the **existing segment** radio button, and select a segment in the existing segment combo box below the button. segment landmarks are, by default, offset from the segment origin. if you would like to offset the landmark from a different location you must select a **reference/axial starting point** marker/landmark location. the landmark offsets can be specified in any coordinate system that has been defined in the model. when defining a landmark relative to a segment, the 3 components of the offset are defined anatomically as ml, ap, and axial boxes.
+To define a landmark in a segment coordinate system, in the **Landmarks** Mode, select the **Existing Segment** radio button, and select a segment in the existing segment combo box below the button. Segment landmarks are, by default, offset from the segment origin. If you would like to offset the landmark from a different location you must select a **Reference/Axial Starting Point** marker/landmark location. The landmark offsets can be specified in any coordinate system that has been defined in the model. When defining a landmark relative to a segment, the 3 components of the offset are defined anatomically as ML, AP, and AXIAL boxes.
-if you would like to offset the landmark in lab space, you may select the **lab** segment in the existing segment combo box. when the landmark is relative to the **lab** the offsets are the x, y and z directions of the lab.
+If you would like to offset the landmark in lab space, you may select the **LAB** segment in the existing segment combo box. When the landmark is relative to the **LAB** the offsets are the X, Y and Z directions of the lab.
-== landmark relative to a thigh segment ==
+= Landmark relative to a thigh segment =
-this is an example of creating a landmark relative to a thigh segment with ml, ap, and axial offsets in percent.
+This is an example of creating a landmark relative to a thigh segment with ML, AP, and AXIAL offsets in percent.
-== landmark at segment endpoint ==
+= Landmark at segment endpoint =
-creating a landmark at the end of a segment that is tracked with the segment
+Creating a landmark at the end of a segment that is tracked with the segment
-== example using a reference location ==
+= Example using a reference location =
-this example creates a landmark relative to a segment (or to 3 markers) using a reference location.
+This example creates a landmark relative to a segment (or to 3 markers) using a reference location.
-==== relative to 3 locations ====
+=== Relative to 3 Locations ===
-landmarks can be created relative to 3 locations. this can be handy when removing markers in the motion trials.
+Landmarks can be created relative to 3 locations. This can be handy when removing markers in the motion trials.
-landmark3a.jpg
+{{:landmark3a.jpg}}
-landmark3b.jpg
+{{:landmark3b.jpg}}
-a right handed orthogonal coordinate system is defined by the three points (p1, p2, p3).
+A right handed orthogonal coordinate system is defined by the three points (P1, P2, P3).
-the origin of the coordinate system is at the point p1
+The origin of the coordinate system is at the point P1
-the **frontal plane** of the coordinate system is defined by the three points.
+The **frontal plane** of the coordinate system is defined by the three points.
-the positive ap direction is into the screen.
+The positive AP direction is into the screen.
 \\
-=== landmark type 5 ===
+== Landmark Type 5 ==
-create a landmark defining the location of a segment endpoint relative to 3 tracking markers (or landmarks).
+Create a landmark defining the location of a segment endpoint relative to 3 tracking markers (or landmarks).
-==== digitized landmarks ====
+=== Digitized Landmarks ===
-the objective for using the pointer is to identify anatomical landmarks without having to place motion capture markers at the location.
+The objective for using the pointer is to identify anatomical landmarks without having to place motion capture markers at the location.
-==== functional landmarks (joints) ====
+=== Functional Landmarks (Joints) ===
-the functional joint calculations have been adapted from:
+The functional joint calculations have been adapted from:
-[[[http://www.sciencedirect.com/science/article/pii/s002192900400137x|schwartz mh, rozumalski a (2005) a new method for estimating joint parameters from motion data. journal of biomechanics, 38, 107-116]]]
+[[[http://www.sciencedirect.com/science/article/pii/S002192900400137X|Schwartz MH, Rozumalski A (2005) A new method for estimating joint parameters from motion data. Journal of Biomechanics, 38, 107-116]]]
 and from
-[[[http://www.sciencedirect.com/science/article/pii/s0021929016303979|jensen e, lugade v, crenshaw j, miller e, kaufman k (2016) a principal component analysis approach to correcting the knee flexion axis during gait. journal of biomechanics, in press]]]
+[[[http://www.sciencedirect.com/science/article/pii/S0021929016303979|Jensen E, Lugade V, Crenshaw J, Miller E, Kaufman K (2016) A principal component analysis approach to correcting the knee flexion axis during gait. Journal of Biomechanics, in press]]]
-==== muscles ====
+=== Muscles ===
+Muscles are defined by linear segments connecting a series of Landmarks. The Landmarks can be created using any of the rules for creating landmarks in Visual3D.
-muscles are defined by linear segments connecting a series of landmarks. the landmarks can be created using any of the rules for creating landmarks in visual3d.
+==== Examples ====
-===== examples =====
+=== Create a Landmark Mimicking contralateral segment ===
-==== create a landmark mimicking contralateral segment ====
+It was not possible to place anatomical landmarks on the medial and lateral ankle of the subject because the subject was missing one lower limb. It was possible to place markers on the foot prosthesis consistent with the existing foot. Assuming symmetry in the two foot segments the user wanted to create landmarks representing the location of the medial and lateral ankle of the missing shank relative to the foot coordinate system consistent with the location of the medial and lateral ankle in the existing segment.
+=== Create Landmarks from a Knee Alignment Device ===
-it was not possible to place anatomical landmarks on the medial and lateral ankle of the subject because the subject was missing one lower limb. it was possible to place markers on the foot prosthesis consistent with the existing foot. assuming symmetry in the two foot segments the user wanted to create landmarks representing the location of the medial and lateral ankle of the missing shank relative to the foot coordinate system consistent with the location of the medial and lateral ankle in the existing segment.
+The [[Visual3D:Documentation:Modeling:Segments:Knee_Alignment_Device|Knee Alignment Device]] (KAD) is manufactured by Motion Lab Systems. The KAD is used to assist in defining the frontal plane of the thigh segment. This page describes the KAD and shows how it is implemented to create the frontal plane and landmarks in Visual3D.
-==== create landmarks from a knee alignment device ====
-the [[visual3d:documentation:modeling:segments:knee_alignment_device|knee alignment device]] (kad) is manufactured by motion lab systems. the kad is used to assist in defining the frontal plane of the thigh segment. this page describes the kad and shows how it is implemented to create the frontal plane and landmarks in visual3d.
+=== Create a Landmark Using two standing trials ===
-==== create a landmark using two standing trials ====
+Landmarks can be created from two static standing trials.
-landmarks can be created from two static standing trials.
+== Replacing missing landmark ==
-=== replacing missing landmark ===
+We collected 2 sets of studies for the same person, and we collected one static trial of the lower extremity for each set of the study. We forgot to add the GT markers for the first static trial. Based on what we have right now (a complete 2nd static trial and the 1st static trial with GT markers missing), is it possible for us to create a virtual GT marker for the first static trial?
-we collected 2 sets of studies for the same person, and we collected one static trial of the lower extremity for each set of the study. we forgot to add the gt markers for the first static trial. based on what we have right now (a complete 2nd static trial and the 1st static trial with gt markers missing), is it possible for us to create a virtual gt marker for the first static trial?
+=== Create a Landmark for a Missing Tracking Marker ===
-==== create a landmark for a missing tracking marker ====
+Landmarks can be created to calculate missing tracking markers.
-landmarks can be created to calculate missing tracking markers.
+== Example: Missing Tracking Marker in Static Trial ==
-=== example: missing tracking marker in static trial ===
+Consider the following right thigh segment constructed using static markers RPPT, RAPT, RPDT, RADT. These tracking markers are saved to a model template, but for the next subject the static trial is missing the RAPT marker. A landmark can be created to replace the missing tracking marker.
-consider the following right thigh segment constructed using static markers rppt, rapt, rpdt, radt. these tracking markers are saved to a model template, but for the next subject the static trial is missing the rapt marker. a landmark can be created to replace the missing tracking marker.
+=== Create Landmarks from Motion Trial ===
-==== create landmarks from motion trial ====
+Landmarks can be created from the motion trials.
-landmarks can be created from the motion trials.
+== Using Motion Trial Example 1 ==
-=== using motion trial example 1 ===
+This example creates landmarks from Targets in a movement trial but not in the standing trial. In this example, a movement trial contains 4 markers that have been placed on the corners of an object. The standing trial does not contain these markers, but needs the corner locations for defining an object (segment).
-this example creates landmarks from targets in a movement trial but not in the standing trial. in this example, a movement trial contains 4 markers that have been placed on the corners of an object. the standing trial does not contain these markers, but needs the corner locations for defining an object (segment).
+== Using Motion Trial Example2 ==
-=== using motion trial example2 ===
+A structure (i.e. stairs) can be defined by placing markers at vertices, then connecting these vertices. It isn't always practical, however, to place these markers during the standing trial, so it would be useful to have a separate motion trial that contained only these markers. In this example, we demonstrate how to get the marker locations from a movement trial and create landmarks. In the movement trial for this example, markers are placed on the steps of a set of stairs.
-a structure (i.e. stairs) can be defined by placing markers at vertices, then connecting these vertices. it isn't always practical, however, to place these markers during the standing trial, so it would be useful to have a separate motion trial that contained only these markers. in this example, we demonstrate how to get the marker locations from a movement trial and create landmarks. in the movement trial for this example, markers are placed on the steps of a set of stairs.
-}}}}}}}}