HxMap can be installed on a single workstation where processes will be executed locally. The following chapters will guide you through the steps required to setup HxMap on your machine.
Given the data volume of our airborne sensors most of the processing steps tend to be fairly time consuming. To cut down on processing time it is therefore highly recommended to deploy HxMap in a distributed environment.
Installation Components
The installation files contain multiple components:
|
Component |
Purpose |
|---|---|
|
HxMap WFM Installer
|
HxMap WFM installer for the current <release> and <build> |
|
HxMap GeoData
GlobalElevation(x64)_Installer.exe |
HxMap GeoData is delivered as Coordinate Systems and Global Elevation. Coordinate Systems are updated each release while Global Elevation does not change. These files could be shared by multiple software releases. |
|
HxMap 3D Advanced HxMap_<version>(x64)_3dAdvanced_Installer.exe HxMap_<version>(x64)_3dAdvanced_Installer_NVIDIA_CUDA_1.exe HxMap_<version>(x64)_3dAdvanced_Installer_NVIDIA_CUDA_2.exe HxMap_<version>(x64)_3dAdvanced_Installer_PYTORCH.exe |
HxMap 3D Advanced installer will install all features needed to create textured 3D mesh and true ortho products. The main installer and its related prerequisites (CUDA and PyTorch) must be copied into the same directory as the HxMap Full Installer. Full installer will automatically prompt the user to install 3D Advanced. |
|
Installation prerequisites |
All operating system run time library updates required by HxMap applications |
|
HxMap Bathy HxMapBathy_<version>.exe |
Post-processing component required for running ingest of CoastalMapper data. Can be installed to a shared location for cluster processing. |
|
Z/I RPP+
|
Post-processing component required for running ingest of DMCIII data. Must be installed locally on each node for cluster processing. |
|
3D Building Viewer
|
Additional software application that allows to visualize generated building data. |
HxMap licensing is managed with Leica Client License Manager CLM application. The latest version of Leica CLM can be downloaded from Leica myWorld portal.
Installation Steps
-
Its recommended to not update a HxMap installation in place with a new installer.
-
HxMap can be installed to a custom location, and multiple installed versions can exist side by side if needed. Be sure to review and update operating system short-cuts to the Workflow Manager application (workflowmanager.exe) before running.
-
Make sure you are logged in using an administrator account
-
Download required installation files and extract into a temporary folder
-
Double-click on the HxMap full installer and follow instructions by the installation program.
-
Installation of Coordinate Systems, Global Elevation, and 3D Advanced (if downloaded), along with any prerequisites, will automatically be launched as part of the installation process.
-
Global Elevation installer includes low resolution (32 arc-second) data for the entire globe and optionally allows the user to download high resolution (1 arc-second) data for individual areas based on the United Nations Geoscheme. The original data used for this product have been supplied by JAXA’s ALOS Global Digital Surface Model "ALOS World 3D - 30m (AW3D30).
-
-
CoastalMapper users will need to install HxMap Bathy: run the installer.
-
DMCIII user will need to install Z/I RPP+: Unzip the zip-file and execute the included installer
-
(optional) Install the additional viewer application for 3D Building data
-
Install the Leica Geosystems Client License Manager
-
Launch the Client License Manager and activate your HxMap Software Entitlements
-
(optional) configure your HxMap installation by modifying the “hxmap.ini” as discussed Customization section
-
Launch HxMap Workflow Manager
Remote Desktop Connection
HxMap requires OpenGL 2.0 or better. However, when you use HxMap via remote desktop connection, Microsoft's Remote Desktop uses (until now) always software generated OpenGL which is OpenGL 1.1. In that case, either use a different technology, e.g. Virtual Network Computing (VNC), or still use remote desktop but start HxMap using a batch file as shown below:
REM Restart the HxMap Workflow Manager from a Microsfot RDP Session
for /f "tokens=4 delims= " %%G in ('tasklist /FI "IMAGENAME eq tasklist.exe" /NH') do SET RDP_SESSION=%%G tscon %RDP_SESSION% /dest:console
"C:\Program Files\Hexagon\HxMap\Workflow Manager\workflowmanager.exe"