Agregar imágenes al dataset de imágenes orientadas (Imágenes orientadas)

Resumen

Agrega imágenes a un dataset de imágenes orientadas a partir de diversas fuentes de entrada, por ejemplo, un archivo, una carpeta, una tabla, una lista de rutas de imágenes o una capa de entidades de puntos.

Uso

  • Las imágenes que se agregan no son gestionadas por el dataset de imágenes orientadas; el dataset señala dónde se almacenan las imágenes. Si una imagen se elimina o se mueve, no se cargará en el visor de imágenes orientado.

  • En función del valor del parámetro Datos de entrada, la herramienta identifica los metadatos necesarios para cargar los datos en el dataset de imágenes orientadas. La funcionalidad de las imágenes orientadas depende de la información de los metadatos.

  • Todas las opciones de datos de entrada admiten el formato JPEG. En los casos siguientes, las imágenes deben agregarse utilizando un archivo .csv que siga el esquema de la tabla de imágenes orientadas, una capa de entidades que siga el esquema de la tabla de atributos de imágenes orientadas o una capa de imágenes orientadas:

    • El formato de la imagen es TIF o MRF.
    • Los metadatos de la imagen se almacenan por separado de los archivos de imagen o deben editarse antes de agregarlos.
    • Está incluyendo la orientación de la cámara, que permite transformaciones más precisas de la imagen al suelo y del suelo a la imagen.

  • Si los datos se agregan directamente desde archivos de imagen, una carpeta que contenga imágenes o un archivo de texto con una lista de rutas de imágenes, la información de metadatos se extrae de los datos EXIF y XMP de la imagen. Los datos EXIF deben contener, como mínimo, información sobre la ubicación geográfica.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de imágenes orientadas

La ruta y el nombre del dataset de imágenes orientadas donde se agregarán las imágenes.

Oriented Imagery Layer
Categoría de imágenes

Especifica el tipo de imágenes de entrada que se utilizarán y establece las propiedades predeterminadas del dataset de imágenes orientadas. Se utilizará la propiedad predeterminada si no se encuentra el atributo equivalente en la tabla de atributos del dataset de imágenes orientadas.

  • Horizontal: se utilizarán imágenes en las que la exposición sea paralela al suelo y mirando al horizonte.
  • Oblique: se utilizarán imágenes en las que la exposición esté en ángulo con el suelo, normalmente a unos 45 grados para que puedan verse los lados de los objetos.
  • Nadir: se utilizarán imágenes en las que la exposición sea perpendicular al suelo y mirando directamente hacia abajo. Solo se puede ver la parte superior de los objetos.
  • 360: se utilizarán imágenes tomadas con cámaras especializadas que ofrezcan vistas esféricas envolventes de 360 grados o que se hayan unido como vistas de 360 grados procedentes de varias cámaras.
  • Inspection: se utilizarán imágenes en primer plano de los activos (a menos de 5 metros de la cámara).
String
Datos de entrada

La ruta y el nombre de los datos de entrada. Son compatibles los siguientes:

Folder; Oriented Imagery Layer; Table; Raster Layer; File
Incluir subcarpetas
(Opcional)

Especifica si las subcarpetas se explorarán de forma recursiva.

  • Activado: se explorarán de forma recurrente todas las subcarpetas en busca de datos. Esta es la opción predeterminada.
  • Desactivado: solo se explorará la carpeta de nivel superior en busca de datos.
Boolean
Filtro de carpetas de entrada
(Opcional)

Una expresión que se utilizará para filtrar y agregar imágenes en la carpeta de entrada.

Por ejemplo, para agregar solamente imágenes que contengan una cadena determinada, agregue signos de porcentaje antes y después del valor de la cadena (%valor%).

String
Filtro de la tabla de entrada
(Opcional)

Una expresión de SQL que se utilizará para seleccionar un subconjunto de registros. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
Incluir todos los campos de la tabla de entrada
(Opcional)

Especifica si todos los campos de la tabla de entrada, aparte del esquema requerido, se agregarán a la tabla de atributos del dataset.

Desactivado: solamente se agregarán campos específicos del esquema de imágenes orientadas a la tabla de atributos del dataset. Esta es la opción predeterminada.

Activado: todos los campos de la tabla de entrada se agregarán a la tabla de atributos del dataset.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Actualización del dataset de imágenes orientadas

El dataset de imágenes orientadas actualizado.

Oriented Imagery Layer

arcpy.management.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})
NombreExplicaciónTipo de datos
in_oriented_imagery_dataset

La ruta y el nombre del dataset de imágenes orientadas donde se agregarán las imágenes.

Oriented Imagery Layer
imagery_category

Especifica el tipo de imágenes de entrada que se utilizarán y establece las propiedades predeterminadas del dataset de imágenes orientadas. Se utilizará la propiedad predeterminada si no se encuentra el atributo equivalente en la tabla de atributos del dataset de imágenes orientadas.

  • Horizontal: se utilizarán imágenes en las que la exposición sea paralela al suelo y mirando al horizonte.
  • Oblique: se utilizarán imágenes en las que la exposición esté en ángulo con el suelo, normalmente a unos 45 grados para que puedan verse los lados de los objetos.
  • Nadir: se utilizarán imágenes en las que la exposición sea perpendicular al suelo y mirando directamente hacia abajo. Solo se puede ver la parte superior de los objetos.
  • 360: se utilizarán imágenes tomadas con cámaras especializadas que ofrezcan vistas esféricas envolventes de 360 grados o que se hayan unido como vistas de 360 grados procedentes de varias cámaras.
  • Inspection: se utilizarán imágenes en primer plano de los activos (a menos de 5 metros de la cámara).
String
input_data
[input_data,...]

La ruta y el nombre de los datos de entrada. Son compatibles los siguientes:

Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders
(Opcional)

Especifica si las subcarpetas se explorarán de forma recursiva.

  • SUBFOLDERSSe explorarán de forma recurrente todas las subcarpetas en busca de datos. Esta es la opción predeterminada.
  • NOSUBFOLDERSSolo se explorará la carpeta de nivel superior en busca de datos.
Boolean
folder_filter
(Opcional)

Una expresión que se utilizará para filtrar y agregar imágenes en la carpeta de entrada.

Por ejemplo, para agregar solamente imágenes que contengan una cadena determinada, agregue signos de porcentaje antes y después del valor de la cadena (%valor%).

String
where_clause
(Opcional)

Una expresión de SQL que se utilizará para seleccionar un subconjunto de registros. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
include_all_fields
(Opcional)

Especifica si todos los campos de la tabla de entrada, aparte del esquema requerido, se agregarán a la tabla de atributos del dataset.

  • NO_INCLUDE_ALL_FIELDSSolamente se agregarán campos específicos del esquema de imágenes orientadas a la tabla de atributos del dataset. Esta es la opción predeterminada.
  • INCLUDE_ALL_FIELDSTodos los campos de la tabla de entrada se agregarán a la tabla de atributos del dataset.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_oriented_imagery_dataset

El dataset de imágenes orientadas actualizado.

Oriented Imagery Layer

Muestra de código

Ejemplo 1 de AddImagesToOrientedImageryDataset (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data='C:/OrientedImageryExample/Samples/img1.jpg;C:/OrientedImageryExample/Samples/img2.jpg')