Skip to main content

Error Code Reference

Overview​

MipMapEngine SDK uses a standardized error code system to help developers quickly locate and resolve issues. Error codes are divided into multiple categories, including reconstruction interface errors, license errors, file I/O errors, and GPU errors.

Reconstruction Interface Error Codes (ReconstructFull/ReconstructAT/Reconstruct3D)​

Core Logic Class​

Error CodeDescription
0Reconstruction successful
1000Reconstruction failed, parse log for reason
1001User cancelled
1002Coordinate system error
1003AT result is empty
1004Point cloud result is empty
1005Mesh result is empty
1006Insufficient nadir images, cannot generate 2D products

License Class​

Error CodeDescription
2000License error
2001Failed to enumerate license
2002No matching license found
2003License has expired
2004License not applicable for this version
2005License feature module mismatch
2006Exceeded maximum image count supported by license

File I/O Class​

Error CodeDescription
3000File read/write error
3001JSON field parsing error

Computing Device Driver Class​

Error CodeDescription
4000GPU device error, check if GPU is NVIDIA and driver version meets requirements

License Engine Error Codes​

Error CodeDescription
0Success
0x00000040Network error
0x0000004ANetwork request timeout
0x05000004Server not found
0x13000051License requires online activation
0x02000003Connection failed, Virbox software not installed or not connected to network
0x51005001Exception occurred when querying authorization code status
0x51005002Exception occurred during authorization code exchange request
0x51005003Authorization code does not exist
0x51005004Authorization code license deduction failed
0x51005013Cannot bind (license has expired)
0x51005014Cannot bind (concurrent device limit reached for authorization code)
0x51005015Cannot bind (cumulative device limit reached for authorization code)
0x51005018Authorization code terminal unbind failed, please contact software supplier
0x51005019Server cannot find binding record, please contact software supplier
0x51005021Authorization code license cannot be bound because license is locked, please contact software supplier
0x51005025Authorization code does not allow binding
0x51005033Temporarily unable to activate license, user tool needs to be upgraded to latest version
0x51005034Software supplier has revoked usage rights for this device, current authorization code cannot bind again, please contact software supplier
0x5100612FAuthorization code does not exist, please confirm if authorization code is correct
0x51006130Invalid hardware information data
0x51006134Authorization code license deduction failed, please contact software supplier
0x5100502CCannot unbind (not bound)

Error Diagnosis Flow​

Common Solutions​

License Errors (2000-2006)​

  1. Check license status:

    license_engine -enum

  2. Verify license expiration:

    license_engine -query

  3. Update license:

    • Contact software supplier for new authorization code
    • Use license activation tool to update

GPU Errors (4000)​

  1. Check GPU driver:

    nvidia-smi

  2. Update driver:

    • Download latest NVIDIA driver
    • Ensure driver version >= 470.xx

  3. Verify CUDA:

    nvcc --version

File I/O Errors (3000-3001)​

  1. Check permissions:

    ls -la /path/to/file
    chmod 755 /path/to/file

  2. Verify JSON format:

    task_json_check.exe -task_json config.json

  3. Check disk space:

    df -h

Error Prevention Best Practices​

  1. Pre-flight checks:

    • Verify license before reconstruction
    • Check GPU availability and memory
    • Validate input data quality

  2. Monitoring:

    • Monitor GPU memory usage
    • Track reconstruction progress
    • Check log files regularly

  3. Resource management:

    • Ensure sufficient disk space (>3x input data size)
    • Keep GPU memory available (>4GB recommended)
    • Close unnecessary applications

  4. Data validation:

    • Use proper image overlap (60-80%)
    • Verify GPS/EXIF data accuracy
    • Check coordinate system consistency