Processing options

In Drone2Map, you can adjust the processing options for a project to customize it. You can run steps independently, minimizing the time required to generate the desired products; however, you must run the initial step at least once.

Use the Processing Options window to configure which steps will run, the settings for each step, and which products will be created. To open the window, on the ribbon, on the Home tab, in the Processing group, click Options.

General

On the General tab, options are provided that allow you to adjust the quality and resolution of output products. You can also save intermediate outputs and define how much processing power is used when generating those products.

• Dense Matching
  • Point Cloud Density—Density of the point cloud used to derive the level of geometric detail of the resulting reconstruction. Increasing this value improves edge sharpness of features and increases processing time. Generally, point cloud densities below High should only be used for rapid assessment and testing. To prevent the point cloud from becoming too sparse, it is recommended that you increase the GSD resolution in 2D Processing, as the point cloud density is decreased.

    Note:

    Point cloud settings are tied to the selected Project Resolution setting. See the next section for more details.

    • Ultra—Highest level of density point cloud. Use for final products that require the highest detail possible.
    • High—High level of density point cloud. This is the recommended setting for most projects. This is the default.
    • Medium—Medium level of density point cloud. It is suitable for quick projects or testing.
    • Low—Low level of density point cloud. This is typically used only for rough testing.
• Project Resolution—Defines the spatial resolution used to generate output products.
  • Automatic (default)—Uses the resolution of your source imagery. Changing this value changes the resolution by multiples of the ground sample distance (GSD).
    • 1x (default)—Recommended image scale value. This scale allows the selection of the Ultra or High point cloud settings.
    • 4x—Recommended for very large projects with high overlap, 4x Source Resolution can be used to speed up processing, which often results in slightly reduced accuracy, as fewer features are extracted. This scale is also recommended for very blurry or very low-textured images. This scale defaults to the Medium point cloud setting.
    • 8x—For very large projects with high overlap, 8x Source Resolution can be used to speed up processing, which usually results in slightly reduced accuracy, as fewer features are extracted. This scale defaults to the Low point cloud setting.
  • User Defined—A resolution value can be manually defined in centimeters or pixels for the GSD. This scale allows the selection of the Ultra or High point cloud settings.

• Keep Intermediate Products—Defines whether any intermediate products should be kept after processing completes.
  • DSM Point Cloud—Allows you to choose whether to keep DSM point cloud files.
  • True Ortho/Orthomosaic Tiles—Allows you to choose whether to keep ortho image tile files.
  • 3D Point Cloud—Allows you to choose whether to keep 3D point cloud files.

• Hardware—Configure CPU and GPU hardware options.
  • CPU Threads—The number of central processing unit (CPU) threads dedicated to processing your project. Slide the bar to the left or right to adjust the number of CPU threads.
  • Processor Type—Allows you to define how image processing is offloaded to the computer's hardware.
    • CPU + GPU (default)—Processing is performed by both the CPU and GPU.
    • CPU—Processing is restricted to the CPU only.
    • GPU ID—Define a specific GPU ID to use for multi-GPU systems.

Adjust Images

On the Adjust Images tab, the options allow you to define key adjustments to be used in the block adjustment process, tie point matching, and point cloud generation.

• Fix Image Location for High Accuracy GPS (RTK and PPK)—When enabled, this option changes the Matching Neighborhood setting to Small (Optimized). This option is used only for imagery acquired with high-accuracy, differential GPS, such as Real Time Kinematic (RTK) or Post Processing Kinematic (PPK). If this option is checked, the process only adjusts the orientation parameters of the imagery and leaves the GPS measurements fixed. Using GCPs in conjunction with fixed GPS measurements may overconstrain the bundle adjustment, introducing errors or causing processing to fail. When using GCPs with RTK or PPK imagery, it is recommended that you set Matching Neighborhood to Medium.

  Note:

  If a high number of uncalibrated images appear, changing Matching Neighborhood to a larger setting increases the likelihood of those images being calibrated, but it may increase processing time.

