Create Ortho Corrected Raster Dataset (Data Management)

Summary

This tool creates an ortho corrected raster dataset using the rational polynomial coefficients (RPC) associated with a raster dataset.

Learn about orthorectifying a raster dataset

Usage

• To ortho correct a raster dataset, the raster must have RPCs associated with it.

• For a more accurate result, you should use the digital elevation model (DEM) option for elevation. A DEM should be used in the ortho correction process so that the elevation and curvatures of the earth can be taken into account.

• If a DEM is used to ortho correct the raster dataset, the constant elevation value will not be used.

• You can save your output to BIL, BIP, BMP, BSQ, DAT, GIF, GRID, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.

• Check the Geoid parameter if you would like the ortho correction process to assume the Earth is a geoid.

Syntax

createorthocorrectedrasterdataset_management (in_raster, out_raster_dataset, {Ortho_type}, {constant_ elevation}, {in_DEM_raster}, {ZFactor}, {ZOffset}, {Geoid})

Parameter	Explanation	Data Type
in_raster	The input raster dataset that you want to ortho correct. This raster dataset must have rational polynomial coeffients associated with it.	Mosaic Dataset ; Composite Layer ; Raster Dataset ; 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 file .jpg—JPEG .jp2—JPEG 2000 .png—PNG .tif—TIFF no extension—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 (Optional)	The type of elevation to use in the orthorectification process. CONSTANT_ELEVATION —Uses a specified elevation value. DEM —Uses a specified digital elevation model dataset.	String
constant_ elevation (Optional)	The constant elevation value to be used. If a DEM is used in the ortho correction process, this constant elevation is not used.	Double
in_DEM_raster (Optional)	The digital elevation model raster dataset to be used for orthorectification.	Raster layer
ZFactor (Optional)	The scaling factor used to convert the elevation values. This is often used to convert from feet to meters or vice versa.	Double
ZOffset (Optional)	The base value to be added to the elevation value in the DEM.	Double
Geoid (Optional)	Indicates whether a geoid correction is needed. NONE —No geoid correction is made. This is the default. GEOID —A geoid correction will be made.	Boolean

Code Sample

CreateOrthoCorrectedRasterDataset example (Python window)

This is a Python sample for the CreateOrthoCorrectedRasterDataset.

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.

##====================================
##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

Compression, Current Workspace, Output CONFIG Keyword, Output Coordinate System, Extent, Pyramid, Raster Statistics, Scratch Workspace, Snap Raster, Tile Size

Licensing Information

ArcView: Yes

ArcEditor: Yes

ArcInfo: Yes