Reconstruct Surface (Data Management)

This ArcGIS 3.0 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Available with Advanced license.

Summary

Generates DSM orthophotos, 2.5D meshes, 3D meshes, and point clouds from adjusted imagery.

License:

The Reconstruct Surface tool is only available through a limited, invitation-only beta testing release.

Usage

  • The Input Mosaic Dataset parameter value must be preadjusted. For information about block adjustment in ortho mapping, see block adjustment.

  • After the tool has been run, a Project.spr file will be created within the Reconstruction Folder value. If the Reconstruction Folder value is used again, the presence of the Project.spr file will cause the Input Mosaic Dataset parameter to be hidden in the Geoprocessing pane. This allows you to generate additional products without recalculating information from the input mosaic, as it is stored in the Project.spr file. To generate additional products for the same project, run the tool again.

  • If there are changes to the input mosaic dataset, specify a different folder for the Reconstruction Folder value. To generate products that reflect changes to the mosaic dataset, specify this new location and run the tool again.

  • Use the Area of Interest parameter to speed up processing and generate products for a subset of images in the input mosaic.

  • If the Reconstruction Options parameter is specified, the properties of the .json file or JSON string will set the defaults for the remaining optional parameters.

    The following list defines the keywords used by the Reconstruction Options parameter as either a .json file or a JSON string:

    • scenarioβ€”Specifies the type of imagery that will be used to generate the output products.
    • fwdOverlapβ€”The forward (in-strip) overlap percentage between the images. This keyword is used when scenario is set to AERIAL_NADIR.
    • swdOverlapβ€”The sideward (cross-strip) overlap percentage between the images. This keyword is used when scenario is set to AERIAL_NADIR.
    • qualityβ€”Specifies the quality of the final product.
    • productsβ€”Specifies the products to be generated.
    • srsβ€”The geographic coordinate system of a project in WKT format.
    • tileSizeβ€”The tile size. Values can be AUTO or type double.
    • cellSizeβ€”The cell size of the output raster product. This value is automatically estimated, but it can be manually defined. Values can be AUTO or type double.
    • cellSizeMultiplicatorβ€”A cell size scalar value. This value is automatically estimated, but it can be manually defined. Values can be AUTO or type double.
    • areaXβ€”The x-coordinates of the output extent.
    • areaYβ€”The y-coordinates of the output extent.
    • areaZβ€”The z-coordinates of the output extent.
    • areaFeaturesβ€”The area of interest.
    • waterbodyFeaturesβ€”A polygon that specifies the extent of large water bodies.
    • correctionFeaturesβ€”A polygon that specifies the extent of all surfaces that are not water bodies.
    • gpuStatusβ€”A Boolean value that specifies whether the GPU will be used for processing.
    • applyGlobalColorBalancingβ€”A Boolean value that specifies whether color balancing will be applied.
    • orthoEnhanceTextureβ€”A Boolean value that specifies whether textures will be enhanced for DSM ortho products.
    • meshEnahnceTextureβ€”A Boolean value that specifies whether textures will be enhanced for mesh products.
    • force8BitColorβ€”A Boolean value that specifies whether 8-bit color will be used regardless of the input.
    • dsmDepthBufferβ€”An integer value that defines how many of the highest points in a DSM cell will be used to compute the height value for the cell. By default, this value is determined automatically, but the value can also be specified manually.
    • exportAdditionalTFWsβ€”A Boolean value that specifies whether additional .tfw files will be exported.
    • exportImagePyramidsInTIFFsβ€”A Boolean value that specifies whether image pyramids will be exported in .tiff files.
    • dsmMetaProductsβ€”Specifies the DSM meta information products that will be included in the output. Values can include any combination of DSM_CELL_POINT_COUNT, DSM_HEIGHT_COLORED, DSM_POINT_COLOR, DSM_POINT_COLOR_INTERPOLATE, DSM_BINARY_MASK, DSM_DISTANCE_MAP, DSM_POINT_MODEL_COUNT, DSM_CELL_SD, and DSM_ROUGHNESS.
    • meshAndTextureFormatsβ€”Specifies the mesh output format. Only specific combinations of mesh and texture formats are compatible. The supported combinations are listed in the table below. The OSGB and S3TC formats are used by default.

      MeshFileFormatTextureFileFormat

      OSGB

      S3TC

      CESIUM

      JPG and S3TC

      SLPK

      JPG, JPG, and DDS

      LOD_OBJ

      JPG, PNG, and DDS

      LOD_DAE

      JPG, PNG, and DDS

      DAE

      JPG and PNG

      OBJ

      JPG and PNG

    • cesiumOverImposeHeightsOnTargetEllipsoidβ€”A Boolean value that specifies whether all dimensions including the height will be converted to the coordinate system used by Cesium (WGS 84) without any modifications. If this option is False, the height values of the input mesh will be interpreted as heights above the Cesium ellipsoid.
    • cesiumDracoCompressionβ€”A Boolean value that specifies whether the mesh size will be reduced to improve performance.
    • slpkExportInPCSβ€” A Boolean value that specifies whether a coordinate system transformation will be performed for the SLPK mesh format. By default, SURE will convert SLPK mesh results to the WGS 84 coordinate system with EGM96 geoid heights. If True, no coordinate system transformation will be performed for the SLPK mesh format, except where a different coordinate system is required. When this option is True, the WKIDs for the horizontal and vertical coordinate systems and the height model and height unit must be defined.
  • The following is an example of the Reconstruction Options parameter value specified as a .json file:

    {
        "scenario": "AERIAL_NADIR",
        "fwdOverlap": .60,
        "swdOverlap": .30,
        "quality": "HIGH",
        "products": "DSM;TRUE_ORTHO;DSM_MESH",
        "areaX": [424960.019858008, 425010.984614762],
        "areaY": [5132484.30528369, 5132517.9432181],
        "gpuStatus": True,
        "applyGlobalColorBalancing": True,
        "dsmMetaProducts": "DSM_HEIGHT_COLORED;DSM_ROUGHNESS"
    
    }

