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

LabelExplanationData 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.

  • DEMThe elevation source will be a digital elevation model that is a dynamic image service or a tile image service.
  • Constant ElevationThe 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).

  • NoThe output oriented imagery dataset will not have z-values. This is the default
  • YesThe output oriented imagery dataset will have z-values.
String

Derived Output

LabelExplanationData Type
Output Oriented Imagery Dataset

The new output oriented imagery dataset.

Oriented Imagery Dataset

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})
NameExplanationData 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.

  • DEMThe elevation source will be a digital elevation model that is a dynamic image service or a tile image service.
  • CONSTANT_ELEVATIONThe 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).

  • DISABLEDThe output oriented imagery dataset will not have z-values. This is the default
  • ENABLEDThe output oriented imagery dataset will have z-values.
String

Derived Output

NameExplanationData 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
)