====== Point Cloud Based Extensions ======

This page describes the generic workflow for point cloud-based extensions. 

{{orbitgis:how_to_find.png?25&nolink|}} Main Toolbar > Manage or Extract > Extension


FIXME
[[234:desktop_ext:automated_feature_extraction|]]
===== Concepts =====

The extensions that use point cloud datasets have generic steps for selecting the source file and range of interest to use. \\
The target files and folders are always saved in a folder next to the opc file.

===== Source =====

==== Select point cloud dataset ====

Displays the available [[234:technology:supported_formats:pointcloud:opc|]] files from the [[234:desktop:dataset:index|Dataset List]]. Choose the dataset to be used in the extensions. The pointcloud of a [[234:technology:3d_mapping:about_resources|Mapping Run]] or a standalone opc file can be used.

==== Projects ==== 

A project represents an automatically created destination folder for the extension results next to the point cloud dataset.\\
For every execution of the extension, a new project should be created. Executing the extension in an existing project will overwrite existing data in that folder.\\

The project dropdown list gives the option to create, open, close, or delete a project.\\ 
The project label can be used (optionally) to distinguish different projects. \\


===== Range of Interest =====

Depending on the extension, different methods are available to define the range of interest to be used in the extension.
Every method has a list of possible actions to draw or select an object

==== Methods ====

=== Area ===

References:
  * Draw
  * Add selected objects
  * Add object active dataset


=== Multiple Areas ===

References:
  * Add selected objects
  * Add object active dataset

=== Path ===

References:
  * Draw
  * Add selected objects
  * Add object active dataset
  * Select trajectory segment

Depending on the extension, the following sliders are used to define the width of the area of interest:
  * Left/Right Min
  * Left/Right Max

=== Multiple Paths ===

References:
  * Add selected objects
  * Add object active dataset

=== Seed Points ===

References:
  * Add selected objects
  * Add object active dataset

==== References ====

=== Draw ===

Draw the path or area on Map 3D. Hit 'Draw' again to edit vertices of the path or area. \\
Avoid using Map 2D as there is no possibility to control the Z value. 

=== Add selected objects ===

Select one/multiple objects (depending on the Reference) and add them to the extension.

=== Add object active dataset ===

Select the source dataset in the dataset list to make it active and add it to the extension. \\
If the reference requires one object and the dataset contains multiple objects, the first object will be added. 

=== Select trajectory segment ===

Only available for mobile mapping resources with trajectory. \\
Select segment from trajectory by clicking on the Map. 

===== Parameters =====

When creating a new project preset parameters are copied from the Detector Preferences. 

Basic parameters are displayed on the sidebar, advanced parameters can be accessed by the grey circle icon above basic parameters.

Changing parameters in the sidebar influence the currently opened project immediately, while Parameters in the Preferences are only taken into account at the moment of Project creation.

When applicable, parameters can be divided into parameters of candidates and parameters of detector.
===== Test =====

Before running the detector on the range of interest, use this step to test if objects are detected as expected. 

=== Measure ===

Measure the object to test if the parameters are defined correctly. 

=== Start ===

Run the test measurement. If the object conforms with the parameters then the message "Feature is detected" will be shown, otherwise Orbit will provide a tip on the calculated statistics and recommendation on which parameters need to be changed for this feature to be detected as a feature of interest.

=== Clear ===

Clear the current test measurement.


===== Analyze =====

=== Delegate to Task Manager ===

Allows to schedule job to be run later by delegating it to the Task Manager.

=== Start Now ===

Start the process immediately.

===== Results =====

Simplified preview of results. 

===== View Settings =====

Tools to customize the visualization of source path, area, bounding boxes, ...