Crear contenido de capas de escena de malla integrada (Administración de datos)

Resumen

Crea contenido de capas de escena (.slpk o .i3sREST) a partir de datos binarios de OpenSceneGraph (OSGB).

Uso

  • De forma similar a otros formatos de gráficos 3D, el formato de datos OSGB no admite de forma nativa la especificación ni la captura del sistema de coordenadas del modelo. Típicamente, los archivos con formato OSGB se generan en un sistema de coordenadas cartesianas que localiza los datos en coordenadas fijas. Las coordenadas x, y, y z del modelo no son inherentemente localizaciones geográficas. Son localizaciones relativas a un origen geométrico arbitrario (0, 0, 0). Un sistema de coordenadas típico utilizado para tales modelos es la convención Este-valor Norte-arriba (ENU), en la que el eje x puede estar considerado como una dirección de valor este y el eje y como una dirección de valor norte, con el eje z hacia arriba. Para georreferenciar correctamente el modelo, se requieren metadatos adicionales .xml, .3mx o un archivo de georreferenciación (.wld3) que se pueda colocar junto a la carpeta que contiene los archivos con formato OSGB, o bien que se pueda especificar con el parámetro Punto de anclaje.

  • Si no existe ningún archivo para georreferenciar el modelo, se puede crear un archivo .wld3 para especificar el origen. Este archivo delimitado por espacios o comas se puede formatear en grados decimales como <From x,y,z> <space> <To x,y,z>.

    Un archivo de georreferenciación de ejemplo para georreferenciar el modelo. Tan solo un par de coordenadas debe contener las coordenadas del punto de anclaje.

    0, 0, 0 -117.17222, 34.0392512, 0
  • Si los archivos con formato OSGB se crearon con un sistema de coordenadas conocido, coloque el archivo de proyección (.prj) junto a la carpeta que incluye los archivos con formato OSGB para georreferenciar correctamente el modelo. Por ejemplo, si la ruta del archivo de entrada es C:\temp\data y los archivos con formato OSGB están en las subcarpetas C:\temp\data\Tile_001 y C:\temp\data\Tile_002, coloque el archivo de proyección o de metadatos en la carpeta C:\temp\data.

  • La siguiente tabla muestra el archivo de georreferenciación que se va a utilizar para cada sistema de coordenadas de entrada del modelo OSGB:

    Sistema de coordenadas de entradaArchivo de georreferenciación

    Sistema de coordenadas local (ENU)

    Archivo .xml, .wld3 o .3mx, o clase de entidad de puntos

    Sistema de coordenadas proyectadas

    Archivo de proyección (.prj)

    Sistema de coordenadas geográficas

    Archivo de proyección (.prj)

  • Utilice el parámetro Tamaño máximo de textura para establecer el tamaño de textura por nodo en el paquete de capas de escena de salida. Es posible que los tamaños de textura mayores de 4096 no se admitan en todas las plataformas. Scene Viewer admite un tamaño máximo de textura de 8192.

  • Drone2Map y los proveedores externos crean los archivos con formato OSGB. Para ver una lista completa de dichos proveedores, consulte Capa de escena de malla integrada.

  • Use el parámetro Conexión a la nube de destino para enviar contenido de la capa de escena a un almacén de objetos ubicado en la nube, como Amazon S3, almacenamiento de Blob de Azure, Alibaba OSS o Google Cloud. Este contenido se puede publicar como un servicio de escena y la ubicación que elija debe estar registrada como un data store administrado por el usuario en ArcGIS Enterprise.

  • Puede crear un archivo de conexión (.acs) utilizando la herramienta Crear archivo de conexión de almacenamiento en la nube.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de entrada

Archivos con formato OSGB, o carpetas que contienen archivos con formato OSGB, que se importarán en el paquete de capas de escena de malla integrada. Este parámetro permite seleccionar varios archivos con formato OSGB o una selección de varias carpetas que contienen archivos con formato OSGB.

