Actualizar propiedades del dataset de imágenes orientadas (Imágenes orientadas)

Resumen

Actualiza o modifica las propiedades del dataset de imágenes orientadas.

Uso

    Precaución:

    Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

  • Las propiedades del dataset pueden utilizarse para optimizarlo. Si alguna propiedad del dataset está presente como campo en la tabla de atributos con el mismo valor para todos los registros, el campo puede eliminarse de la tabla de atributos y el valor puede establecerse como propiedad del dataset. Si el campo existe en la tabla de atributos, el valor de la tabla de atributos tendrá prioridad sobre el valor de la propiedad del dataset.

  • Si un parámetro de tipo de datos cadena debe eliminarse utilizando la herramienta en Python, proporcione un valor de "None".

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de imágenes orientadas

La ruta y el nombre del dataset de imágenes orientadas.

Oriented Imagery Layer
Distancia máxima
(Opcional)

La distancia máxima de búsqueda que se utilizará al consultar las entidades del dataset. La distancia máxima no puede ser inferior a cero. La unidad son metros.

Double
Porcentaje de cobertura
(Opcional)

Un porcentaje que modifica la extensión de la huella del suelo de la imagen. La huella del suelo de cada imagen se calcula para buscar imágenes que contengan la ubicación seleccionada, que se identifica como una cruz roja en el mapa.

Un valor porcentual negativo reduce el tamaño de la huella del suelo y un valor porcentual positivo lo aumenta. Este parámetro puede utilizarse para excluir o incluir puntos en el borde de una imagen. Por ejemplo, un valor de -30 reducirá el tamaño de la huella en un 30% y un valor de 20 lo aumentará en un 20%. Los valores válidos están comprendidos entre -50 y 50.

Double
Elemento de huella
(Opcional)

El nombre de la clase de entidad de huella. La clase de entidad debe estar en la misma geodatabase que el dataset de imágenes orientadas.

String
Fuente de elevación
(Opcional)

Especifica la fuente de elevación que se utilizará.

  • DEMLa fuente de elevación será un modelo de elevación digital que es un servicio de imágenes dinámicas o un servicio de imágenes de tesela.
  • Elevación constanteLa fuente de elevación será un valor de elevación del terreno constante para todo el dataset.
  • NingunaSe eliminará la fuente de elevación.
String
Elevación constante
(Opcional)

Valor de elevación del terreno constante para todo el dataset. El valor del parámetro Unidad de medida vertical se utilizará como unidad para la elevación constante.

Este parámetro se activa cuando el valor del parámetro Fuente de elevación se especifica como Elevación constante.

Double
Modelo digital de elevación
(Opcional)

La URL que hace referencia al modelo digital de elevación de entrada. Se puede utilizar un servicio de imágenes dinámicas o un servicio de imágenes de tesela como modelo de elevación digital.

Este parámetro se activa cuando el valor del parámetro Fuente de elevación se especifica como DEM.

Image Service
Nivel de detalle
(Opcional)

La escala definida en un esquema de ordenamiento de teselas. La escala representa el valor del nivel de zoom. Cada nivel sucesivo duplica la resolución y la escala del mapa en comparación con el nivel anterior.

Este parámetro se habilita cuando el valor del parámetro Modelo de elevación digital es un servicio de imágenes de tesela.

String
Función ráster
(Opcional)

La plantilla de procesamiento de la función raster que se aplicará al servicio de imágenes.

Este parámetro se activa cuando el valor del parámetro Modelo de elevación digital es un servicio de imágenes dinámicas.

String
Unidad de medición vertical
(Opcional)

Especifica la unidad que se utilizará para todas las mediciones verticales.

  • ContadorSe utilizarán metros como unidad de medida.
  • PiesSe utilizarán los pies como unidad de medida.
String
Unidad de intervalo de tiempo
(Opcional)

Especifica la unidad de medida de tiempo que se utilizará para filtrar las imágenes.

  • MinutosLas imágenes se filtrarán por minutos.
  • HorasLas imágenes se filtrarán por horas.
  • DíasLas imágenes se filtrarán por días.
  • SemanasLas imágenes se filtrarán por semanas.
  • MesesLas imágenes se filtrarán por meses.
  • AñosLas imágenes se filtrarán por años.
String
Tipo de imágenes orientadas
(Opcional)

Especifica el tipo de imágenes del dataset.

  • HorizontalLas imágenes en las que la exposición es paralela al suelo y mirando al horizonte se encuentran en el dataset.
  • OblicuoLas imágenes en las que la exposición está en ángulo con el suelo, normalmente a unos 45 grados, para que se puedan ver los lados de los objetos están en el dataset.
  • NadirLas imágenes en las que la exposición es perpendicular al suelo y mirando directamente hacia abajo están en el dataset. Solo se puede ver la parte superior de los objetos.
  • 360Las imágenes tomadas con cámaras que facilitan vistas esféricas envolventes de 360 grados o que se han unido como vistas de 360 grados de varias cámaras se encuentran en el dataset.
  • InspecciónEn el dataset hay imágenes en primer plano de los activos.
  • NingunaEl tipo de imagen orientado se eliminará del dataset.
