HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » signal_commands » Compute Distance Map
visual3d:documentation:pipeline:signal_commands:compute_distance_map

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:signal_commands:compute_distance_map [2024/07/03 17:43] – created sgrangervisual3d:documentation:pipeline:signal_commands:compute_distance_map [2024/07/17 15:46] (current) – created sgranger
Line 1: Line 1:
-====== Compute_Distance_Map ======+====== Compute Distance Map ======
  
 ===== Compute Distance Map ===== ===== Compute Distance Map =====
Line 21: Line 21:
 A polygonal surface mesh is defined by a set of faces, each of which is defined by a set of vertices connected by edges. Before computing distances, the Compute Distance Map command divides all faces of the ROIs into triangles, for easier processing and to guarantee that all faces are planar. In the image below, the left image highlights the vertices used to define a surface and the right image displays the triangles that define the surface: A polygonal surface mesh is defined by a set of faces, each of which is defined by a set of vertices connected by edges. Before computing distances, the Compute Distance Map command divides all faces of the ROIs into triangles, for easier processing and to guarantee that all faces are planar. In the image below, the left image highlights the vertices used to define a surface and the right image displays the triangles that define the surface:
  
-{{compute_distance_map_vertex_triangles.png}}+{{:compute_distance_map_vertex_triangles.png}}
  
 A normal vector is defined for each triangle, vertex and edge: A normal vector is defined for each triangle, vertex and edge:
  
