Create Ortho Corrected Raster Dataset (Data Management)

License Level:BasicStandardAdvanced

Summary

Creates an orthocorrected raster dataset using the rational polynomial coefficients (RPC) associated with a raster dataset.

Learn more about orthorectifying a raster dataset

Usage

Syntax

createorthocorrectedrasterdataset_management (in_raster, out_raster_dataset, Ortho_type, constant_elevation, {in_DEM_raster}, {ZFactor}, {ZOffset}, {Geoid})
ParameterExplanationData Type
in_raster

The input raster that you want to orthocorrect.

This raster must have rational polynomial coefficients associated with it.

Raster Layer
out_raster_dataset

The output raster dataset.

When storing the raster dataset in a file format, you need to specify the file extension:

  • .bil—Esri BIL
  • .bip—Esri BIP
  • .bmp—BMP
  • .bsq—Esri BSQ
  • .dat—ENVI DAT
  • .gif—GIF
  • .img—ERDAS IMAGINE
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • no extension for Esri Grid

When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset.

When storing your raster dataset to a JPEG file, a JPEG 2000 file, a TIFF file, or a geodatabase, you can specify a compression type and compression quality.

Raster Dataset
Ortho_type

The type of elevation to use in the orthorectification process.

  • CONSTANT_ELEVATIONUses a specified elevation value.
  • DEMUses a specified digital elevation model raster.
String
constant_elevation

The constant elevation value to be used when the ortho_type parameter is CONSTANT_ELEVATION.

If a DEM is used in the orthocorrection process, this value is not used.

Double
in_DEM_raster
(Optional)

The digital elevation model rasterto be used for orthorectification when the ortho_type parameter is DEM.

Mosaic Layer; Raster Layer
ZFactor
(Optional)

The scaling factor used to convert the elevation values in the DEM.

This is used for two purposes: first, to convert the elevation units (such as meters or feet) to the horizontal coordinate units of the dataset, which may be feet, meters, or degrees; and second, to add vertical exaggeration for visual effect.

Learn more about the z factor

Double
ZOffset
(Optional)

The base value to be added to the elevation value in the DEM. This could be used to offset elevation values that do not start at sea level.

Double
Geoid
(Optional)

Indicates if you would like the orthocorrection process to assume the earth is a geoid or a sphere.

  • NONENo geoid correction is made. This is the default.
  • GEOIDA geoid correction will be made. This will apply the geoid (EGM96) correction to the z values.
Boolean

Code Sample

CreateOrthoCorrectedRasterDataset example (Python window)

This is a Python sample for the CreateOrthoCorrectedRasterDataset tool.

import arcpy
arcpy.CreateOrthoCorrectedRasterDataset_management("c:/data/RPCdata.tif",
                                                   "c:/data/orthoready.tif",
                                                   "DEM", "#", "c:/data/DEM.img",
                                                   "#", "10", "GEOID")
CreateOrthoCorrectedRasterDataset example 2 (stand-alone script)

This is a Python script sample for the CreateOrthoCorrectedRasterDataset tool.

##====================================
##Create Ortho Corrected Raster Dataset
##Usage: CreateOrthoCorrectedRasterDataset_management in_raster out_raster_dataset
##                                                    CONSTANT_ELEVATION | DEM constant_ elevation
##                                                    in_DEM_raster {ZFactor} {ZOffset} {NONE | GEOID}

try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"
    
    ##Ortho correct with Constant elevation
    arcpy.CreateOrthoCorrectedRasterDataset_management("ortho.img", "orthoready.tif",\
                                                       "CONSTANT_ELEVATION", "30", "#",\
                                                       "#", "#", "#")
    
    ##Ortho correct with DEM image and Z factors
    arcpy.CreateOrthoCorrectedRasterDataset_management("ortho.img", "orthoready_dem.tif",\
                                                       "DEM", "#", "dem.img", "#", "10", "GEOID")
    
except:
    print "Create Ortho Corrected Raster Dataset example failed."
    print arcpy.GetMessages()

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
11/18/2013