String
Orientación de la cámara
(Opcional)

La orientación de la cámara de la primera rotación alrededor del eje z de la cámara. El valor está en grados. Los valores de orientación se miden en el sentido positivo de las agujas del reloj en el que el norte se define como 0 grados. Cuando la orientación es desconocida, se utiliza -999.

Double
Cabeceo de la cámara
(Opcional)

La orientación de la cámara de la segunda rotación alrededor del eje x de la cámara en sentido antihorario positivo. El valor está en grados. El cabeceo es de 0 grados cuando la cámara está orientada directamente hacia el suelo. El rango válido de inclinación es de 0 a 180 grados, siendo 180 grados para una cámara orientada hacia arriba y 90 grados para una cámara orientada hacia el horizonte.

Double
Balanceo de la cámara
(Opcional)

La orientación de la cámara de la rotación final alrededor del eje z de la cámara en el sentido positivo de las agujas del reloj. El valor está en grados. Los valores válidos varían de -90 a 90.

Double
Altura de la cámara
(Opcional)

La altura de la cámara sobre el suelo cuando se capturaron las imágenes. La unidad son metros. La altura de la cámara se utiliza para determinar la extensión visible de la imagen. Los valores grandes darán como resultado una mayor extensión de la vista. Los valores no deben ser inferiores a 0.

Double
Campo horizontal de visión
(Opcional)

El alcance de la cámara en la dirección horizontal. El valor está en grados. Los valores válidos varían de 0 a 360.

Double
Campo vertical de visión
(Opcional)

El alcance de la cámara en la dirección vertical. El valor está en grados. Los valores válidos varían de 0 a 180.

Double
Distancia cercana
(Opcional)

La distancia utilizable más cercana de las imágenes desde la posición de la cámara. La unidad son metros.

Double
Distancia lejana
(Opcional)

La distancia utilizable más lejana de las imágenes desde la posición de la cámara. La unidad son metros. Las distancias lejanas deben ser mayores que 0.

Double
Rotación de la imagen
(Opcional)

La orientación de la cámara en grados relativos a la escena cuando se capturó la imagen. Además del balanceo de la cámara, se agrega la rotación. Los valores válidos varían de -360 a 360.

Double
Exactitud de ubicación
(Opcional)

La desviación estándar en valores de precisión separados por punto y coma. Los valores de la desviación típica se agregan en el orden y formato siguientes:

  • Ubicación de la cámara en la dirección XY en metros
  • Altura de la cámara en metros
  • Orientación de la cámara en grados
  • Cabeceo de la cámara en grados
  • Balanceo de la cámara en grados
  • Distancia cercana en metros
  • Distancia lejana en metros
  • Elevación en metros

Por ejemplo, si el GPS tiene un valor eficaz de +/- 10 metros en las coordenadas x,y y +/- 20 metros en la altura, el valor de la precisión de la orientación es 10;20.

String
Prefijo de la ruta de la imagen
(Opcional)

El prefijo que se utilizará para construir la ruta de la imagen junto con el atributo Image.

String
Sufijo de la ruta de la imagen
(Opcional)

El sufijo que se utilizará para construir la ruta de la imagen junto con el atributo Image.

String
Profundidad del prefijo de la ruta de la imagen
(Opcional)

El prefijo que se utilizará para construir la ruta de la imagen de profundidad junto con el atributo Depth Image.

String
Profundidad del sufijo de la ruta de la imagen
(Opcional)

El sufijo que se utilizará para construir la ruta de la imagen de profundidad junto con el atributo Depth Image.

String
Prefijo de la ruta de DEM
(Opcional)

El prefijo que se utilizará para construir la ruta de DEM junto con la URL del atributo Elevation Source.

String
Sufijo de la ruta de DEM
(Opcional)

El sufijo que se utilizará para construir la ruta de DEM junto con la URL del atributo Elevation Source.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Dataset de imágenes orientadas de salida

El dataset de imágenes orientadas actualizado.

Oriented Imagery Dataset

arcpy.management.UpdateOrientedImageryDatasetProperties(in_oriented_imagery_dataset, {maximum_distance}, {coverage_percent}, {footprint_item}, {elevation_source}, {constant_elevation}, {dem}, {lod}, {raster_function}, {vertical_measurement_unit}, {time_interval_unit}, {oriented_imagery_type}, {camera_heading}, {camera_pitch}, {camera_roll}, {camera_height}, {hfov}, {vfov}, {near_distance}, {far_distance}, {image_rotation}, {orientation_accuracy}, {image_path_prefix}, {image_path_suffix}, {depth_image_path_prefix}, {depth_image_path_suffix}, {dem_path_prefix}, {dem_path_suffix})
NombreExplicaciónTipo de datos
in_oriented_imagery_dataset