-{{normals|{{/images/thumb/7/78/compute_distance_map_normals.png}}+{{:normals|{{/images/thumb/7/78/compute_distance_map_normals.png}}
  
 ==== Command Output ==== ==== Command Output ====
Line 32: Line 32:
  
 **** ****
-|For every Result Name specified, there will be 6 results:\\ \\ * ResultName_SegmentName[[#Minimum_Distance|_Min]]\\ * ResultName_SegmentName[[#Contact_Path|_Contact]]\\ * ResultName_SegmentName[[#Min_Vertex_Distances|_Vert]]  |  {{compute_distance_map_data_tree.png}}|+|For every Result Name specified, there will be 6 results:\\ \\ * ResultName_SegmentName[[#Minimum_Distance|_Min]]\\ * ResultName_SegmentName[[#Contact_Path|_Contact]]\\ * ResultName_SegmentName[[#Min_Vertex_Distances|_Vert]]  |  {{:compute_distance_map_data_tree.png}}|
  
 **** ****
Line 41: Line 41:
 === Minimum Distance === === Minimum Distance ===
  
-|The minimum distance between each triangle on one segment's ROI and the opposing segment's ROI.\\ \\ * A single distance value is calculated for each triangle, and is the smallest value of these candidates:\\   * (a) the distance from the opposing ROI to the closest of the triangle's vertices\\   * (b) the distance from the closest vertex on the opposing ROI that projects onto the face of the triangle (left image)\\   * (c) the distance from the closest vertex on the opposing ROI that projects onto an edge of the triangle (right image)  |  {{compute_distance_map_min_distance_calc.png}}|+|The minimum distance between each triangle on one segment's ROI and the opposing segment's ROI.\\ \\ * A single distance value is calculated for each triangle, and is the smallest value of these candidates:\\   * (a) the distance from the opposing ROI to the closest of the triangle's vertices\\   * (b) the distance from the closest vertex on the opposing ROI that projects onto the face of the triangle (left image)\\   * (c) the distance from the closest vertex on the opposing ROI that projects onto an edge of the triangle (right image)  |  {{:compute_distance_map_min_distance_calc.png}}|
  
 === Contact Point === === Contact Point ===
Line 61: Line 61:
 ==== Command Dialog ==== ==== Command Dialog ====
  
-|**Result Signal Information:**\\ \\ * Result Type: Derived\\ * Result Folder: Result can be stored in any folder\\ * Result Name: One result name for each region you are comparing\\ \\ **Color Map:**\\ \\ * Min Color & Value\\   * Determines the color for the minimum value\\   * All vertices with a minimum distance less than the value specified will have this color\\ * Inner Color\\   * Specifies the mid color and the gradient\\ * Max Color & Value\\   * Determines the color for the maximum value\\   * All vertices with a maximum distance greater than the value specified will have this color\\ \\ **Event Sequence:**\\ \\ * Without an event sequence the distance map will be created over all frames of data where the segments exist\\ * When an event sequence is specified the distance map will only be calculated for the specified frames (can be more time efficient to only analyze the time period of interest)\\ \\ **Regions:**\\ \\ * Segment Names: Specify the name of the segments to be compared\\ * Proximal Region & Sub Region:\\   * The regions correlate to the regions of interest created in the DSX suite\\ * Contact Point Area Threshold  |  {{distancemapdialog.png}}|+|**Result Signal Information:**\\ \\ * Result Type: Derived\\ * Result Folder: Result can be stored in any folder\\ * Result Name: One result name for each region you are comparing\\ \\ **Color Map:**\\ \\ * Min Color & Value\\   * Determines the color for the minimum value\\   * All vertices with a minimum distance less than the value specified will have this color\\ * Inner Color\\   * Specifies the mid color and the gradient\\ * Max Color & Value\\   * Determines the color for the maximum value\\   * All vertices with a maximum distance greater than the value specified will have this color\\ \\ **Event Sequence:**\\ \\ * Without an event sequence the distance map will be created over all frames of data where the segments exist\\ * When an event sequence is specified the distance map will only be calculated for the specified frames (can be more time efficient to only analyze the time period of interest)\\ \\ **Regions:**\\ \\ * Segment Names: Specify the name of the segments to be compared\\ * Proximal Region & Sub Region:\\   * The regions correlate to the regions of interest created in the DSX suite\\ * Contact Point Area Threshold  |  {{:distancemapdialog.png}}|
  
 ==== Drawing the Contact Path ==== ==== Drawing the Contact Path ====
  
-|You can draw the contact point and its path on the surface:  |  {{contactPath.png}}|+|You can draw the contact point and its path on the surface:  |  {{:contactPath.png}}|
  
 === Steps === === Steps ===
  
-|For every Result Name specified, there will be 6 results:\\ \\ * ResultName_SegmentName[[#Contact_Path|_Contact]]\\ * ResultName_SegmentName[[#Minimum_Distance|_Min]]\\ * ResultName_SegmentName[[#Min_Vertex_Distances|_Vert]]\\ \\ Right click on the _Min or _Contact to specify the draw properties  |  {{compute_distance_map_data_tree_right_click.png}}|+|For every Result Name specified, there will be 6 results:\\ \\ * ResultName_SegmentName[[#Contact_Path|_Contact]]\\ * ResultName_SegmentName[[#Minimum_Distance|_Min]]\\ * ResultName_SegmentName[[#Min_Vertex_Distances|_Vert]]\\ \\ Right click on the _Min or _Contact to specify the draw properties  |  {{:compute_distance_map_data_tree_right_click.png}}|
  
-|* Target Size:\\   * Size of contact path (small, medium, large or hide)\\   * Note: Size of contact path can be modified further by going to\\     * Settings -> Modify Scale of the 3D graphics Objects\\     * Modify the target size\\ * Target Color:\\   * Specify the color of the contact point\\ * Trails:\\   * Specify the color for the contact path and the number of frames before/after the current frame to draw the path\\   * Trail thickness specifies the thickness of the path  |  {{contactPath_draw_properties.png}}|+|* Target Size:\\   * Size of contact path (small, medium, large or hide)\\   * Note: Size of contact path can be modified further by going to\\     * Settings -> Modify Scale of the 3D graphics Objects\\     * Modify the target size\\ * Target Color:\\   * Specify the color of the contact point\\ * Trails:\\   * Specify the color for the contact path and the number of frames before/after the current frame to draw the path\\   * Trail thickness specifies the thickness of the path  |  {{:contactPath_draw_properties.png}}|
  
 **NOTE:** If the contact point is still too large, go to **Settings -> Modify Scale of 3D Graphics** and decrease the Target Size. **NOTE:** If the contact point is still too large, go to **Settings -> Modify Scale of 3D Graphics** and decrease the Target Size.
visual3d/documentation/pipeline/signal_commands/compute_distance_map.1720028610.txt.gz · Last modified: 2024/07/03 17:43 by sgranger