• Use Image Orientations—When enabled, the orientation data from the source images is used and the initial orientation adjustment during the Adjust Images step is skipped. This option can be used when yaw, pitch, and roll are present in the image metadata, or Omega, Phi, Kappa values are imported from an external geolocation file. Instead of the AT calculating the initial orientation, Drone2Map will use the Yaw, Pitch, and Roll of the images to calculate the initial orientation of the imagery.

  Note:

  If orientation information (yaw, pitch, roll or omega, phi, kappa) is present in the images, Drone2Map will automatically enable this option. The orientation information from the images will then be used for the Initial orientation adjustment processing. This reduces processing during the Adjust Images step, decreasing processing time.

• Initial Image Scale—This controls the way feature points are extracted. The project adjusts the value by default based on the template you chose when creating the project, 2D Products (1x) or Rapid (4x). More tie points are generated when the setting is closer to source resolution (1x), but the processing time also increases accordingly.
  • 1 (Original image size)—Recommended image scale value.
  • 1/2 (Half image size)—Recommended for projects using small images (for example, 640x320 pixels), because more features will be extracted, and it will assist with the accuracy of results.
  • 1/4 (Quarter image size)—Recommended for very large projects with high overlap, 4x Source Resolution can be used to speed up processing, which often results in slightly reduced accuracy, as fewer features are extracted. This scale is also recommended for very blurry or very low textured images.
  • 1/8 (Eighth image size)—For very large projects with high overlap, 8x Source Resolution can be used to speed up processing, which usually results in slightly reduced accuracy, as fewer features are extracted.
• Refine Adjustment—Specifies whether the camera model is further optimized using the selected image scale. If the Initial Image Scale image size is already at 1, there is no additional benefit. It is always advisable to have Refine Adjustment checked for final product generation. For doing quick quality adjustments, you can uncheck the setting.
  • Checked—The camera model is first estimated using the Initial Image Scale setting and further optimized using the selected image scale. This option produces the most accurate results.
  • Unchecked—The camera model is estimated using the Initial Image Scale setting with no additional optimization. This option produces the fastest results but may be less accurate.
  • 1 (Original image size)—Adjustment is performed at the original image size. This is the recommended image size.
  • 2 (Double image size)—Adjustment is performed at double the image size. This size is recommended for projects using small images (for example, 640x320 pixels), because more features are extracted, which increases the accuracy of the results.
• Tie Point Residual Error Threshold—Tie points with a residual error greater than the threshold value are not used in computing the adjustment. The measurement unit of the residual is pixels.
• Matching Neighborhood—Determines the number of images from each search neighborhood that are used to compute image matches. A search neighborhood is the area between each of the four ordinal directions (NE, SE, SW, and NW). Larger neighborhood sizes increase processing times, but they also increase matches with neighboring images. If a high number of uncalibrated images is detected during initial adjustment, it is recommended that you increase the neighborhood size. Otherwise, use the default settings.
  • Small (Optimized)—An image is matched to the three closest images for each search neighborhood, a total of 9.
  • Medium—An image is matched to the six closest images for each search neighborhood, a total of 24.
  • Large—An image is matched to the 12 closest images for each search neighborhood, a total of 48.
  • X-Large (Slowest)—An image is matched to the 20 closest images for each search neighborhood, a total of 80.
• Camera Calibration—Internal camera parameters used for image adjustment. If checked, the value is automatically taken from the Edit Camera pane. If a value is missing, the initial value is then calculated from the EXIF data. If unchecked, the calibration is fixed to whatever values are manually defined in the Edit Camera pane.
  • Focal Length—The focal length of the camera lens, measured in millimeters.
  • Principal Point—The offset between the fiducial center and the principal point of autocollimation (PPA). The principal point of symmetry (PPS) is assumed to be the same as the PPA.
  • K1,K2,K3—Konrady coefficients to calculate radial distortion.
  • P1,P2—Tangential coefficients to calculate distortion between the lens and image plane.
• General Adjust Options—General options used in the adjustment step.
  • Include True Ortho preview in processing report—If checked, a preview image of the True Ortho product is added to the top of the processing report that is generated in the adjustment step.

2D products

On the 2D Products tab, the following options allow you to adjust the processing options and desired outputs for orthomosaic, True Ortho, digital surface model (DSM), and digital terrain model (DTM) images:

