Importar objetos 3D (Administración de datos)

Resumen

Importa modelos 3D desde uno o más formatos de archivo 3D y crea o actualiza una capa de entidades de objetos 3D.

Uso

  • La clase de entidad de objeto 3D proporciona una forma de almacenar, georreferenciar y visualizar modelos 3D en ArcGIS Pro utilizando sus capacidades de representación en pantalla nativas, como efectos de luz, reflectancia y materiales.

    Más información sobre la capa de entidades de objetos 3D

  • La geometría de una clase de entidad de objeto 3D se puede utilizar en cualquier herramienta de geoprocesamiento que admita entidades multiparche. Por ejemplo, se puede utilizar una capa de entidades de objetos 3D para analizar líneas de visión en Línea de visión e Intervisibilidad, o determinar el impacto de las sombras en Frecuencia de sombra del sol y Volumen de sombra del sol.

  • Con esta herramienta, puede crear capas de entidades de objetos 3D directamente sin tener que importar los modelos 3D a un multiparche o mejorar el multiparche con capacidades de capa de entidades de objetos 3D. Esta herramienta también admite más formatos de modelos 3D que la herramienta Importar archivos 3D. Se pueden importar los siguientes formatos 3D:

    • COLLADA (.dae)
    • Drawing (.dwg)
    • Autodesk Filmbox (.fbx)
    • Graphics Library Transmission (.glb)
    • JSON Graphics Library Transmission (.gltf)
    • Industry Foundation Class (.ifc)
    • Wavefront Object (.obj)
    • Universal Scene Description (.usdc)
    • Compressed Universal Scene Description (.usdz)
  • Cuando se crea una clase de entidad de objeto 3D y los modelos que se importan tienen una referencia espacial, la clase de entidad de objeto 3D heredará el sistema de coordenadas de los modelos. Si los modelos que está importando no tienen un sistema de coordenadas, el sistema de coordenadas de salida será WGS 1984 Web Mercator (WKID 3857), que utiliza una unidad lineal de metros. Si los modelos 3D tienen una unidad lineal, sus coordenadas se convertirán automáticamente para que coincidan con la proyección de salida. Cuando los modelos 3D no tienen unidades lineales definidas, se puede utilizar el parámetro Factor de escala para aplicar la conversión adecuada.

Parámetros

EtiquetaExplicaciónTipo de datos
Archivos y carpetas 3D de entrada

Las carpetas o archivos 3D que contienen los archivos 3D que se importarán. Cuando se proporciona una carpeta, se importarán todos los modelos 3D compatibles que contiene y sus subdirectorios.

Se admiten los siguientes modelos:

  • COLLADA (.dae)
  • Drawing (.dwg)
  • Autodesk Filmbox (.fbx)
  • Graphics Library Transmission (.glb)
  • JSON Graphics Library Transmission (.gltf)
  • Industry Foundation Class (.ifc)
  • Wavefront Object (.obj)
  • Universal Scene Description (.usdc)
  • Compressed Universal Scene Description (.usdz)
File; Folder
Clase de entidad Objeto 3D de salida

La capa de entidades del objeto 3D que se creará o actualizará.

Feature Layer
Actualizar estrategia
(Opcional)

Especifica cómo se actualizará una clase de entidad de objeto 3D existente.

  • Reemplazar todos los modelos existentesSe eliminarán todas las entidades existentes en la clase de entidad del objeto 3D y solo se agregarán los modelos 3D que se especifican como entrada.
  • Actualizar solo los modelos existentesSe actualizarán los modelos 3D que existen en la clase de entidad de objeto 3D. Se omitirán los nuevos modelos.
  • Actualizar modelos existentes y agregar nuevosLos modelos 3D que existen en la clase de entidad de objeto 3D se actualizarán y se agregarán nuevos modelos. Esta es la opción predeterminada.
  • Agregar todos los modelosTodos los modelos 3D se agregarán sin reemplazar ninguno que exista actualmente en la clase de entidad de objeto 3D.
String
Desplazamiento XY
(Opcional)

El desplazamiento de las coordenadas x e y que se aplicará a los modelos importados.

Point
Desplazamiento de elevación
(Opcional)

El desplazamiento de altura que se aplicará a los modelos importados.

Double
Factor de escala
(Opcional)

El factor de escala que se utilizará para cambiar el tamaño de los modelos 3D que se importan.

Double
Ángulo de rotación
(Opcional)