Parameters

LabelExplanationData Type
Input Mosaic Dataset

The adjusted input mosaic dataset.

Mosaic Dataset; Mosaic Layer
Reconstruction Folder

The output dataset folder.

Folder
Reconstruction Options
(Optional)

A .json file or JSON string that specifies the values for the tool parameters.

If this parameter is specified, the properties of the .json file or JSON string will set the defaults for the remaining optional parameters.

File; String
Scenario
(Optional)

Specifies the type of imagery that will be used to generate the output products.

  • Defaultβ€”The input imagery will be defined as having been acquired with drones or terrestrial cameras.
  • Aerial Nadirβ€”The input imagery will be defined as having been acquired with large, photogrammetric camera systems.
  • Aerial Obliqueβ€”The input imagery will be defined as having been acquired with oblique camera systems.
String
Forward Overlap
(Optional)

The forward (in-strip) overlap percentage that will be used between the images. The default is 60.

This parameter is active when the Scenario parameter is set to Aerial Nadir.

Long
Sideward Overlap
(Optional)

The sideward (cross-strip) overlap percentage that will be used between the images. The default is 30.

This parameter is active when the Scenario parameter is set to Aerial Nadir.

Long
Quality
(Optional)

Specifies the quality of the final product.

  • Ultraβ€”Input images will be used at their original (full) resolution.
  • Highβ€”Input images will be downsampled two times.
  • Mediumβ€”Input images will be downsampled four times.
  • Lowβ€”Input images will be downsampled eight times.
String
Products
(Optional)

Specifies the products that will be generated.

  • DSMβ€”A digital surface model (DSM) will be generated. This product will be selected by default when the Scenario parameter is set to Aerial Nadir.
  • True Orthoβ€”The imagery will be orthorectified. This product will be selected by default when the Scenario parameter is set to Aerial Nadir.
  • DSM Meshβ€”A DSM mesh will be generated. This product will be selected by default when the Scenario parameter is set to Aerial Nadir.
  • Point Cloudβ€”An image point cloud will be generated. This product will be selected by default when the Scenario parameter is set to Default or Aerial Oblique.
  • Meshβ€”A 3D mesh will be generated. This product will be selected by default when the Scenario parameter is set to Default or Aerial Oblique.
String
Cell Size
(Optional)

The cell size of the output product.

Double; String
Area of Interest
(Optional)

The area of interest that will be used to select images for processing. The area of interest can be computed automatically or defined using an input shapefile.

If the value contains 3D geometries, the z-component will be ignored. If the value includes overlapping features, the union of these features will be computed.

  • Noneβ€”All images will be used in processing.
  • Autoβ€”The processing extent will be calculated automatically. This is the default.
Feature Class; Feature Layer; File; String
Waterbody Features
(Optional)

A polygon that will define the extent of large water bodies. For the best results, use a 3D shapefile.

Feature Class; Feature Layer; File; String
Correction Features
(Optional)

A polygon that will define the extent of all surfaces that are not water bodies. The value must be a 3D shapefile.

Feature Class; Feature Layer; File; String

Derived Output

LabelExplanationData Type
Updated Reconstruction Folder

The output reconstruction folder.

Folder

Environments

Licensing information

  • Basic: No
  • Standard: Requires Reality Mapping
  • Advanced: Requires Reality Mapping

Related topics