• Image Collection—Defines the options for the Image Collection mosaic product.
  • Orthorectification Method—Elevation source used to orthorectify the mosaicked images.
    • None—No elevation source is used.
    • Solution Points—Elevation source created from solution points generated during adjustment.
    • Sparse Point Cloud—Elevation source created from a point cloud derived from the image collection.
    • Dense Point Cloud—Elevation source created from a dense matching point cloud.

      Note:

      To use the Dense Point Cloud option, a DSM product must first be present.

  • Color Balancing—Make transitions from one image to an adjoining image appear seamless.
  • Seamlines—Sort overlapping imagery and produce a smoother-looking mosaic.

• Create Orthomosaic—Generates an orthomosaic from the project's images.
• Create True Ortho—Generates an True Ortho from the project's images. True Ortho products are high-resolution full nadir ortho images.
  • Color Balancing—Blends differences between images and removes or reduces artifacts along seams.
  • Enhance True Ortho—Brightens dark areas, makes True Orthos more vibrant and homogeneous, and leaves the input of the images unchanged.
  • Merge Tiles—When checked, merges the tiles into a single True Ortho image. When unchecked, it creates a mosaic dataset of your tiles that can be used in tile-based processing.
• Create DSM—Generates a DSM from the project images.
  • Create Shaded Relief—Generates a shaded relief using the DSM.
    • Hillshade Type—Controls the illumination source for the hillshade.
      • Traditional—Calculates hillshade from a single illumination direction. You can set the Azimuth and Altitude options to control the direction of the light source.
      • Multidirectional—Combines light from multiple sources to represent an enhanced visualization of the terrain.
    • Azimuth—Azimuth is the sun's relative position along the horizon (in degrees). An azimuth of 0 degrees indicates north., east is 90 degrees, south is 180 degrees, and west is 270 degrees.
    • Altitude—Altitude is the sun's angle of elevation above the horizon and ranges from 0 to 90 degrees. A value of 0 degrees indicates that the sun is on the horizon, that is, on the same horizontal plane as the frame of reference. A value of 90 degrees indicates that the sun is directly overhead.
    • Z Factor—The Z-Factor is a scaling factor used to convert the elevation values for two purposes: To covert the elevation units (such as meters or feet) to the horizontal coordinate units of the dataset, which may be feet, meters or degrees. To add vertical exaggeration for visual effect.
• Create Contours—Generates contour lines using the DSM.
  • Contour Interval—Defines the contour line elevation interval in meters. It can be any positive value. The elevation interval must be smaller than the (maximum–minimum) altitude of the DSM.
  • Contour Base—Defines the relative altitude, which is used as a contour line base in meters.
  • Contour Z Factor—The contour lines are generated based on the z-values in the input raster, which are often measured in units of meters or feet. With the default value of 1, the contours will be in the same units as the z-values of the input raster. To create contours in a different unit than that of the z-values, set an appropriate value for the z-factor. Note that it is not necessary that the ground x,y and surface z-units be consistent for this tool. For example, if the elevation values in your input raster are in feet, but you want the contours to be generated based on units of meters, set the z-factor to 0.3048 (1 foot = 0.3048 meters).
  • Export Shapefile—Exports contour lines in shapefile format.
• Create DTM—Generates a DTM from the project images.
  • Create Shaded Relief—Generates a shaded relief using the DTM.
    • Hillshade Type—Controls the illumination source for the hillshade.
      • Traditional—Calculates hillshade from a single illumination direction. You can set the Azimuth and Altitude options to control the direction of the light source.
      • Multidirectional—Combines light from multiple sources to represent an enhanced visualization of the terrain.
    • Azimuth—Azimuth is the sun's relative position along the horizon (in degrees). An azimuth of 0 degrees indicates north., east is 90 degrees, south is 180 degrees, and west is 270 degrees.
    • Altitude—Altitude is the sun's angle of elevation above the horizon and ranges from 0 to 90 degrees. A value of 0 degrees indicates that the sun is on the horizon, that is, on the same horizontal plane as the frame of reference. A value of 90 degrees indicates that the sun is directly overhead.
    • Z Factor—The Z-Factor is a scaling factor used to convert the elevation values for two purposes: To covert the elevation units (such as meters or feet) to the horizontal coordinate units of the dataset, which may be feet, meters or degrees. To add vertical exaggeration for visual effect.
  • Create Contours—Generates contour lines using the DTM.
    • Contour Interval—Defines the contour line elevation interval in meters. It can be any positive value. The elevation interval must be smaller than the (maximum–minimum) altitude of the DTM.
    • Contour Base—Defines the relative altitude, which is used as a contour line base in meters.
    • Contour Z Factor—The contour lines are generated based on the z-values in the input raster, which are often measured in units of meters or feet. With the default value of 1, the contours will be in the same units as the z-values of the input raster. To create contours in a different unit than that of the z-values, set an appropriate value for the z-factor. Note that it is not necessary to have the ground x,y and surface z-units be consistent for this tool. For example, if the elevation values in your input raster are in feet, but you want the contours to be generated based on units of meters, set the z-factor to 0.3048 (since 1 foot = 0.3048 meter).
    • Export Shapefile—Exports contour lines in shapefile format.