El ángulo de rotación en grados que se aplicará a los modelos importados. La rotación se aplica asumiendo que cero grados (0°) representa el norte y los valores angulares se incrementan en el sentido de las agujas del reloj.

Double
Y está activo si no se especifica mediante datos

Especifica si las coordenadas y se interpretarán como altura o a lo largo del plano horizontal. Este parámetro solo es compatible con archivos de Wavefront Object (.obj).

  • Activado: las coordenadas Y se interpretarán como altura. Esta es la opción predeterminada.
  • Desactivado: las coordenadas Z se interpretarán como altura.

Boolean

arcpy.management.Import3DObjects(files_and_folders, updated_features, {update}, {translate}, {elevation}, {scale}, {rotate}, y_is_up)
NombreExplicaciónTipo de datos
files_and_folders
[files_and_folders,...]

Las carpetas o archivos 3D que contienen los archivos 3D que se importarán. Cuando se proporciona una carpeta, se importarán todos los modelos 3D compatibles que contiene y sus subdirectorios.

Se admiten los siguientes modelos:

  • COLLADA (.dae)
  • Drawing (.dwg)
  • Autodesk Filmbox (.fbx)
  • Graphics Library Transmission (.glb)
  • JSON Graphics Library Transmission (.gltf)
  • Industry Foundation Class (.ifc)
  • Wavefront Object (.obj)
  • Universal Scene Description (.usdc)
  • Compressed Universal Scene Description (.usdz)
File; Folder
updated_features

La capa de entidades del objeto 3D que se creará o actualizará.

Feature Layer
update
(Opcional)

Especifica cómo se actualizará una clase de entidad de objeto 3D existente.

  • REPLACE_ALLSe eliminarán todas las entidades existentes en la clase de entidad del objeto 3D y solo se agregarán los modelos 3D que se especifican como entrada.
  • UPDATE_EXISTINGSe actualizarán los modelos 3D que existen en la clase de entidad de objeto 3D. Se omitirán los nuevos modelos.
  • UPDATE_EXISTING_ADD_NEWLos modelos 3D que existen en la clase de entidad de objeto 3D se actualizarán y se agregarán nuevos modelos. Esta es la opción predeterminada.
  • ADD_ALLTodos los modelos 3D se agregarán sin reemplazar ninguno que exista actualmente en la clase de entidad de objeto 3D.
String
translate
(Opcional)

El desplazamiento de las coordenadas x e y que se aplicará a los modelos importados.

Point
elevation
(Opcional)

El desplazamiento de altura que se aplicará a los modelos importados.

Double
scale
(Opcional)

El factor de escala que se utilizará para cambiar el tamaño de los modelos 3D que se importan.

Double
rotate
(Opcional)

El ángulo de rotación en grados que se aplicará a los modelos importados. La rotación se aplica asumiendo que cero grados (0°) representa el norte y los valores angulares se incrementan en el sentido de las agujas del reloj.

Double
y_is_up

Especifica si las coordenadas y se interpretarán como altura o a lo largo del plano horizontal. Este parámetro solo es compatible con archivos de Wavefront Object (.obj).

  • Y_IS_UPLas coordenadas Y se interpretarán como altura. Esta es la opción predeterminada.
  • Z_IS_UPLas coordenadas Y se interpretarán como altura.
Boolean

Muestra de código

Ejemplo de Import3DObjects (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:/project_directory'

arcpy.management.Import3DObjects("import_models", 
                                 "city_models.gdb/Downtown_Buildings", 
                                 update="ADD_ALL", translate="50 100.5", 
                                 elevation=-52.73, scale=0.3048, rotate=15.25)
Ejemplo de Import3DObjects (flujo de trabajo)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

import arcpy
arcpy.env.workspace = 'C:/project_directory'

# Export the feature class or layer to model files on disk
arcpy.management.Export3DObjects("city_models.gdb/Downtown_Buildings", 
                                 "exported_models", ["FMT3D_IFC"])

# Optionally, edit the exported model files in other software, or replace the 
# files with a new version. 
# Keep the file names the same to update existing features. New file names are
# interpreted as new features.

# The input folder and feature class or layer in Import 3D Objects are the same
# values used in Export 3D Objects.
arcpy.management.Import3DObjects("exported_models", 
                                 "city_models.gdb/Downtown_Buildings", 
                                 update="UPDATE_EXISTING_ADD_NEW", 
                                 translate="350 150",
                                 elevation=100, scale=2.54, rotate=-90)

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados