Create Oriented Imagery Dataset (Oriented Imagery)

Summary

Creates an empty oriented imagery dataset in a geodatabase.

Usage

• The fields, domains, subtypes, and attribute rules of the template datasets transfer to the oriented imagery dataset. The tool ignores any fields with the same names as the oriented imagery dataset's required fields.

• After creating the oriented imagery dataset, use the Add Images To Oriented Imagery Dataset tool to add images.

Parameters

Dialog

Label	Explanation	Data Type
Oriented Imagery Dataset Location	The geodatabase in which the output oriented imagery dataset will be created. This workspace must already exist.	Workspace; Feature Dataset
Oriented Imagery Dataset Name	The name of the oriented imagery dataset that will be created.	String
Coordinate System	The spatial reference of the output oriented imagery dataset.	Spatial Reference
Elevation Source (Optional)	Specifies the elevation source for the dataset. DEM—The elevation source will be a digital elevation model that is a dynamic image service or a tile image service. Constant Elevation—The elevation source will be a constant ground elevation value for the entire dataset.	String
Constant Elevation (Optional)	The constant ground elevation value (in meters) for the entire dataset. This parameter is active when the Elevation Source parameter value is specified as Constant Elevation.	Double
Digital Elevation Model (Optional)	The name of the input digital elevation model. A dynamic image service or a tile image service can be used as the digital elevation model. This parameter is active when the Elevation Source parameter value is specified as DEM.	Image Service
Level of Detail (Optional)	The scale in a tiling schema. The scale represents the zoom level value. Each successive level improves resolution and map scale by double when compared to the previous level. This parameter is enabled when the Digital Elevation Model parameter value is a tile image service.	String
Raster Function (Optional)	The raster function processing template that will be applied to the image service. This parameter is active when the Digital Elevation Model parameter value is a dynamic image service.	String
Template Datasets (Optional)	The oriented imagery dataset or table that will be used as a template to define the attribute fields of the new oriented imagery dataset.	Table View
Oriented Imagery Dataset Alias (Optional)	The alternate name for the oriented imagery dataset that will be created.	String
Configuration Keyword (Optional)	The configuration keyword for the data. This parameter applies to enterprise data only. It determines the storage parameters of the database table.	String
Has Z (Optional)	Specifies whether the output oriented imagery dataset will have elevation values (z-values). No—The output oriented imagery dataset will not have z-values. This is the default Yes—The output oriented imagery dataset will have z-values.	String

Derived Output

Label	Explanation	Data Type
Output Oriented Imagery Dataset	The new output oriented imagery dataset.	Oriented Imagery Dataset

Python

arcpy.management.CreateOrientedImageryDataset(out_dataset_path, out_dataset_name, spatial_reference, {elevation_source}, {constant_elevation}, {dem}, {lod}, {raster_function}, {template}, {out_dataset_alias}, {config_keyword}, {has_z})

Name	Explanation	Data Type
out_dataset_path	The geodatabase in which the output oriented imagery dataset will be created. This workspace must already exist.	Workspace; Feature Dataset
out_dataset_name	The name of the oriented imagery dataset that will be created.	String
spatial_reference	The spatial reference of the output oriented imagery dataset.	Spatial Reference
elevation_source (Optional)	Specifies the elevation source for the dataset. DEM—The elevation source will be a digital elevation model that is a dynamic image service or a tile image service. CONSTANT_ELEVATION—The elevation source will be a constant ground elevation value for the entire dataset.	String
constant_elevation (Optional)	The constant ground elevation value (in meters) for the entire dataset. This parameter is enabled when the elevation_source parameter value is specified as CONSTANT_ELEVATION.	Double
dem (Optional)	The name of the input digital elevation model. A dynamic image service or a tile image service can be used as the digital elevation model. This parameter is enabled when the elevation_source parameter value is specified as DEM.	Image Service
lod (Optional)	The scale in a tiling schema. The scale represents the zoom level value. Each successive level improves resolution and map scale by double when compared to the previous level. This parameter is enabled when the dem parameter value is a tile image service.	String
raster_function (Optional)	The raster function processing template that will be applied to the image service. This parameter is enabled when the dem parameter value is a dynamic image service.	String
template [template,...] (Optional)	The oriented imagery dataset or table that will be used as a template to define the attribute fields of the new oriented imagery dataset.	Table View
out_dataset_alias (Optional)	The alternate name for the oriented imagery dataset that will be created.	String
config_keyword (Optional)	The configuration keyword for the data. This parameter applies to enterprise data only. It determines the storage parameters of the database table.	String
has_z (Optional)	Specifies whether the output oriented imagery dataset will have elevation values (z-values). DISABLED—The output oriented imagery dataset will not have z-values. This is the default ENABLED—The output oriented imagery dataset will have z-values.	String

Derived Output

Name	Explanation	Data Type
out_oriented_imagery_dataset	The new output oriented imagery dataset.	Oriented Imagery Dataset

Code sample

CreateOrientedImageryDataset example 1 (Python window)

The following Python window script demonstrates how to use the CreateOrientedImageryDataset function in immediate mode.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.CreateOrientedImageryDataset("C:/data/output.gdb", "myOrientedImagery", 3857)

CreateOrientedImageryDataset example 2 (stand-alone script)

The following Python script demonstrates how to use the CreateOrientedImageryDataset function in a stand-alone script.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/OrientedImageryExample"

# Set local variables
gdbName = "CreateOI.gdb"
oiName = "myFirstOI"
dataset = "C:/OrientedImageryExample/CreateOI.gdb/dataset"
spatialRef = arcpy.Describe(dataset).spatialReference
elvSource = "DEM"
demService = "https://elevation.arcgis.com/arcgis/rest/services/WorldElevation/Terrain/ImageServer/"

# Run Create Oriented Imagery Dataset 
arcpy.oi.CreateOrientedImageryDataset(
    gdbName, oiName, spatialRef, elevation_source=elvSource, dem=demService
)

Environments

Output Coordinate System, Geographic Transformations, Output CONFIG Keyword, Output XY Domain, XY Resolution, XY Tolerance