Build Oriented Imagery Footprint (Oriented Imagery)

Summary

Builds a footprint feature class for an oriented imagery dataset.

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

• If the Footprint Options parameter is set to One footprint per image or Merge all image footprints., the output footprints will be calculated by computing each image extent. You can adjust the image extent by changing the Camera Heading, Camera Roll, Horizontal Field of View, Vertical Field of View, Camera Height, Far Distance, and Near Distance values in the oriented imagery dataset's attribute table. For 360 degree images, the extent depends only on the Far Distance value. If these values are not defined in the oriented imagery dataset's attribute table, the default values from the oriented imagery dataset properties will be used.

• The output feature class will be added as the Footprint property of the oriented imagery dataset only if the Footprint Dataset Location parameter value is the same geodatabase as that of the oriented imagery dataset.

Parameters

Dialog

Label	Explanation	Data Type
Oriented Imagery Dataset	The oriented imagery dataset for which the footprint will be computed.	Oriented Imagery Layer
Footprint Dataset Location	The enterprise or file geodatabase where the output footprint feature class will be created.	Workspace; Feature Dataset
Footprint Dataset Name	The name of the output footprint feature class.	String
Footprint Options	Specifies the method that will be used to create the footprint. One footprint per image—Polygon features will be created from each feature based on camera parameters. Use this option when there are only a few feature points and they are scattered over a large projected area. Merge all image footprints—Individual polygons will be computed and merged into a single polygon feature that is a more optimized footprint for the dataset. Buffer each camera location—Each feature point will be buffered using the average far distance value of the oriented imagery dataset and merged to a single polygon feature. Use this option for street view imagery. Dataset extent as footprint—A footprint will be created based on the extent of the oriented imagery dataset. Use this option when there are many camera points within a small area.	String

Derived Output

Label	Explanation	Data Type
Output Footprint	The output footprint feature class.	Feature Class

Python

arcpy.management.BuildOrientedImageryFootprint(in_oriented_imagery_dataset, out_dataset_path, out_dataset_name, footprint_option)

Name	Explanation	Data Type
in_oriented_imagery_dataset	The oriented imagery dataset for which the footprint will be computed.	Oriented Imagery Layer
out_dataset_path	The enterprise or file geodatabase where the output footprint feature class will be created.	Workspace; Feature Dataset
out_dataset_name	The name of the output footprint feature class.	String
footprint_option	Specifies the method that will be used to create the footprint. PER_IMAGE—Polygon features will be created from each feature based on camera parameters. Use this option when there are only a few feature points and they are scattered over a large projected area. MERGE—Individual polygons will be computed and merged into a single polygon feature that is a more optimized footprint for the dataset. BUFFER—Each feature point will be buffered using the average far distance value of the oriented imagery dataset and merged to a single polygon feature. Use this option for street view imagery. EXTENT—A footprint will be created based on the extent of the oriented imagery dataset. Use this option when there are many camera points within a small area.	String

Derived Output

Name	Explanation	Data Type
out_feature_class	The output footprint feature class.	Feature Class

Code sample

BuildOrientedImageryFootprint example 1 (Python window)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.BuildOrientedImageryFootprint(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    out_dataset_path="C:/OrientedImageryExample/MyOI.gdb",
    out_dataset_name='MyOrientedImageryDataset_footprint',
    footprint_option='MERGE')

Environments

Output Coordinate System, Geographic Transformations, Extent