Knowledge Base - Version 22.4
Recent Changes

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
224:desktop_ext:context_insights [2022/06/22 14:40]
arnaud [Jobs execution] 		224:desktop_ext:context_insights [2022/06/23 09:38] (current)
arnaud
Line 1: Line 1:
-====== ContextInsights - Execution ======+====== ContextInsights ======
  
-This page applies to the following products: +This page describes how to use the "ContextInsights" extension for Orbit 3DM Feature Extraction Pro. \\ 
 +Specific system requirements and installation guidelines, see [[224:technology:platforms:install_contextinsights|]].
  
-  * Orbit 3DM Feature Extraction Pro – from 22.04 - CONNECT Edition +{{orbit_desktop:how_to_find.png?25&nolink  |}} [[224:desktop:workspace:main_toolbar|Main Toolbar]] > Extensions > Context Insights
  
 +===== Concepts =====
  
-It page describes how to use the ContextInsights extension\\ +==== Context Insights ====
-This extension requires a specific installation procedure\\ +
-Before going any further, please make sure you reviewed the [[https://kb.orbitgt.com/dev/technology/platforms/install_contextinsights#contextinsights_-_installation|dedicated page]]\\+
  
-{{orbit_desktop:how_to_find.png?25&nolink  |}} [[224:desktop:workspace:main_toolbar|Main Toolbar]] > Extensions > Context Insights +ContextInsights extension enables automatic detection on mapping and point cloud resources. \\
- +
-ContextInsights extension enables automatic detection on mapping and pointcloud resources.\\+
 It relies on detectors to identify objects or regions of interest. It relies on detectors to identify objects or regions of interest.
  
 +Running Context Insights detectors requires Python, Context Insights Engine, and original images from any mapping resource. The results can be directly imported in the mapping resources via the Annotations procedure. 
  
-===== Jobs description =====+==== Jobs ====  
 +  
 +A ContextInsights job will leverage machine learning to execute different types of detection in your reality data. \\ 
 +There are various types of jobs available: 
 +  * Image 2D Objects: Will detect elements as regular 2D-bounding boxes in images. Regular 2D boxes around assets. 
 +  * Image 2D Segmentation: Will detect regions in images and deliver segmented raster. Regions to segmented raster. 
 +  * Point Cloud 3D Segmentation: Attribute a class to each point of laserscan data. Classify each element of a pointcloud.
  
-A ContextInsights job will leverage machine learning to execute different types of detection in reality data.\\ +Each job type requires a suited detector to be executed on reality data. E.g: a 2D segmentation detector will only be usable for image based segmentation jobs
-There are various types of jobs available in Orbit Feature Extraction Pro:\\ +
-\\ +
-Detectors can be [[https://communities.bentley.com/products/3d_imaging_and_point_cloud_software/w/wiki/54656/context-insights-detectors-download-page|downloaded here]] before being unzipped and used by your instance\\ +
-\\ +
-• Image 2D Objects: Will detect elements as regular 2D-bouding boxes in images\\ +
-• Image 2D Segmentation: Will detect regions in images and deliver segmented raster\\ +
-• 3D segmentation: Attribute a class to each point of laserscan data\\ +
-\\ +
-Each job type requires suited detector to be executed on reality data, e.g: a 2D segmentation detector will only be usable for image based segmentation jobs+
  
-===== Jobs execution =====+==== Detectors ====
  
-In this section, it is assumed ContextInsights has been installed as recommended and Preferences have been set.\\ +A detector is a frozen model that is pre-trained by Bentley Systems. Running on your reality data through a ContextInsights job, it will automatically recognize elements of interest. List of pre-trained detectors is available here: \\ 
-\\+https://communities.bentley.com/products/3d_imaging_and_point_cloud_software/w/wiki/54656/context-insights-detectors-download-page
  
-  - Launch ContextInsights Engine\\ {{:224:desktop_ext:cinsights_engine.jpg?200|}} +A detector is specific to a certain job type. The quality of the detection will depend on the similarity between your dataset and the training dataset’s description.
-  - Set in Extensions +
-  - ContextInsights\\ {{:224:desktop_ext:extensions.jpg?200|}} +
-  - Define whether you want to create a new job or open existing one +
-  - Choose the output folder of the detection +
-  - Choose annotation type:\\ **IMPORTANT**: Image based jobs can only run on JPG images\\ {{:224:desktop_ext:annotations_type.jpg?200|}} +
-      * 2D objects: Regular 2D boxes around assets +
-      * Image 2D segmentation: Regions to segmented raster +
-      * 3D segmentation: classify each element of a pointcloud +
-  - Choose a detector depending on the information you aim at extracting\\ {{:224:desktop_ext:detector.jpg?200|}} +
-  - Define the source data detection job must occur on +
-  - Start job\\ {{:224:desktop_ext:start.jpg?200|}}+
  
 +===== Launch Context Insights Engine =====
  
 +Launch ContextInsights Engine \\
 +{{:224:desktop_ext:cinsights_engine.jpg?200|}}
  
 +===== Context Insights Sidebar =====
  
-===== Import =====+==== Preferences ====
  
-==== Open Procedure ====+Configure the directories to Python, the virtual environment, and the Context Insights detectors. 
 +The detectors and specs are listed underneath. 
  
-Open the Annotations procedure where the result xml file is already pre-filled as source object annotation file.+==== Action ====
  
 +Define whether you want to create a new job or open existing one
 +  * Create a new job and enter the target location of the results. 
 +  * Open an existing job and browse to the location of the results. 
 +
 +==== Detectors ====
 +
 +Depending on the added detectors, the following annotation types will be available.
 +
 +<note important>Image based jobs can only run on JPG images</note>
 +
 +==== Analyze ====
 +
 +Delegate the process to the task manager or start now. Running the Context Capture Engine is required before starting the process. 
 +
 +==== Import ====
 +
 +=== Open Procedure ===
 +
 +Open the Annotations procedure where the result xml file is already pre-filled as source object annotation file. \\
 Import 2D Objects or 2D Segmentations, depending on the chosen Annotation Type.  Import 2D Objects or 2D Segmentations, depending on the chosen Annotation Type. 
  
-==== Open File Location ====+=== Open File Location ===
  
 Open the target directory to verify the results.  Open the target directory to verify the results. 
 +
 +=== Image 2D Objects ===
 +
 +Import the scene xml file as 2D Object annotations to overlay the results on original or optimized images
 +
 +=== Image 2D Segmentation ===
 +
 +Apply Segmentation at optimize imagery to display the result on optimized images
  
  
 
Last modified:: 2022/06/22 14:40