Skip to main content

Update Oriented Imagery Dataset Properties (Oriented Imagery Tools)

Summary

Updates or modifies oriented imagery dataset properties.

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.

  • The dataset properties can be used to optimize the dataset. If any dataset property is present as a field in the attribute table with the same value for all the records, the field can be removed from the attribute table and the value can be set as a dataset property. If the field exists in the attribute table, the attribute table value will take precedence over the dataset property value.

  • If a string data type parameter must be removed using the tool in Python, provide a value of "None".

Parameters

Label Explanation Data type

Oriented Imagery Dataset

The path and name of the oriented imagery dataset with the properties that will be updated.

Oriented Imagery Layer

Maximum Distance

(Optional)

The maximum search distance used when querying the dataset features. The maximum distance cannot be less than zero. The distance is measured in meters.

Double

Coverage Percentage

(Optional)

A percentage that modifies the extent of the image's ground footprint. The ground footprint of each image is computed to search for images that contain the selected location, which is identified as a red cross on the map.

A negative percentage value reduces the size of the ground footprint and a positive percentage value increases it. This parameter can be used to exclude or include points on the edge of an image. For example, a value of -30 will reduce the size of the footprint by 30 percent and a value of 20 will increase it by 20 percent. Valid values range from -50 to 50.

Double

Footprint Item

(Optional)

The name of the footprint feature class. The feature class should be in the same geodatabase as the oriented imagery dataset.

String

Elevation Source

(Optional)

Specifies the elevation source that will be used.

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

  • None—The elevation source will be removed.

String

Constant Elevation

(Optional)

The constant ground elevation value for the entire dataset. The Vertical Measurement Unit parameter value will be used as the unit for constant elevation.

This parameter is active when the Elevation Source parameter value is Constant Elevation.

Double

Digital Elevation Model

(Optional)

The URL that references 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 DEM.

Image Service

Level of Detail

(Optional)

The scale defined 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 active 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

Vertical Measurement Unit

(Optional)

Specifies the unit that will be used for all vertical measurements.

  • Meter—Meters will be used as the unit of measurement.

  • Feet—Feet will be used as the unit of measurement.

String

Time Interval Unit

(Optional)

Specifies the time measurement unit that will be used to filter images.

  • Minutes—Images will be filtered by minutes.

  • Hours—Images will be filtered by hours.

  • Days—Images will be filtered by days.

  • Weeks—Images will be filtered by weeks.

  • Months—Images will be filtered by months.

  • Years—Images will be filtered by years.

String

Oriented Imagery Type

(Optional)

Specifies the type of images in the dataset.

  • Horizontal—Images in which the exposure is parallel to the ground and looking to the horizon are in the dataset.

  • Oblique—Images in which the exposure is at an angle to the ground, typically at approximately 45 degrees, so the sides of objects can be seen are in the dataset.

  • Nadir—Images in which the exposure is perpendicular to the ground and looking straight down are in the dataset. Only the top of objects can be seen.

  • 360—Images taken using cameras that provide 360-degree spherical surround views or have been stitched together as 360-degree views from multiple cameras are in the dataset.

  • Inspection—Close-up images of assets are in the dataset.

  • AerialFrameVideo—Video captured by a drone or aircraft with the camera pointing downward towards the ground.

  • TerrestrialFrameVideo—Video captured using handheld devices such as dashboard cameras.

  • Terrestrial360Video—A 360-degree video captured using devices such as GoPro or Insta360.

  • None—The oriented imagery type will be removed from the dataset.

String

Camera Heading

(Optional)

The camera orientation of the first rotation around the z-axis of the camera. The value is in degrees. The heading values are measured in the positive clockwise direction in which north is defined as 0 degrees. -999 is used when the orientation is unknown.

Double

Camera Pitch

(Optional)

The camera orientation of the second rotation around the x-axis of the camera in the positive counterclockwise direction. The value is in degrees. The pitch is 0 degrees when the camera is facing straight down to the ground. The valid range of pitch is from 0 to 180 degrees, with 180 degrees for a camera facing straight up and 90 degrees for a camera facing the horizon.

Double

Camera Roll

(Optional)

The camera orientation of the final rotation around the z-axis of the camera in the positive clockwise direction. The value is in degrees. Valid values range from -90 to 90.