File; Folder
Paquete de capas de escena de salida
(Opcional)

Paquete de capas de escena de malla integrada que se creará. Este parámetro es obligatorio si no se ha especificado un valor para el parámetro Conexión a la nube de destino.

File
Punto de anclaje
(Opcional)

Entidad de punto, .3mx, .xml o archivo de .wld3 que se utilizará para posicionar el centro del modelo OSGB. Si existen varios puntos en la clase de entidad, solo se utilizará el primer punto para georreferenciar los datos.

Feature Layer; File
Sufijo del archivo
(Opcional)

Especifica los archivos que se procesarán para el dataset de entrada.

  • Todos los archivos compatiblesTodos los archivos binarios, independientemente de su extensión, se procesarán para determinar si presentan el formato OSGB.
  • Archivos con la extensión *.osgbSolo se procesarán los archivos con la extensión .osgb.
String
Sistema de coordenadas de salida
(Opcional)

El sistema de coordenadas del paquete de capas de escenas de salida. Puede ser cualquier sistema de coordenadas proyectadas o personalizadas. Entre los sistemas de coordenadas geográficas admitidos están WGS84 y el Sistema de coordenadas geodésicas de China de 2000. WGS84 y EGM96 Geoid son los sistemas de coordenadas horizontales y verticales predeterminados, respectivamente. Puede especificar el sistema de coordenadas de cualquiera de estas maneras:

  • Especifique la ruta a un archivo .prj.
  • Haga referencia a un dataset con el sistema de coordenadas correcto.
  • Utilice un objeto arcpy.SpatialReference.

Spatial Reference
Tamaño de textura máximo
(Opcional)

Tamaño de textura máximo en píxeles de cada nodo de capa de escena.

Long
Optimización de textura
(Opcional)

Especifica las texturas que se optimizarán de acuerdo con la plataforma de destino en la que se utiliza el paquete de capas de escena.

Precaución:

El procesamiento de las optimizaciones que contienen KTX2 puede requerir un tiempo considerable. Para obtener los resultados más rápidos, utilice las opciones Escritorio o Ninguno.

  • TodasSe optimizarán todos los formatos de textura, incluidos JPEG, DXT y KTX2 para su uso en escritorio, web y plataformas móviles.
  • EscritorioSe optimizarán las texturas compatibles con Windows, Linux y Mac, incluidos JPEG y DXT, para su uso en clientes de ArcGIS AllSource en equipos de sobremesa Windows y ArcGIS Maps SDKs en Windows, Linux y Mac. Esta es la opción predeterminada.
  • MóvilSe optimizarán las texturas compatibles con Android e iOS, incluidos JPEG y KTX2, para su uso en aplicaciones móviles de Maps SDKs.
  • NingunaSe optimizarán texturas JPEG para su uso en escritorio y plataformas web.
String
Conexión a la nube de destino
(Opcional)

El archivo de conexión a la nube de destino (.acs) donde se generará el contenido de la capa de escena (.i3sREST).

Folder
Nombre de salida
(Opcional)

El nombre de salida del contenido de la capa de escena cuando se produce la salida a un almacén en la nube. Este parámetro solo está disponible si se ha especificado un valor para el parámetro Conexión a la nube de destino.

String

arcpy.management.CreateIntegratedMeshSceneLayerPackage(in_dataset, {out_slpk}, {anchor_point}, {file_suffix}, {out_coor_system}, {max_texture_size}, {texture_optimization}, {target_cloud_connection}, {out_name})
NombreExplicaciónTipo de datos
in_dataset
[in_dataset,...]

Archivos con formato OSGB, o carpetas que contienen archivos con formato OSGB, que se importarán en el paquete de capas de escena de malla integrada. Este parámetro permite seleccionar varios archivos con formato OSGB o una selección de varias carpetas que contienen archivos con formato OSGB.

File; Folder
out_slpk
(Opcional)

