Volver al principio

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

En este tema

  1. Resumen
  2. Uso
  3. Parámetros
  4. Entornos
  5. Información de licenciamiento

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

Cuadro de diálogoPython

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 distancia se mide en 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á.

  • DEM—La 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 constante—La fuente de elevación será un valor de elevación del terreno constante para todo el dataset.
  • Ninguno—Se 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.

  • Contador—Se utilizarán metros como unidad de medida.
  • Pies—Se 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.

  • Minutos—Las imágenes se filtrarán por minutos.
  • Horas—Las imágenes se filtrarán por horas.
  • Días—Las imágenes se filtrarán por días.
  • Semanas—Las imágenes se filtrarán por semanas.
  • Meses—Las imágenes se filtrarán por meses.
  • Años—Las imágenes se filtrarán por años.
String
Tipo de imágenes orientadas
(Opcional)

Especifica el tipo de imágenes del dataset.

  • Horizontal—Las imágenes en las que la exposición es paralela al suelo y mirando al horizonte se encuentran en el dataset.
  • Oblicuo—Las 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.
  • Nadir—Las 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.
  • 360—Las 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ón—En el dataset hay imágenes en primer plano de los activos.
  • Ninguno—El 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)

Los valores de precisión de la orientación. Se representan como una cadena de caracteres de ocho valores delimitados por punto y coma que definen la desviación estándar de cada valor en el orden siguiente:

  • Ubicación de la cámara en la dirección XY
  • Cámara Z
  • Orientación de la cámara
  • Cabeceo de la cámara
  • Balanceo de la cámara
  • Distancia cercana
  • Distancia lejana
  • Elevación del terreno

Todas las distancias se definen en metros a menos que las unidades del sistema de coordenadas estén en pies, en cuyo caso las unidades utilizadas para la distancia deben ser pies. Todos los ángulos se definen en grados. Si se desconoce un valor, ese valor puede excluirse. Sin embargo, esto puede provocar que la precisión calculada sea mayor que el valor real.

Por ejemplo, si un GPS tiene un error cuadrático medio (RMS) de +/- 10 metros en las coordenadas x,y y +/- 20 metros en altura, el valor de precisión de la orientación es 10;20.

Un valor típico para una cámara de consumo montada en un vehículo es 5;10;5;5;5;0;0;1.

Un valor típico para imágenes oblicuas después de la triangulación aérea es 0,01; 0,02; 0,001; 0,001; 0,001; 0; 0; 1.

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 del modelo de elevación digital junto con la URL Elevation Source en el atributo.

String
Sufijo de la ruta de DEM
(Opcional)

El sufijo que se utilizará para construir la ruta del modelo de elevación digital junto con la URL Elevation Source en el atributo.

String
Campo de geometría de imagen
(Opcional)

El campo de una capa de entidades que se superpondrá a la imagen en el visor de imágenes orientadas. Este campo almacenará la geometría del espacio de imagen de la entidad que se va a superponer.

String
Campo de referencia de imagen
(Opcional)

El campo de una capa de entidades que se superpondrá a la imagen en el visor de imágenes orientadas. El campo almacenará el Id. de referencia único de la imagen en la que se creó la entidad que se va a superponer.

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}, {image_geometry_field}, {image_reference_field})
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 distancia se mide en 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á.

  • DEM—La 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_ELEVATION—La fuente de elevación será un valor de elevación del terreno constante para todo el dataset.
  • NONE—Se 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.

  • METER—Se utilizarán metros como unidad de medida.
  • FEET—Se 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.

  • MINUTES—Las imágenes se filtrarán por minutos.
  • HOURS—Las imágenes se filtrarán por horas.
  • DAYS—Las imágenes se filtrarán por días.
  • WEEKS—Las imágenes se filtrarán por semanas.
  • MONTHS—Las imágenes se filtrarán por meses.
  • YEARS—Las imágenes se filtrarán por años.
String
oriented_imagery_type
(Opcional)

Especifica el tipo de imágenes del dataset.

  • HORIZONTAL—Las imágenes en las que la exposición es paralela al suelo y mirando al horizonte se encuentran en el dataset.
  • OBLIQUE—Las 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.
  • NADIR—Las 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.
  • 360—Las 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.
  • INSPECTION—En el dataset hay imágenes en primer plano de los activos.
  • NONE—El 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)

Los valores de precisión de la orientación. Se representan como una cadena de caracteres de ocho valores delimitados por punto y coma que definen la desviación estándar de cada valor en el orden siguiente:

  • Ubicación de la cámara en la dirección XY
  • Cámara Z
  • Orientación de la cámara
  • Cabeceo de la cámara
  • Balanceo de la cámara
  • Distancia cercana
  • Distancia lejana
  • Elevación del terreno

Todas las distancias se definen en metros a menos que las unidades del sistema de coordenadas estén en pies, en cuyo caso las unidades utilizadas para la distancia deben ser pies. Todos los ángulos se definen en grados. Si se desconoce un valor, ese valor puede excluirse. Sin embargo, esto puede provocar que la precisión calculada sea mayor que el valor real.

Por ejemplo, si un GPS tiene un error cuadrático medio (RMS) de +/- 10 metros en las coordenadas x,y y +/- 20 metros en altura, el valor de precisión de la orientación es 10;20.

Un valor típico para una cámara de consumo montada en un vehículo es 5;10;5;5;5;0;0;1.

Un valor típico para imágenes oblicuas después de la triangulación aérea es 0,01; 0,02; 0,001; 0,001; 0,001; 0; 0; 1.

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 del modelo de elevación digital junto con la URL Elevation Source en el atributo.

String
dem_path_suffix
(Opcional)

El sufijo que se utilizará para construir la ruta del modelo de elevación digital junto con la URL Elevation Source en el atributo.

String
image_geometry_field
(Opcional)

El campo de una capa de entidades que se superpondrá a la imagen en el visor de imágenes orientadas. Este campo almacenará la geometría del espacio de imagen de la entidad que se va a superponer.

String
image_reference_field
(Opcional)

El campo de una capa de entidades que se superpondrá a la imagen en el visor de imágenes orientadas. El campo almacenará el Id. de referencia único de la imagen en la que se creó la entidad que se va a superponer.

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.

¿Algún comentario sobre este tema?

En este tema
  1. Resumen
  2. Uso
  3. Parámetros
  4. Entornos
  5. Información de licenciamiento