Double

Camera Height

(Optional)

The height of the camera above the ground when the imagery was captured. The unit is meters. Camera height is used to determine the visible extent of the image. Large values will result in a greater view extent. Values should not be less than 0.

Double

Horizontal Field of View

(Optional)

The camera's scope in the horizontal direction. The value is in degrees. Valid values range from 0 to 360.

Double

Vertical Field of View

(Optional)

The camera's scope in the vertical direction. The value is in degrees. Valid values range from 0 to 180.

Double

Near Distance

(Optional)

The nearest usable distance of the imagery from the camera position. The unit is meters.

Double

Far Distance

(Optional)

The farthest usable distance of the imagery from the camera position. The unit is meters. Far distances should be greater than 0.

Double

Image Rotation

(Optional)

The orientation of the camera in degrees relative to the scene when the image was captured. The rotation is in addition to the camera roll. Valid values range from-360 to 360.

Double

Orientation Accuracy

(Optional)

The orientation accuracy values. The values are represented as a string of eight semicolon-delimited values that define the standard deviation of each value in the following order:

  • Camera location in XY direction

  • Camera Z

  • Camera Heading

  • Camera Pitch

  • Camera Roll

  • Near distance

  • Far distance

  • Elevation of the terrain

All distances are defined in meters. All angles are defined in degrees. If a value is unknown, that value can be excluded. However, this may result in the accuracy computed being higher than the actual value.

For example, if a GPS has a +/- 10 meters root mean square (RMS) error in x,y-coordinates and +/- 20 meters in height, the orientation accuracy value is 10;20.

The typical value for a vehicle-mounted consumer camera is 15;10;5;5;5;0;0;1.

The typical value for a 360 camera with autoleveling (for example, GoPro or Insta360) is 15;0.2;0.5;0.5;0.5;0;0;1.

The typical value for a Drone imagery without Real Time Kinematic (RTK) and standard gimble is 5;10;2;2;2;0;0;1.

The typical value for oblique imagery following aerial triangulation is 0.01;0.02;0.001;0.001;0.001;0;0;1.

The values provided above are intended for reference only and should not be treated as absolute measurements. To ensure precise orientation accuracy parameters, the values should be taken directly from the system that captured the imagery.

For aerial imagery, these parameters are typically available in the Aerial Triangulation results, if that process has been completed.

For systems that record GPS‑based positional information, the GPS accuracy details should be supplied as part of the dataset.

String

Image Path Prefix

(Optional)

The prefix that will be used to build the image path in conjunction with the Image attribute.

String

Image Path Suffix

(Optional)

The suffix that will be used to build the image path in conjunction with the Image attribute.

String

Depth Image Path Prefix

(Optional)

The prefix that will be used to build the depth image path in conjunction with the Depth Image attribute.

String

Depth Image Path Suffix

(Optional)

The suffix that will be used to build the depth image path in conjunction with the Depth Image attribute.

String

DEM Path Prefix

(Optional)

The prefix that will be used to build the digital elevation model path in conjunction with the Elevation Source URL in the attribute.

String

DEM Path Suffix

(Optional)

The suffix that will be used to build the digital elevation model path in conjunction with the Elevation Source URL in the attribute.

String

Image Geometry Field

(Optional)

The field for a feature layer that will be overlayed on the image in the oriented imagery viewer. This field will store the image space geometry of the feature to be overlayed. The default is ImageGeometry.

String

Image Reference Field

(Optional)

The field for a feature layer that will be overlayed on the image in the oriented imagery viewer. The field will store the unique reference ID of the image in which the feature to be overlayed was created. The default is OIObjectID.

String

Reference ID Field

(Optional)

This field is part of a feature class that includes features captured from the oriented imagery dataset. The field will store the unique reference ID corresponding to the specific image on which each feature was recorded. The default is ObjectID.

String

Sequence Order Field

(Optional)

This field stores a unique sequence of numbers that controls the order of navigation through features. The default is SequenceOrder.

String

Vertical Search Range

(Optional)

The maximum vertical search distance used when querying dataset features. This value must be greater than or equal to zero. The unit of measurement is meters.

Double

Derived output

Label Explanation Data type

Output Oriented Imagery Dataset

The updated oriented imagery dataset.

Oriented Imagery Dataset

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes