Importar imágenes de interiores (Indoors)

Resumen

Importa imágenes panorámicas y de 360 grados desde un archivo .e57 a un dataset de imágenes orientadas. La salida de esta herramienta se puede agregar a mapas y escenas con reconocimiento de plantas en ArcGIS Pro.

Uso

• Utilice esta herramienta para cargar imágenes panorámicas y de 360 grados en un dataset de imágenes orientadas. Puede incluir capas de imágenes orientadas que tienen en cuenta las plantas en mapas que tienen en cuenta las plantas.

• Esta herramienta admite imágenes JPEG panorámicas y de 360 ​​grados contenidas en archivos .e57. Las imágenes deben utilizar una representación equirectangular (esférica).

• Utilice esta herramienta con entidades de niveles de entrada con una consulta de selección o definición para importar solo imágenes para plantas específicas.

• El valor del parámetro Capa de imágenes orientadas al objetivo debe ser una capa de imágenes orientadas habilitada para z. Cree imágenes orientadas utilizando la herramienta Crear dataset de imágenes orientadas.

  La capa de imágenes orientadas puede proceder de un dataset local de imágenes orientadas o de un servicio de entidades alojado. Al importar fotos a un servicio de entidades alojado, el servicio de entidades debe admitir adjuntos de entidades.

• Utilice el parámetro Sistema de coordenadas de entrada para especificar los sistemas de coordenadas horizontales y verticales de los datos de entrada.

  • Si no se especifica o define ningún sistema de coordenadas en el archivo .e57 de entrada, se supone que los datos de entrada están en el mismo sistema de coordenadas que las entidades de niveles de entrada.
  • Si los datos de entrada y las entidades de niveles de entrada tienen diferentes sistemas de coordenadas, la herramienta volverá a proyectar las ubicaciones de las imágenes importadas.

• Para respaldar el conocimiento de las plantas, esta herramienta agrega un campo LEVEL_ID al dataset de imágenes orientadas al objetivo si no está presente.

• La herramienta asigna Id. de niveles a las imágenes basándose en una comparación de los valores z de las imágenes y las entidades de nivel de la siguiente manera:

  • A una imagen se le asigna el Id. de nivel de la entidad Niveles colocada verticalmente en la imagen o inmediatamente debajo de ella.
  • Cuando una imagen tiene un valor z que la coloca por debajo del nivel más bajo o más de 15 metros por encima del nivel más alto, a la imagen se le asigna un valor de Id. de nivel nulo.
  • A las imágenes que quedan fuera de cualquier entidad de nivel (según las coordenadas x,y) se les asigna un valor de Id. de nivel nulo.

• Si los datos de entrada y las entidades de la capa Levels de entrada tienen orígenes z diferentes, utilice el parámetro Ajuste de elevación para compensar la diferencia. El ajuste de elevación se aplica después de cualquier reproyección necesaria de las ubicaciones de las imágenes.

  Por ejemplo, si los datos de entrada tienen valores z relativos al nivel del mar y las entidades de niveles de entrada tienen valores z relativos al nivel del suelo, utilice un valor negativo del parámetro Ajuste de elevación para compensar la diferencia. El siguiente diagrama es un ejemplo:

  

  Se aplica un ajuste de elevación negativo de -400 m para alinear verticalmente las imágenes con entidades de nivel.

