Differences

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

--- visual3d:documentation:pipeline:file_commands:export_polygon_trunk_example [2024/06/19 12:50] – sgranger
+++ visual3d:documentation:pipeline:file_commands:export_polygon_trunk_example [2024/07/17 15:45] (current) – created sgranger
@@ Line 1: / Line 1: @@
-{{{{{{{{\\
+====== Export Polygon Trunk Example ======
+\\
-====== polygon trunk ======
-the proximal end of the trunk is often defined as the shoulders and the distal end is at the waist<sup>[[#cite_note-serge-1|[1]]]</sup>. this definition will be referred to as "typical convention" in the following documentation.
+===== Polygon Trunk =====
-the polygon definition uses the waist as the proximal end and the shoulders as the distal. this definition will be referred to as "polygon convention" in the following documentation.
+The proximal end of the trunk is often defined as the shoulders and the distal end is at the waist<sup>[[#cite_note-Serge-1|[1]]]</sup>. This definition will be referred to as "Typical Convention" in the following documentation.
-**important note:** visual3d is marker set independent, and even when using the polygon requirements to define the trunk, there are still many ways to define the trunk segment. this tutorial is not a recommendation for how to define the trunk segment.
+The Polygon definition uses the waist as the proximal end and the shoulders as the distal. This definition will be referred to as "Polygon Convention" in the following documentation.
-the sample files can be downloaded [[https://www.has-motion.com/download/examples/export_polygon/polygonexport.zip|here]]. a sample script to export signals to polygon can be found in the zip file.
+**Important NOTE:** Visual3D is marker set independent, and even when using the Polygon requirements to define the trunk, there are still MANY ways to define the trunk segment. This tutorial is NOT a recommendation for how to define the trunk segment.
-===== typical convention =====
+The sample files can be downloaded [[https://www.has-motion.com/download/examples/Export_Polygon/PolygonExport.zip|here]]. A sample script to export signals to Polygon can be found in the zip file.
-a cmo file where the trunk is defined using "typical convention" can be downloaded [[https://www.has-motion.com/download/examples/export_polygon/polygonexport.zip|here]]. the file "sampleworkspace_typical.cmo" contains the trunk described below.
+==== Typical Convention ====
-|\\ \\ \\ \\ the **proximal** end of the trunk (rta_prox) is the mid point between the c7 and jugular notch targets (cv7 and sjn).\\ \\ the **distal** end of the trunk is the mid point between the lower back and the xiphoid process targets (ulb_mid and sxs).\\ \\ the **lateral** orientation of the trunk (rta_lat) is defined along the line between the right and left acromion targets (lcaj and rcaj).  |  polygonexport_typicalconv.png|
+A CMO file where the trunk is defined using "Typical Convention" can be downloaded [[https://www.has-motion.com/download/examples/Export_Polygon/PolygonExport.zip|here]]. The file "SampleWorkspace_Typical.cmo" contains the trunk described below.
-===== polygon convention =====
+|\\ \\ \\ \\ The **proximal** end of the trunk (RTA_PROX) is the mid point between the C7 and jugular notch targets (CV7 and SJN).\\ \\ The **distal** end of the trunk is the mid point between the lower back and the xiphoid process targets (ULB_MID and SXS).\\ \\ The **lateral** orientation of the trunk (RTA_LAT) is defined along the line between the right and left acromion targets (LCAJ and RCAJ).  |  {{:PolygonExport_TypicalConv.png}}|
-a cmo file where the trunk is defined using the "polygon convention" can be downloaded [[https://www.has-motion.com/download/examples/export_polygon/polygonexport.zip|here]]. the file "sampleworkspace_polygon.cmo" contains the trunk described below.
+==== Polygon Convention ====
-|\\ \\ \\ \\ the **proximal** end of the trunk is the mid point between the lower back and the xiphoid process targets (ulb_mid and sxs).\\ \\ the **distal** end of the trunk (rta_prox) is the mid point between the c7 and jugular notch targets (cv7 and sjn).\\ \\ the **medial** orientation of the trunk (rta_lat) is defined along the line between the right and left acromion targets (lcaj and rcaj).  |  polygonexport_polygonconv.png|
+A CMO file where the trunk is defined using the "Polygon Convention" can be downloaded [[https://www.has-motion.com/download/examples/Export_Polygon/PolygonExport.zip|here]]. The file "SampleWorkspace_Polygon.cmo" contains the trunk described below.
-===== coordinate system orientation =====
+|\\ \\ \\ \\ The **proximal** end of the trunk is the mid point between the lower back and the xiphoid process targets (ULB_MID and SXS).\\ \\ The **distal** end of the trunk (RTA_PROX) is the mid point between the C7 and jugular notch targets (CV7 and SJN).\\ \\ The **medial** orientation of the trunk (RTA_LAT) is defined along the line between the right and left acromion targets (LCAJ and RCAJ).  |  {{:PolygonExport_PolygonConv.png}}|
-|\\ \\ \\ \\ if the segment has been defined correctly, the origin should be just below the ribs.\\ \\ the orientation of the segment coordinate system should be aligned with the coordinate systems of the other segments in the model. in the image, the coordinate systems was rotated so that +z is up and +x is mediolateral. instructions to rotate a coordinate system can be found [[visual3d:documentation:modeling:segments:modify_segment_coordinate_system|here]].  |  polygonexport_segmentgeometry.png|
+==== Coordinate System Orientation ====
+|\\ \\ \\ \\ If the segment has been defined correctly, the origin should be just below the ribs.\\ \\ The orientation of the segment coordinate system should be aligned with the coordinate systems of the other segments in the model. In the image, the coordinate systems was rotated so that +Z is up and +X is mediolateral. Instructions to rotate a coordinate system can be found [[Visual3D:Documentation:Modeling:Segments:Modify_Segment_Coordinate_System|here]].  |  {{:PolygonExport_SegmentGeometry.png}}|
 \\
-===== skeleton =====
+==== Skeleton ====
+The default image for the thorax/ab segment includes the lumbar. Since these segments are not included in the Polygon convention, you may want to modify the graphic image in the Segment Properties tab. Please note, this is only for aesthetics.
-the default image for the thorax/ab segment includes the lumbar. since these segments are not included in the polygon convention, you may want to modify the graphic image in the segment properties tab. please note, this is only for aesthetics.
+|\\ \\ \\ \\ Click the "Browse" button next to "Model File:" and search for the "thoraciccerviclet12toacromium.v3g" file in the "Visual3D v5\Models" folder.\\ \\ Click the "Rotate/Scale Graphic Model" button and set the "Clockwise Rotation" to 180.  |  {{:PolygonExport_SegmentProperties.png}}|
-|\\ \\ \\ \\ click the "browse" button next to "model file:" and search for the "thoraciccerviclet12toacromium.v3g" file in the "visual3d v5\models" folder.\\ \\ click the "rotate/scale graphic model" button and set the "clockwise rotation" to 180.  |  polygonexport_segmentproperties.png|
+==== References ====
-===== references =====
+  - [[#cite_ref-Serge_1-0|↑]] Serge van Sint Jan "Color Atlas of Skeletal Landmark Definitions: Guidelines for Reproducible Manual and Virtual Palpations" 2007 - Churchill Livingstone: p. 3
-  - [[#cite_ref-serge_1-0|↑]] serge van sint jan "color atlas of skeletal landmark definitions: guidelines for reproducible manual and virtual palpations" 2007 - churchill livingstone: p. 3
-}}}}}}}}