====== Semi Automated 3D Measurement Functions ======

This page describes all semi-automated / auto-complete measure functions. For basic measurements, see [[202:technology:3d_mapping:measurements|]]. \\
It is recommended to read first [[202:desktop:map:3d_measurements|]].

Auto-complete measurements are available in Feature Extraction Standard and Pro, see [[202:products:product_comparison|]].

===== Concepts =====

Semi-automated measurement functions or Detectors require direct file access point cloud availability.\\
Detectors are designed to extract features based on their known properties. Understanding of how certain object will be represented in the point cloud allows to extract it with just a few clicks. The characteristic used can be: geometry of the object, reflectivity, color or any combination of the above.\\

**Point Cloud Resource ** \\
Detectors analyze single point cloud dataset (opened as a simple resource or as part of a compound resource: MM and UAS Runs\Oblique Project) and return measurement which can be saved into a vector dataset or theme of corresponding type.\\
Point Cloud resources must be optimized into an Orbit Point Cloud. If needed merge and optimize multiple Point Cloud resources into a single resource, see [[202:technology:supported_formats:pointcloud:opc|]] and [[202:desktop:tools:optimize_data|]].

===== Functions =====

==== Line ====

{{:170:desktop:mmpano_measure_ridge.png?nolink|}} **Ridge with 1 point** \\
Auto completed ridge measurement. \\
How to measure : 
  * Option 1: Any point on ridge. 
  * Option 2: (1) Snap to other object. (2) Specify direction point to auto complete ridge. \\
Results : xyz, xy and z length. \\

{{:mobile_mapping:desktop:core:use:mmpano_measure_ridge_multi.png?nolink|}} **Multiple ridges**\\
Auto completed multiple ridges measurement. \\
How to measure :  (1) Any point on first ridge. (2) Any point on second ridge. (3) Any point on third ridge. ... (n) Double click to end measurement on the last ridge that should be measured. \\
Results : xyz, xy and z length. \\

{{:170:desktop:mmpano_measure_rails.png?nolink|}} **Rail with 3 points** \\
Auto completed rail measurement. \\
How to measure : (1) Any point on rail 1, (2) 2nd point on rail 1, (3) Any point on rail 2. \\
Results : xyz, xy and z length. \\

{{:170:desktop:mmpano_measure_road_full_line.png?nolink|}} ** Road mark with 2 points ** \\
Auto completed solid road markings measurement. \\
Conditions : Point cloud must include values for intensity. \\
How to measure : (1) Start point, (2) Direction point to auto-complete road marking. \\
Results : xyz, xy and z length. \\

{{:170:desktop:mmpano_measure_road_dash_line.png?nolink|}} **Road mark with 3 points** \\
Auto completed dashed road markings measurement. \\
Conditions : Point cloud must include values for intensity.  \\
How to measure : (1) Start point 1st dash, (2) End point 1st dash, (3) End point 1st gap (equals start point 2nd dash). \\
Results : xyz, xy and z length. \\

{{mobile_mapping:desktop:core:use:mmpano_measure_fence_1click.png?nolink|}} **Fence with 1 point** \\
Auto completed top of fence measurement.
How to measure : 
  * Option 1: Any point on top of fence. 
  * Option 2: (1) Snap to other object. (2) Specify direction point to auto-complete fence. \\
Results : xyz, xy and z length. \\

{{mobile_mapping:desktop:core:use:mmpano_measure_soil_separation_1click.png?nolink|}} **Separation line with 1 point**\\
Auto completed color separation line measurement.
Conditions : Point cloud must include values for RGB.  \\
How to measure : 
  * Option 1: Any point on separation line between two areas with different colors. 
  * Option 2: (1) Snap to other object. (2) Specify direction point to auto-complete color separation line. \\
Results : xyz, xy and z length. \\

{{mobile_mapping:desktop:core:use:mmpano_measure_guard_rail_1click.png?nolink|}} **Guardrail with 1 point**\\
Auto completed guardrail detection. \\
Conditions : This is a linear reference measurement. This option should be enabled in [[202:desktop:preferences:3dhover|]] and a linear vector file should be available in the workspace.\\
How to measure : \\
  * Option 1: Click on the guard rail in the point cloud.
  * Option 2: Create a slice view (see [[202:desktop:tabs:slice_view|]]) through the guard rail, select the guard rail by moving the rectangle over it and click. 
It is advised to use option 2 because this is a more controlled measurement. \\
Parameters for the guardrail detection can be changed in the Detectors Preferences. \\
Results : xyz, xy and z length.\\

==== Catenary ====

{{:170:desktop:mmpano_measure_distance_catenary_1click.png?nolink|}} **Catenary Curve with 1 point** \\
Catenary curve measurement. \\
How to measure : (1) Any point on catenary curve. Combine with <Ctrl> to measure all parallel wires between two poles. \\
Results : Distance over curve, clearance and span. 

{{:170:desktop:mmpano_measure_distance_catenary_1click_height.png?nolink|}} **Catenary Curve to horizontal reference plane** \\
Catenary curve and lowest clearance measurement. \\
How to measure :  (1) Ground reference point, (2) Any point on catenary curve. \\
Results : Distance over curve, clearance and span, x,y,z. \\

==== Area ====

{{:mobile_mapping:desktop:core:use:mmpano_measure_cross_walk.png?nolink|}} **Crosswalk** \\
How to measure : (1) Start of crosswalk, (2) End of crosswalk.\\
Parameters for the crosswalk detection can be changed in the Detectors Preferences. \\
Results : area xyz, area xy.\\