ArcGIS Drone2Map

Troubleshooting common Drone2Map issues

Drone2Map workflows are designed to be easy and intuitive, but that doesn’t mean you never run into potential issues. The software takes some high-level concepts and distills it down into simple workflows. For this reason, when you do experience a problem it may not be clearly visible or noted. Below are some common issues that you may run into when working in Drone2Map 2022.1.

Uncalibrated images

Having good overlap and overall coverage with your project images is key to avoiding the presence of uncalibrated images. If large numbers of your images are being marked as uncalibrated during the initial block adjustment, then there are a few potential causes. The most likely causes are the subject matter being too homogenous (i.e. vegetation) or overlap between images is too low with their immediate neighboring images to provide adequate reconstruction.

One way to potentially fix homogenous uncalibrated images is to increase the image scale that the tie points are generated. By default, Drone2Map uses an initial image scale of 1/8 (Eighth image size). If an image is dropped during the free network adjustment, it is not used during the refinement process. Modifying the Initial Image Scale value to 1 (Original image size) will help improve tie point generation and lead to more consistent matches between images.

Tie point options
Available image size options for extracting tie points.

Overlap problems typically are caused by poor flight conditions or flight planning. One way to potentially salvage the data is to increase the size of the image neighborhood that Drone2Map will use to find matching neighboring images. This can be done through the Processing Options Adjust Images section. The setting for Matching Neighborhood handles what size of a neighborhood the adjustment will use when finding neighboring images. Increasing this setting from Small (Optimized) to Medium or Large will increase the number of candidates for tie points between neighboring images.

Flight path showing uncalibrated image points
Project adjusted using the small matching neighborhood setting, resulting in multiple uncalibrated images.
Flight path showing calibrated image points
Project adjusted with the large matching neighborhood setting. Uncalibrated images are now calibrated.

If these suggestions do not help, then the problem is more than likely the flight itself. The project will have to be re-flown with proper flight planning guidelines. For flight recommendations see the following blog: Drone2Map flight planning

Poor reconstruction of waterbodies or features

Water by nature can be quite turbulent and reflective. Therefore, it is notoriously hard to derive feature points between drone images where much of the image is of water. Attempting to process these images in photogrammetry software can sometimes cause the water body areas in the orthomosaic to have artifacts and display as patchy, discolored, or jagged areas.

Waterbody reconstruction issues
Imagery consisting mostly of water may have difficulty reconstructing.
A waterbody mask being drawn
Drawing a waterbody polygon area to mask an area of poor water reconstruction.

When this happens in a Drone2Map project and if you have an advanced license, you can attempt to correct the erroneous areas by applying a waterbody mask. This functionality can be found on the Home tab under the Pre-Processing tools group. A waterbody mask can either be drawn as a polygon or imported from a polygon feature class over the area experiencing reconstruction problems. When the processing is re-run the waterbody mask area will be interpolated to smooth the area.

Results of a waterbody mask
Results of using a waterbody mask to interpolate and clean up poor reconstruction of water areas.

In addition to the waterbody mask, with an advanced license you can use the correction feature tool. This tool allows you to define a polygon over an area that may have reconstructed poorly so it can be re-processed in higher detail. It can be very useful for when most of your project came out as expected but a feature you may have wanted to highlight needs more definition. Currently, the correction features tool is only intended for use with orthomosaic products. For more information on how this functionality works see: Use correction features

Correction feature being used
Correction feature tool being used to improve reconstruction.

Both the waterbody mask and correction features tools work on the concept of tile based processing. Orthomosaics are initially generated as tiles, then mosaicked together to give you seamless products. Which is helpful because Drone2Map can then select and re-process only the tiles that overlap with the polygon features that you have drawn. This method drastically cuts down on processing times and allows for faster turnaround when running quality control on your projects. Backups are also created each time you process so that you can revert back if not fully satisfied with the results.

Project backup location
Backups are created when re-processing products.

Drone2Map offline license problems

Drone2Map can be taken offline for working in the field or areas without internet access. However, in some instances you may have trouble with ArcGIS Online checking back in your Drone2Map license. In this case, there may be many different causes for the problem. Some of the most common include but are not limited to:

Consider if significant changes such as those above were made to the given machine while the license was taken offline. If you cannot troubleshoot the issue on your own it is highly recommended to reach out to Esri Technical Support. Key information to have on hand would include: the specific error you are seeing, a copy of your D2M.log file (C:\Users\<USERNAME>\AppData\Local\Drone2Map\log\D2M.log), and your ArcGIS Online subscription ID.

Vertical alignment issues

If you see that your output products are not matching up with the elevation surface when viewing them in a map or scene then the most likely culprit is your flights vertical accuracy. Many popular drone models do not consistently record accurate altitude information during a flight. The vertical GPS data from a drone can be off by as much as 9 meters at times. This is often the main cause of most vertical alignment issues seen in Drone2Map.

One way to attempt correcting poor vertical accuracy is to use Ground Control Points (GCPs). It is always good practice to be collecting GCPs with each flight project if possible. If you frequently find your products are appearing above or below the elevation surface when viewing them within a map or scene, then GCPs will help align the heights properly. When you import ground control points into Drone2Map each point should have a pre-recorded height or elevation value. By linking images together using those GCPs and running your processing, the software will adjust the output products to the same elevation of the GCPs.

3D product appearing above the ground
Vertical offset from the elevation layer with a 3D mesh.
3D product appearing on the ground
No vertical offset from elevation layer after Ground Control Points (GCP's) are used in adjustment.

Even if you did not have the chance to collect GCPs within the field for that given project you can still create GCPs. Drone2Map allows you to create GCPs based off the basemap. While this is not going to be close to the accuracy you will receive by collecting ground control points in the field, it can still help with adjusting products to align with the ground surface. This is just one possible option to explore in correcting vertical issues, for more information on other solutions see: Having a bad case of vertigo

Creating GCP links
Manually creating links between images for GCP's.

Products not creating or getting errors

Drone2Map records a processing log for each project. This processing log can be accessed in real-time from the Home tabs Log button. By default, the processing log is set to the Info logging level. There are three levels of logging that you can configure.

Info – Provides a stripped-down information log of all the major steps during processing

Trace – Similar to the Info log, but with additional information during steps to narrow down problems

Debug – The most verbose logging level, allows you to see in fine detail all steps of a projects processing.

The logging level can be changed by going to the Project tab> Settings> General. It is important to understand that processing logs are created and stored on a project level. However, there is a main processing log for Drone2Map that records all processing regardless of project. The two logs will be found at the respective paths:

Project log – C:\Users\<USERNAME>\Documents\Drone2Map\Projects\<PROJECT_NAME>\Project\Logs\ProjectLog.log

Software log – C:\Users\<USERNAME>\AppData\Local\Drone2Map\log\D2M.log

Drone2Map processing log
Drone2Map logs provide valuable insight to all stages of processing.

The processing logs are highly useful for narrowing down the cause of any processing issues you may encounter. Generally, there is an error message depending on where the processing failed that provides a clue as to the source of the problem. It is highly recommended to familiarize yourself with the processing logs so if an issue does arise you can provide it readily to our Technical Support team for analysis.

About the authors

Mark Barker

Mark is a Product Engineer for the Drone2Map team, with interests in remote sensing, technical writing, and graphic design. He is a California native and started his Esri journey in 2016.

Mark Buie is a Product Engineer on the ArcGIS Drone2Map team.

Notify of
Inline Feedbacks
View all comments

Next Article

Announcing the New Esri Environment Basemap

Read this article