# FAQ

## General Information

<details>

<summary>What's the difference between Get3D Mapper, Get3D Viewer and Get3D ModelFun?</summary>

Get3D Mapper is a large-scale 3D reconstruction software that uses imagery and point clouds as primary data sources, producing 3D mesh models and 2D outputs.

Get3D ModelFun is a model editing tool for mesh-based operations such as hole filling, fragment removal, and texture refinement.

Get3D Viewer is a free visualization tool that supports multi-source data overlay, including meshes, point clouds, and 2D layers, and provides tools for measurement, analysis, data conversion, and screen recording.

</details>

<details>

<summary>What is Get3D Engine?</summary>

Get3D Engine is a background processing module that executes tasks and supports cluster processing jobs.\
Get3D Engine includes a monitoring function for quickly checking engine status and utilization, as well as modifying settings. Users can configure options and control the engine using start/stop commands.

{% hint style="info" %}
Get3D Engine must be started while the software is in use, and the engine path must match the job queue directory path.
{% endhint %}

</details>

<details>

<summary>Computer Requirement and Recommendation</summary>

Requirement:\
GPU: NVIDIA GPUs supporting CUDA 12.5 or later, performance equal to or higher than RTX 20-series\
CPU: Intel K-series or AMD CPU with high frequency\
Intel 13th or 14th generation i9 K-series CPUs are not recommended, as the software may crash when CPU usage is too high.\
RAM:At least 32G\
Operating system: Windows only

Recommendation:\
GPU: Recommended NVIDIA consumer-grade RTX 30, 40, and 50 series GPUs. Or NVIDIA GPUs with performance higher than the RTX 3060\
CPU: Intel K-series or AMD CPU with high frequency\
RAM:128G\
Operating system: Windows 10 / 11 (64-bit), Windows Server 2012 / 2016 / 2019

{% hint style="info" %}
Get3D Mapper supports NVIDIA GPUs only and CUDA version should be higher than 12.5. Some older GPU models no longer support CUDA 12.5 or above and therefore cannot run the software.
{% endhint %}

</details>

## Download & Installation

<details>

<summary>How can I download Get3D Mapper?</summary>

Visit the Get3D website to download Get3D Mapper. <https://www.get3d.ai/downloads/>

</details>

<details>

<summary>Can I try 3DGS feature?</summary>

The Get3D Mapper has added the 3DGS feature. It's an internal beta version currently. Please [contact us](https://www.get3d.ai/contact) to have the trial.

</details>

## License & Activation

<details>

<summary>How to get a trial of Get3D Mapper?</summary>