• La herramienta rellena los atributos de entidad de las imágenes orientadas de la siguiente manera:

  • Shape— Los valores de las coordenadas x, y y z se basan en la información de ubicación del archivo de datos de entrada para la imagen.
  • Name— El nombre de la imagen de los metadatos del archivo de datos de entrada. Si no hay metadatos disponibles, se utiliza el nombre del archivo de datos de entrada con valores numéricos incrementales añadidos.

    Nota:

    Este valor puede diferir del nombre del archivo de imagen en el campo ImagePath.

  • LEVEL_ID— El Id. de nivel de la entidad de nivel asociada. Si no se determina ningún nivel asociado, se asigna un valor nulo.
  • ImagePath— La ruta del archivo de imagen asociado con la entidad.
  • AcquisitionDate—La fecha y hora de adquisición de los metadatos del archivo de entrada. Si no hay metadatos disponibles, se utiliza el valor de fecha y hora de la última modificación del archivo de datos de entrada.
  • CameraHeading— La orientación de la cámara se basa en la información de rotación del archivo de datos de entrada para la imagen. Los valores se presentan en grados.
    • Los valores de orientación se miden en el sentido positivo de las agujas del reloj, donde el norte se define como 0 grados.
    • Esta herramienta no rellena los atributos CameraPitch o CameraRoll de las imágenes orientadas.

      Nota:

      La información de la orientación de la cámara puede almacenarse de forma diferente según el software utilizado. Revise el resultado de la herramienta para verificar que los valores CameraHeading sean correctos y use la herramienta Calcular campo para ajustar los valores CameraHeading si es necesario.

  • HorizontalFieldOfView— El alcance de la cámara en la dirección horizontal, en grados.
    • Los valores válidos varían de 0 a 360.
    • De forma predeterminada, esta herramienta asigna un valor de 360. Ajuste este valor utilizando el parámetro Campo de visión horizontal.
  • VerticalFieldOfView— El alcance de la cámara en la dirección vertical, en grados.
    • Los valores válidos varían de 0 a 180.
    • De forma predeterminada, esta herramienta asigna un valor de 180. Ajuste este valor utilizando el parámetro Campo de visión vertical.
  • OrientedImageryType— El tipo de imágenes orientadas. Esta herramienta asigna un valor de 360, lo que indica que las imágenes proporcionan vistas circundantes esféricas o panorámicas.

• La salida de imágenes orientadas de esta herramienta se puede configurar con conocimiento de plantas para su uso con el filtro de planta en mapas que tienen en cuenta las plantas.

• Las imágenes importadas se almacenan como archivos locales en la carpeta especificada para el parámetro Carpeta de imágenes de destino.

  Si el valor del parámetro Imágenes orientadas al objetivo es un dataset local de imágenes orientadas, utilice la herramienta Generar servicio a partir de un dataset de imágenes orientadas para publicar un servicio de entidades alojado con las imágenes importadas.

  Si el valor del parámetro Imágenes orientadas al objetivo es un servicio de entidades alojado, las imágenes importadas se agregan como adjuntos a las entidades de la capa de imágenes orientadas.

• Las entidades existentes en el dataset de imágenes orientadas al objetivo se conservan durante la importación.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Datos de entrada	El archivo .e57 que contiene el archivo de imágenes orientadas al objetivo que se importará.	File
Entidades de nivel de entrada	La capa Levels asociada del modelo de información ArcGIS Indoors que reside en el mismo espacio de trabajo que la capa de imágenes objetivo.	Feature Layer
Carpeta de imágenes de destino	Carpeta existente en la que se escribirán los archivos de imagen.	Folder
Imágenes orientadas objetivo	La capa de imágenes orientadas al objetivo a la que se agregarán las entidades.	Oriented Imagery Layer
Sistema de coordenadas de entrada (Opcional)	La referencia espacial del archivo de imagen de entrada. Se puede seleccionar un sistema de coordenadas si no se especifica ninguno en el archivo de datos de entrada.	Spatial Reference
Ajuste de elevación (Opcional)	El valor por el cual se ajustarán los valores z de las imágenes importadas. Si se vuelven a proyectar las imágenes importadas, el ajuste se aplicará después de la proyección. El valor predeterminado es 0 metros. Un valor de -300 pies reduce el valor z de las imágenes importadas en 300 pies. Un valor de 250 metros aumenta el valor z de las imágenes importadas en 250 metros.	Double
Campo horizontal de visión (Opcional)	El ancho efectivo del campo de visión de imágenes importadas, en grados. Los valores válidos varían de 0 a 360. El valor predeterminado es 360.	Double
Campo de visión vertical (Opcional)	La altura efectiva del campo de visión de imágenes importadas, en grados. Los valores válidos varían de 0 a 180. El valor predeterminado es 180.	Double

Salida derivada

Etiqueta	Explicación	Tipo de datos
Imágenes orientadas al objetivo actualizadas	El dataset de imágenes orientadas actualizado en el espacio de trabajo de Indoors. Los datos de imágenes orientadas existentes se conservan durante la importación. Se incorpora una nueva entidad de punto para cada imagen en los datos de entrada, y la imagen asociada se agrega como un archivo adjunto. Los atributos se establecen en entidades de punto recién agregadas en función de los atributos del archivo de imagen de entrada.	Oriented imagery Layer

Python

arcpy.indoors.ImportIndoorImages(in_data, in_level_features, target_image_folder, target_oriented_imagery, {in_coordinate_system}, {elevation_adjustment}, {horizontal_field_of_view}, {vertical_field_of_view})