3D products

Note:

3D processing capabilities are included with an ArcGIS Drone2Map Advanced license. See Drone2Map license levels.

On the 3D Products tab, these options allow you to change the outputs for the point cloud and 3D textured mesh created in this step.

• Create Point Clouds—Allows you to select the output formats for the point cloud. The options are as follows:
  • SLPK—Creates a scene layer package (.slpk file).
  • LAS—Creates a lidar LAS file with x,y,z position and color information for each point of the point cloud.
  • Merge LAS Tiles—Merges LAS tiles into a single LAS file instead of the default individual LAS tile files.
• Create DSM Textured Meshes—Allows you to generate 3D meshes from DSM data with an imagery overlay.
  • SLPK—Creates a scene layer package (.slpk file).
  • DAE—Converts DSM data into a .dae (COLLADA) file.
  • OBJ—Converts DSM data into an .obj (Wavefront) file.
  • OSGB—Converts DSM data into an .osgb (OpenSceneGraph binary) file.
  • 3D Tiles—Converts point cloud data into .b3dm (3D Tiles) files.
• Create 3D Textured Meshes—Allows you to generate 3D meshes from point cloud data with an imagery overlay.

  Note:

  The densified point cloud is used to generate a surface composed of triangles. It uses the points to minimize the distance between the points and the surface that they define, but the vertices of the triangles are not necessarily an exact point of the densified point cloud.

  • SLPK—Creates a scene layer package (.slpk file).
  • DAE—Converts point cloud data into a .dae (COLLADA) file.
  • OBJ—Converts point cloud data into an .obj (Wavefront) file.
  • OSGB—Converts point cloud data into an .osgb (OpenSceneGraph binary) file.
  • 3D Tiles—Converts point cloud data into .b3dm (3D Tiles) files.
• General Mesh Settings—Allows you to configure additional mesh quality settings.
  • Enhance Textured Mesh—Brightens dark areas and makes textured meshes more vibrant and homogeneous.
  • 3D Tiles Over-impose Heights on Target Ellipse—Sets the height values of 3D Tiles to use the vertical coordinate system of the project.

Coordinate systems

On the Coordinate systems tab, the following options define the horizontal and vertical coordinate system for your images and the project.

• Image Coordinate System—Defines the spatial reference for your images.
  • Current XY—Defines the horizontal coordinate system for your images. The default horizontal coordinate system for images is WGS84. To update the image horizontal coordinate system, click the coordinate system button to select the appropriate coordinate system, and click OK.
  • Current Z—Defines the vertical reference for your images. The default vertical reference is EGM96 for images. Most image heights are referenced to the EGM96 geoid and are either embedded in the EXIF header of the image or are contained in a separate file. Most GPS receivers convert the WGS84 ellipsoidal heights provided by global navigation satellites to EGM96 heights, so if you're unsure, accept the default of EGM96.