Before getting a trial, you need to register an account on [Get3D website](https://www.get3d.ai/). Then you'll get one-month free trial automatically.\
Log in your account in the software, select license to activate it.

{% hint style="info" %}

An account only has one trial. During the trial period, users can use all the features of the software without limiting the number of projects, but the number of photos in each project cannot exceed 5,000.
{% endhint %}

</details>

<details>

<summary>What's the difference between trial and official license?</summary>

The trial version allows processing of up to 5,000 images at a time. Official license allows to process unlimited number of images.

</details>

<details>

<summary>How many machines can a license be used for?</summary>

A license can only be used on one machine and cannot be changed after it has been bound.

</details>

<details>

<summary>How to activate online license?</summary>

Log in your Get3D account, get all the historical license information under the account, select the license you need to bind, and then activate it. For detailed steps, please refer to the [License Activation](https://docs.get3d.ai/user-help-center/get3d-mapper/broken-reference) chapter.

</details>

<details>

<summary>How to activate offline license?</summary>

Select the licence mode, copy or export the machine code, convert the machine code to the licence code on the personal center of website, import the licence code and activate it, then you can bind with the machine successfully. For detailed steps, please refer to the [License Activation](https://docs.get3d.ai/user-help-center/get3d-mapper/broken-reference) chapter.

</details>

<details>

<summary>Can I rebound the license to another computer?</summary>

No. Once activated, the license cannot be changed to another computer. If you reinstalled the computer or the computer broke, please [contact us](https://www.get3d.ai/contact) to assist you to renew the license.

</details>

<details>

<summary>How do I view my license information?</summary>

In the software, click Personal Information to view your bound license details.&#x20;

On the website, open the Personal Center and go to the License page to see the status of all your licenses, including purchase date, binding date, and expiration date.

</details>

## Project & Data Import

<details>

<summary>What cameras are supported by Get3D Mapper?</summary>

Get3D Mapper supports images from all perspective RGB cameras.

{% hint style="info" %}

Note: Ensure that the camera has a fixed focal length.
{% endhint %}

</details>

<details>

<summary>How many images I can process in one project?</summary>

For trial license, the number of images in each project cannot exceed 5,000. For official license, there's no limit to the image count in one project.

{% hint style="info" %}
Note: It's recommended limiting a single AT job to no more than 200,000 images.
{% endhint %}

</details>

<details>

<summary>How to use pose file?</summary>

If photos do not contain EXIF information, a pose file is required to provide their positions. Please refer to the [Photo Positioning](https://docs.get3d.ai/user-help-center/get3d-mapper/broken-reference) section for instructions on using a pose file.

</details>

## Aerial Triangulation (AT)

<details>

<summary>What's the difference between Relative Orientation and Absolute Orientation?</summary>

Relative Orientation utilizes the camera's initial internal orientation elements and the relationship between correspondence points to recover the camera’s position and orientation in the relative coordinate system, along with camera’s internal parameters, distortion, and object space point coordinate.

Absolute Orientation converts the relative local coordinate system into the absolute world coordinate system using results from the relative orientation and ground control points.

</details>

<details>

<summary>Where can I find the report for AT result?</summary>

After AT is completed, click View AT Report to view and export the AT report, which includes total processing time, camera information, pose and tie point details, control point information, and more.

</details>

<details>

<summary>How to merge data from different blocks?</summary>

Without field GCPs: Mark several tie points in block1\_AT (within the overlap area) and use these points as control points in block2\_AT. After marking them, submit AT again for block2\_AT to generate block2\_AT\_absAT. Merge block1\_AT and block2\_AT\_absAT into a single block, then submit reconstruction for the new block.&#x20;

With field GCPs: Ensure there are enough control points in the overlap area, especially at the edges. Edit these control points for both block\_AT datasets. Then, submit AT again for both blocks to obtain two block\_AT\_absAT. Merge them into a single block and submit reconstruction for the new block.

</details>

<details>

<summary>Can I delete some tie points?</summary>

In the AT 3D view, you can delete tie points by selecting them with a selection box, or by importing a KML vector file to remove points.

</details>

<details>

<summary>Why does AT run on only one engine in cluster mode?</summary>

The final stage of AT merging bundle requires only one node to run.

</details>

<details>

<summary>How to reuse AT result?</summary>

Within the same project, a single AT block can be used to generate multiple reconstruction products, or the AT can be duplicated for a new reconstruction.&#x20;

The software also allows exporting AT results, which can be imported into a new project’s AT block for further use.

</details>

## Edit GCP

<details>

<summary>How can I use GCP in Get3D Mapper?</summary>

Using control points for absolute orientation can improve result accuracy. After relative orientation in large-scale image AT, edit the control points and then submit absolute AT.

Please refer[ Edit GCP](https://docs.get3d.ai/user-help-center/get3d-mapper/getting-started/edit-control-points) section for detailed steps.

</details>

<details>

<summary>How many times should I mark for one GCP?</summary>

For optimal accuracy, it is recommended to mark approximately <mark style="color:purple;background-color:purple;">30</mark> photos per control point.

</details>

<details>

<summary>Where can I find the accuracy information after editing GCP?</summary>

After editing the control points and completing absolute orientation, you can view control point error information in the Control Points panel within the control point editing view, or check the error details for each point in the Control Points section of the AT report.

</details>

## Reconstruction

<details>

<summary>Why can't I use the WGS 84 coordinate system for output?</summary>

WGS84 is an ellipsoidal coordinate system, and the software supports only planar projected coordinate systems.

</details>

<details>

<summary>What are the output formats of mesh?</summary>

The software supports output only in OSGB and OBJ formats.&#x20;

{% hint style="info" %}
If SLPK or 3D Tiles are required, please use the [format conversion](https://docs.get3d.ai/get3d-viewer/software-overview/tools-menu#convert-format) feature in Get3D Viewer to export the corresponding files.
{% endhint %}

</details>

<details>

<summary>How to export model result?</summary>

After processing is completed, the results are saved directly in the project folder. Click Open Output Directory to view the outputs.

</details>

<details>

<summary>How to browse model?</summary>

After processing 3D Modeling, you can browse model directly if you have installed Get3D Viewer.

</details>

<details>

<summary>How to merge DOM/DSM result?</summary>

DOM/DSM are output as tiles to avoid reconstruction failures caused by insufficient computer resources when handling large datasets.&#x20;

After 2D reconstruction is completed, you can use the Merge tool in the toolbar to combine the DOM/DSM tiles into a complete TIFF output.

</details>

<details>

<summary>What is the difference between DOM/DSM results in 2D reconstruction and 3D reconstruction?</summary>

In 2D reconstruction, the DSM is generated based on image AT, and the DOM is produced by orthorectifying nadir images, without generating a mesh.&#x20;

In 3D reconstruction, the results are generated by projection onto a mesh and can only be used after the mesh has been created.

</details>

## Cluster

<details>

<summary>Does cluster number have limitation?</summary>

There's no limit to cluster number.

</details>

<details>

<summary>How to build cluster and connect the computer?</summary>

Please refer [Cluster Computing](https://docs.get3d.ai/user-help-center/get3d-mapper/cluster-mode/cluster-computing) section for detailed steps.

</details>

## Other

<details>

<summary>How to resume process?</summary>

Cache files for each processing stage are stored in the project directory. If the project is closed without canceling the job, the engine will continue processing tasks in the background.&#x20;

If both the project and engine exit unexpectedly, reopening the software and restarting the engine will resume task processing.&#x20;

If a job is canceled and then resubmitted, the software will reuse existing cache files and does not require reprocessing.

</details>
