====== Install & Configure ContextInsights 20.1 for Orbit ======

This page describes the system requirements and installation of ContextInsights for Orbit 3DM Manage and Extract. \\
For documentation on how to use ContextInsights in Orbit, see [[234:desktop_ext:context_insights|]].

===== Requirements =====

Requirements for ContextInsights 20.1

==== System ====

Specific system requirements for ContextInsights

  * Operating System: Windows 8, 8.1, 10, and Windows Server 2012, 2016, 2019 
  * Memory: 8Gb RAM 
  * Graphic Card: NVIDIA Graphics Card > 4.0Gb and up-to-date driver 

==== Software ====

  * Orbit 3DM Manage and Extract 23.1 or higher
  * Python 3.9.13

===== Installation =====

Installation of ContextInsights and its dependencies on top of the installation of Orbit 3DM Manage and Extract.

==== Install ContextInsights =====

{{  :234:technology:platforms:contextinsights_settings.png?nolink|}}

  - Download & install ContextInsights 20.1 \\ https://softwaredownloads.bentley.com/en/ProductDetails/3108 
  - Verify ContextInsights Settings > Configuration > GPU AI compatibility > "Your computer can run AI jobs." \\ If not update or install a new GPU driver. 

==== Install Phyton ====

  - Download & install Phyton 3.9.13 \\ https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe
  - Advised customized installation directory: ''C:\Programs\Python39'' 

==== Add "ContextInsights" Environment Variables for Phyton ====

Add new "ContextInsights" User Variables matching your Phyton installation directory.

{{  :234:technology:platforms:2023-02-15_12-10-21.jpg?nolink&400|}}

  - Go to "Edit environmental variables for your account"
  - Add new user variables
    * Name: ''CONTEXT_INSIGHTS_VENV'', Value: ''C:\Programs\Python39\venv'' ((Or "venv" subfolder of alternative installation root directory))
    * Name: ''CONTEXT_INSIGHTS_PYTHON'', Value: ''C:\Programs\Python39'' ((Or alternative installation root directory))

==== Create "ContextInsights" Virtual Environment for Phyton ====

  - Execute batch file \\ ''C:\Program Files\Bentley\ContextInsights\sdk\context_insights\create_venv.bat''
  - Verify the message “Successfully installed ccmasterkernel-10.20.1.5563 wheel-0.38.4” towards the end. 

===== Add Detectors =====

Detectors can be added on-the-fly. 

==== Get "ContextInsights" Detectors  ====

  - Download and unzip detectors \\ [[https://communities.bentley.com/products/3d_imaging_and_point_cloud_software/w/wiki/54656/context-insights-detectors-download-page|https://communities.bentley.com/products/3d_imaging_and_point_cloud_software]] \\ Supported Detector Types are: ''Photo Object'', ''Photo Segmentation'', ''Pointcloud Segmentation''
  - Open Orbit 3DM Manage and Extract > Preferences > Insights / ContextInsights
  - Set the root directory of unzipped detectors