• Project Coordinate System—Defines an output spatial reference for your Drone2Map output products.

  Note:

  You can only modify project coordinate system and vertical reference if control points are not included in the project. If you have control points, the project coordinate system and vertical reference of Drone2Map are determined by the coordinate system and vertical reference of the control points.

  If you don't have control points, the coordinate system and vertical reference model used in the creation of Drone2Map are determined by the coordinate system and vertical reference of the images themselves. If the images have a geographic coordinate system, Drone2Map generates products using the local WGS84 UTM Zone.

  • Current XY—Defines the output horizontal coordinate system. To update the project coordinate system, click the Set Horizontal and Vertical Spatial Reference button to select the appropriate projected coordinate system, and click OK. If you select a geographic coordinate system, Drone2Map generates products using the local WGS84 UTM zone.
  • Current Z—Defines the output vertical reference system for your Drone2Map products. This is relevant if your input images contain ellipsoidal heights and you plan to publish a 3D mesh as a scene layer, since ArcGIS Online and ArcGIS Pro both use the orthometric EGM96 geoid height model. EGM96 is the default.

Resources

On the Resources tab, you can view project image information and relevant project paths.

• Image Information—Information about the number of images and total gigapixels in the current project.
  • Enabled Images—Total number of images with a status of Enabled to be used in processing.
  • Gigapixels—Number of gigapixels used in the current project. See the note below for more information.

Note:

Combined project imagery size is limited to 300 gigapixels for an Advanced license and 100 gigapixels for a Standard license. Calculate the size by multiplying the number of images by image megapixel size and dividing by 1,000.

For example, a project with 400 13-megapixel imagery is (400 x 13)/1000 = 5.2 gigapixels.

• Locations—File path locations of the project file, source images, and project log file.
  • Project—The location of the current project in the file system. Click the link to open the file location.
  • Images—The location of the source images used in processing the current project. Click the link to open the image location.
  • Log File—The location of the project log file. Click the link to open the file location. This file is useful when troubleshooting issues with Drone2Map.
  • Delete Logs—Delete all project logs for the current open project.

Project Data

The Project Data tab allows you to quickly reset various project processing steps and options. It also allows you to delete specific layers and products.

• Reset Options—Reset processing options to the original state at project creation.
  • Toggle All Entries —Turns on or off all options in the section.
  • General—Resets all processing options on the General tab to the template defaults.
  • Adjust Images—Resets all processing options on the Adjust Images tab to the template defaults.
  • 2D Products—Resets all processing options on the 2D Products tab to the template defaults.
  • 3D Products—Resets all processing options on the 3D Products tab to the template defaults.

• Reset Processing Steps—Turns on options to reset processing steps to an unprocessed state. Processing steps that depend on another processing step are reset together.
  • Toggle All Entries —Turns on or off all options in the section.
  • Mosaic Dataset—Resets all processing steps for mosaic dataset generation. Checking this option also resets the Adjust Images and Dense Matching steps.
  • Adjust Images—Resets all processing steps for Adjust Images. Checking this option also resets Dense Matching.
  • Dense Matching—Resets all processing steps for Dense Matching.
  • True Ortho Tile Processing—Resets tile generation to its original state and forces dense tile matching to run instead.

    Note:

    The True Ortho Tile Processing option is available with an Advanced license and only appears after processing of an True Ortho has been completed.

• Reset Symbology—Turns on options to reset project layers to their original symbology.
  • Toggle All Entries —Turns on or off all options in the section.
  • Clip Area—Resets the symbology for the Clip Area feature layer.
  • Control—Resets the symbology for the Control feature layer.
  • Flight Data—Resets the symbology for the Flight Data feature layer.
  • Pre-Processing—Resets the symbology for any of the Pre-Processing feature layers.

• Delete Project Data—Turns on options to delete data from the project and file system.
  • Toggle All Entries —Turns on or off all options hin the section.
  • Control—Deletes the Control feature layer from the project and imported ground control points.
  • Elevation Profiles—Deletes the Elevation Profile data and charts from the project.
  • Map Notes—Deletes the Map Notes data from the project.
  • Pre-Processing—Deletes all Pre-Processing data from the project.
  • Processing Report—Deletes the Processing Report from the project.
  • 2D Products—Deletes all 2D output products from the project.
  • 3D Products—Deletes all 3D output products from the project.

Export template

Drone2Map templates are designed to help you get your projects started quickly. The templates are preconfigured with specific processing options based on the template and desired products. You can update the processing options to customize processing settings and outputs. If you have a particular set of custom options that you use frequently, you can export your processing options as a template. Once your processing options are set, in the Options window, select Export Template, browse to the location where you want to save your template, and click Save. When you create your next project, choose your exported template, and your settings and options are loaded into Drone2Map.