La ruta y el nombre del dataset de imágenes orientadas.

Oriented Imagery Layer
maximum_distance
(Opcional)

La distancia máxima de búsqueda que se utilizará al consultar las entidades del dataset. La distancia máxima no puede ser inferior a cero. La unidad son metros.

Double
coverage_percent
(Opcional)

Un porcentaje que modifica la extensión de la huella del suelo de la imagen. La huella del suelo de cada imagen se calcula para buscar imágenes que contengan la ubicación seleccionada, que se identifica como una cruz roja en el mapa.

Un valor porcentual negativo reduce el tamaño de la huella del suelo y un valor porcentual positivo lo aumenta. Este parámetro puede utilizarse para excluir o incluir puntos en el borde de una imagen. Por ejemplo, un valor de -30 reducirá el tamaño de la huella en un 30% y un valor de 20 lo aumentará en un 20%. Los valores válidos están comprendidos entre -50 y 50.

Double
footprint_item
(Opcional)

El nombre de la clase de entidad de huella. La clase de entidad debe estar en la misma geodatabase que el dataset de imágenes orientadas.

String
elevation_source
(Opcional)

Especifica la fuente de elevación que se utilizará.

  • DEMLa fuente de elevación será un modelo de elevación digital que es un servicio de imágenes dinámicas o un servicio de imágenes de tesela.
  • CONSTANT_ELEVATIONLa fuente de elevación será un valor de elevación del terreno constante para todo el dataset.
  • NONESe eliminará la fuente de elevación.
String
constant_elevation
(Opcional)

Valor de elevación del terreno constante para todo el dataset. El valor del parémetro vertical_measurement_unit se utilizará como unidad para la elevación constante.

Este parámetro se habilita cuando el valor del parámetro elevation_source se especifica como CONSTANT_ELEVATION.

Double
dem
(Opcional)

La URL que hace referencia al modelo digital de elevación de entrada. Se puede utilizar un servicio de imágenes dinámicas o un servicio de imágenes de tesela como modelo de elevación digital.

Este parámetro se habilita cuando el valor del parámetro elevation_source se especifica como DEM.

Image Service
lod
(Opcional)

La escala definida en un esquema de ordenamiento de teselas. La escala representa el valor del nivel de zoom. Cada nivel sucesivo duplica la resolución y la escala del mapa en comparación con el nivel anterior.

Este parámetro está habilitado cuando el valor del parámetro dem es un servicio de imágenes de tesela.

String
raster_function
(Opcional)

La plantilla de procesamiento de la función raster que se aplicará al servicio de imágenes.

Este parámetro está habilitado cuando el valor del parámetro dem es un servicio de imágenes dinámicas.

String
vertical_measurement_unit
(Opcional)

Especifica la unidad que se utilizará para todas las mediciones verticales.

  • METERSe utilizarán metros como unidad de medida.
  • FEETSe utilizarán los pies como unidad de medida.
String
time_interval_unit
(Opcional)

Especifica la unidad de medida de tiempo que se utilizará para filtrar las imágenes.

  • MINUTESLas imágenes se filtrarán por minutos.
  • HOURSLas imágenes se filtrarán por horas.
  • DAYSLas imágenes se filtrarán por días.
  • WEEKSLas imágenes se filtrarán por semanas.
  • MONTHSLas imágenes se filtrarán por meses.
  • YEARSLas imágenes se filtrarán por años.
String
oriented_imagery_type
(Opcional)

Especifica el tipo de imágenes del dataset.

  • HORIZONTALLas imágenes en las que la exposición es paralela al suelo y mirando al horizonte se encuentran en el dataset.
  • OBLIQUELas imágenes en las que la exposición está en ángulo con el suelo, normalmente a unos 45 grados, para que se puedan ver los lados de los objetos están en el dataset.
  • NADIRLas imágenes en las que la exposición es perpendicular al suelo y mirando directamente hacia abajo están en el dataset. Solo se puede ver la parte superior de los objetos.
  • 360Las imágenes tomadas con cámaras que facilitan vistas esféricas envolventes de 360 grados o que se han unido como vistas de 360 grados de varias cámaras se encuentran en el dataset.
  • INSPECTIONEn el dataset hay imágenes en primer plano de los activos.
  • NONEEl tipo de imagen orientado se eliminará del dataset.
String
camera_heading
(Opcional)