Nombre	Explicación	Tipo de datos
in_data	El archivo .e57 que contiene el archivo de imágenes orientadas al objetivo que se importará.	File
in_level_features	La capa Levels asociada del modelo de información ArcGIS Indoors que reside en el mismo espacio de trabajo que la capa de imágenes objetivo.	Feature Layer
target_image_folder	Carpeta existente en la que se escribirán los archivos de imagen.	Folder
target_oriented_imagery	La capa de imágenes orientadas al objetivo a la que se agregarán las entidades.	Oriented Imagery Layer
in_coordinate_system (Opcional)	La referencia espacial del archivo de imagen de entrada. Se puede seleccionar un sistema de coordenadas si no se especifica ninguno en el archivo de datos de entrada.	Spatial Reference
elevation_adjustment (Opcional)	El valor por el cual se ajustarán los valores z de las imágenes importadas. Si se vuelven a proyectar las imágenes importadas, el ajuste se aplicará después de la proyección. El valor predeterminado es 0 metros. Un valor de -300 pies reduce el valor z de las imágenes importadas en 300 pies. Un valor de 250 metros aumenta el valor z de las imágenes importadas en 250 metros.	Double
horizontal_field_of_view (Opcional)	El ancho efectivo del campo de visión de imágenes importadas, en grados. Los valores válidos varían de 0 a 360. El valor predeterminado es 360.	Double
vertical_field_of_view (Opcional)	La altura efectiva del campo de visión de imágenes importadas, en grados. Los valores válidos varían de 0 a 180. El valor predeterminado es 180.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
updated_target_oriented_imagery	El dataset de imágenes orientadas actualizado en el espacio de trabajo de Indoors. Los datos de imágenes orientadas existentes se conservan durante la importación. Se incorpora una nueva entidad de punto para cada imagen en los datos de entrada, y la imagen asociada se agrega como un archivo adjunto. Los atributos se establecen en entidades de punto recién agregadas en función de los atributos del archivo de imagen de entrada.	Oriented imagery Layer

Muestra de código

Ejemplo 1 de ImportIndoorImages (ventana de Python)

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

arcpy.indoors.ImportIndoorImages(r"C:\BuildingScans\BuildingA.e57",
                                 r"C:\IndoorsModel.gdb\Indoors\Levels",
                                 r"C:\indoorsphotos\photos",
                                 r"C:\IndoorsModel.gdb\OIDataset",
                                 '', '', '')

Ejemplo 2 de ImportIndoorImages (ventana de Python)

El siguiente script independiente muestra cómo utilizar la función ImportIndoorImages.

# Import system modules 
import arcpy

#Set parameter values
    in_data=r"C:\BuildingScans\BuildingA.e57"
    in_level_features=r"C:\IndoorsModel.gdb\Indoors\Levels"
    target_image_folder=r"C:\indoorsphotos\photos"
    target_oriented_imagery=r"C:\IndoorsModel.gdb\Indoors\OIDataset"
    in_coordinate_system='PROJCS["NAD_1983_2011_StatePlane_California_VI_FIPS_0406",GEOGCS["GCS_NAD_1983_2011",' \
                           'DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],' \
                           'PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],' \
                           'PROJECTION["Lambert_Conformal_Conic"],PARAMETER["False_Easting",2000000.0],' \
                           'PARAMETER["False_Northing",500000.0],PARAMETER["Central_Meridian",-116.25],' \
                           'PARAMETER["Standard_Parallel_1",32.78333333333333],' \
                           'PARAMETER["Standard_Parallel_2",33.88333333333333],' \
                           'PARAMETER["Latitude_Of_Origin",32.16666666666666],' \
                           'UNIT["Meter",1.0],AUTHORITY["EPSG",6425]]'
    elevation_adjustment="-396 Meters"
    horizontal_field_of_view=360
    vertical_field_of_view=180
    
#Run the tool
ImportIndoorImages_Indoors(in_level_features, target_image_folder, target_oriented_imagery, in_coordinate_system,
                           elevation_adjustment, horizontal_field_of_view, vertical_field_of_view)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: No
• Standard: Requiere ArcGIS Indoors Pro o ArcGIS Indoors Maps
• Advanced: Requiere ArcGIS Indoors Pro o ArcGIS Indoors Maps