Paquete de capas de escena de malla integrada que se creará. Este parámetro es obligatorio si no se ha especificado un valor para el parámetro Conexión a la nube de destino.

File
anchor_point
(Opcional)

Entidad de punto, .3mx, .xml o archivo de .wld3 que se utilizará para posicionar el centro del modelo OSGB. Si existen varios puntos en la clase de entidad, solo se utilizará el primer punto para georreferenciar los datos.

Feature Layer; File
file_suffix
(Opcional)

Especifica los archivos que se procesarán para el dataset de entrada.

  • *Todos los archivos binarios, independientemente de su extensión, se procesarán para determinar si presentan el formato OSGB.
  • osgbSolo se procesarán los archivos con la extensión .osgb.
String
out_coor_system
(Opcional)

El sistema de coordenadas del paquete de capas de escenas de salida. Puede ser cualquier sistema de coordenadas proyectadas o personalizadas. Entre los sistemas de coordenadas geográficas admitidos están WGS84 y el Sistema de coordenadas geodésicas de China de 2000. WGS84 y EGM96 Geoid son los sistemas de coordenadas horizontales y verticales predeterminados, respectivamente. Puede especificar el sistema de coordenadas de cualquiera de estas maneras:

  • Especifique la ruta a un archivo .prj.
  • Haga referencia a un dataset con el sistema de coordenadas correcto.
  • Utilice un objeto arcpy.SpatialReference.

Spatial Reference
max_texture_size
(Opcional)

Tamaño de textura máximo en píxeles de cada nodo de capa de escena.

Long
texture_optimization
(Opcional)

Especifica las texturas que se optimizarán de acuerdo con la plataforma de destino en la que se utiliza el paquete de capas de escena.

Precaución:

El procesamiento de las optimizaciones que contienen KTX2 puede requerir un tiempo considerable. Para obtener los resultados más rápidos, utilice las opciones Desktop o None.

  • AllSe optimizarán todos los formatos de textura, incluidos JPEG, DXT y KTX2 para su uso en escritorio, web y plataformas móviles.
  • DesktopSe optimizarán las texturas compatibles con Windows, Linux y Mac, incluidos JPEG y DXT, para su uso en clientes de ArcGIS AllSource en equipos de sobremesa Windows y ArcGIS Maps SDKs en Windows, Linux y Mac. Esta es la opción predeterminada.
  • MobileSe optimizarán las texturas compatibles con Android e iOS, incluidos JPEG y KTX2, para su uso en aplicaciones móviles de Maps SDKs.
  • NoneSe optimizarán texturas JPEG para su uso en escritorio y plataformas web.
String
target_cloud_connection
(Opcional)

El archivo de conexión a la nube de destino (.acs) donde se generará el contenido de la capa de escena (.i3sREST).

Folder
out_name
(Opcional)

El nombre de salida del contenido de la capa de escena cuando se produce la salida a un almacén en la nube. Este parámetro solo está disponible si se ha especificado un valor para el parámetro target_cloud_connection.

String

Muestra de código

Ejemplo 1 de CreateIntegratedMeshSceneLayerPackage (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.managementCreateIntegratedMeshSceneLayerPackage(
    "terrain_osgb", "mesh.slpk", "anchor.wld3", "OSGB", arcpy.SpatialReference(4326))
Ejemplo 2 de CreateIntegratedMeshSceneLayerPackage (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python con una entrada de varias carpetas.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.managementCreateIntegratedMeshSceneLayerPackage(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP")
Ejemplo 3 de CreateIntegratedMeshSceneLayerPackage (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python con una salida a un almacén en la nube.

import arcpy
arcpy.env.workspace = "C:/temp"
arcpy.managementCreateIntegratedMeshSceneLayerPackage(
    ["Tile_+001_+001", "Tile_+001_+002", "Tile_+002_+001"], "mesh.slpk", 
    "anchor.shp", "OSGB", arcpy.SpatialReference(4326), 2048, "DESKTOP",
    'AWS.acs', 'mySceneLayer.i3srest')