La orientación de la cámara de la primera rotación alrededor del eje z de la cámara. El valor está en grados. Los valores de orientación se miden en el sentido positivo de las agujas del reloj en el que el norte se define como 0 grados. Cuando la orientación es desconocida, se utiliza -999.

Double
camera_pitch
(Opcional)

La orientación de la cámara de la segunda rotación alrededor del eje x de la cámara en sentido antihorario positivo. El valor está en grados. El cabeceo es de 0 grados cuando la cámara está orientada directamente hacia el suelo. El rango válido de inclinación es de 0 a 180 grados, siendo 180 grados para una cámara orientada hacia arriba y 90 grados para una cámara orientada hacia el horizonte.

Double
camera_roll
(Opcional)

La orientación de la cámara de la rotación final alrededor del eje z de la cámara en el sentido positivo de las agujas del reloj. El valor está en grados. Los valores válidos varían de -90 a 90.

Double
camera_height
(Opcional)

La altura de la cámara sobre el suelo cuando se capturaron las imágenes. La unidad son metros. La altura de la cámara se utiliza para determinar la extensión visible de la imagen. Los valores grandes darán como resultado una mayor extensión de la vista. Los valores no deben ser inferiores a 0.

Double
hfov
(Opcional)

El alcance de la cámara en la dirección horizontal. El valor está en grados. Los valores válidos varían de 0 a 360.

Double
vfov
(Opcional)

El alcance de la cámara en la dirección vertical. El valor está en grados. Los valores válidos varían de 0 a 180.

Double
near_distance
(Opcional)

La distancia utilizable más cercana de las imágenes desde la posición de la cámara. La unidad son metros.

Double
far_distance
(Opcional)

La distancia utilizable más lejana de las imágenes desde la posición de la cámara. La unidad son metros. Las distancias lejanas deben ser mayores que 0.

Double
image_rotation
(Opcional)

La orientación de la cámara en grados relativos a la escena cuando se capturó la imagen. Además del balanceo de la cámara, se agrega la rotación. Los valores válidos varían de -360 a 360.

Double
orientation_accuracy
(Opcional)

La desviación estándar en valores de precisión separados por punto y coma. Los valores de la desviación típica se agregan en el orden y formato siguientes:

  • Ubicación de la cámara en la dirección XY en metros
  • Altura de la cámara en metros
  • Orientación de la cámara en grados
  • Cabeceo de la cámara en grados
  • Balanceo de la cámara en grados
  • Distancia cercana en metros
  • Distancia lejana en metros
  • Elevación en metros

Por ejemplo, si el GPS tiene un valor eficaz de +/- 10 metros en las coordenadas x,y y +/- 20 metros en la altura, el valor de la precisión de la orientación es 10;20.

String
image_path_prefix
(Opcional)

El prefijo que se utilizará para construir la ruta de la imagen junto con el atributo Image.

String
image_path_suffix
(Opcional)

El sufijo que se utilizará para construir la ruta de la imagen junto con el atributo Image.

String
depth_image_path_prefix
(Opcional)

El prefijo que se utilizará para construir la ruta de la imagen de profundidad junto con el atributo Depth Image.

String
depth_image_path_suffix
(Opcional)

El sufijo que se utilizará para construir la ruta de la imagen de profundidad junto con el atributo Depth Image.

String
dem_path_prefix
(Opcional)

El prefijo que se utilizará para construir la ruta de DEM junto con la URL del atributo Elevation Source.

String
dem_path_suffix
(Opcional)

El sufijo que se utilizará para construir la ruta de DEM junto con la URL del atributo Elevation Source.

String

Salida derivada

NombreExplicaciónTipo de datos
out_oriented_imagery_dataset

El dataset de imágenes orientadas actualizado.

Oriented Imagery Dataset

Muestra de código

Ejemplo 1 de UpdateOrientedImageryDatasetProperties example (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función UpdateOrientedImageryDatasetProperties de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset",
    maximum_distance=550,
    footprint_item='MyOrientedImageryDataset_footprint',
    image_path_prefix='None')
Ejemplo 2 de UpdateOrientedImageryDatasetProperties example 2 (secuencia de comandos independiente)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función UpdateOrientedImageryDatasetProperites en una secuencia de comandos independiente.

# Import system modules
import arcpy

# Set local variables
in_oi = "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset"
new_maximum_distance = 550
footprint = "MyOrientedImageryDataset_footprint"
new_time_unit = "HOURS"
new_camera_height = 2.5

# Run Update Oriented Imagery Dataset Properties
arcpy.oi.UpdateOrientedImageryDatasetProperties(
    in_oriented_imagery_dataset = in_oi,
    maximum_distance = new_maximum_distance,
    footprint_item = footprint,
    time_interval_unit = new_time_unit,
    camera_height = new_camera_height,
)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.