Create Ortho Corrected Raster Dataset (Data Management)
Summary
Creates an orthocorrected raster dataset using the rational polynomial coefficients (RPC) associated with a raster dataset.
Usage
-
To orthocorrect 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 orthocorrection process so that the elevation and curvatures of the earth can be taken into account.
-
If a DEM is used to orthocorrect the raster dataset, the constant elevation value will not be used.
-
You can save your output to BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.
-
Check the Geoid parameter if you would like the orthocorrection process to assume the earth is a geoid.
Syntax
| Parameter | Explanation | Data 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:
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.
| 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. | 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.
| Boolean |
Code Sample
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")
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()