BuildingExtract

Extracts building footprints from loaded imagery data and returns them as one binary raster layer and one layer of vector shapes. Post-processing options can be chosen to also create an additional simplified layer output.

This function is part of the machine learning toolset and requires large additional binary files for its operation. If these binaries aren’t detected in the SDK’s working directory at runtime, Global Mapper will attempt to automatically download them. You may receive a pop-up prompt to permit the download.

Building extraction can benefit from hardware acceleration if you have a CUDA compatible GPU and choose to enable the aUseCUDADevice boolean parameter.

Parameters:

• aLayerList ([GM_LayerHandle_t32]) – List of imagery layers to use for building extraction (if empty, all loaded layers will be used)

• aWorldBounds (GM_Rectangle_t) – Bounds to run building extraction within (if None, whole extent of input layers will be used)

• aPostProcessFlags (GM_PostProcessFlags_t8) – Flags for enabling post-processing options

• aUseCUDADevice (boolean) – If true, will attempt to run on CUDA GPU if available, but will fall back to CPU if not. If false, will run on CPU

• aCustomModelName (string) – (Optional) Filename of a custom model created by previous experimentation to use for this inference. Empty string will use built-in model

• aParentWnd (HWND) – Handle to parent window to attach the inference progress dialog to

• aReserved (uint32) – Reserved for future use; defaults to 0

Returns:

Error Code

Return type:

GM_Error_t32

Returns:

Handle to a new binary raster layer representing building footprints

Return type:

GM_LayerHandle_t32

Returns:

Handle to a new vector layer representing building footprints as area features

Return type:

GM_LayerHandle_t32

Returns:

Handle to a processed version of the building footprint layer, which will only be returned if simplify or regularize is chosen for aPostProcessFlags. Otherwise will be null

Return type:

GM_LayerHandle_t32