Agregar clase de entidad al terreno (3D Analyst)

Resumen

Agrega una o más feature classes a un terreno dataset.

Uso

• Las entidades de entrada deben residir en el mismo dataset de entidades que el dataset de terreno.

• El dataset de terreno ya debe tener uno o más niveles de pirámide definidos.

• Dependiendo del tipo de superficie asociado con las entidades agregadas a un terreno, puede ser necesario reconstruir el dataset de terreno usando Construir terreno. El cuadro de diálogo Propiedades del dataset de terreno en ArcCatalog y el cuadro de diálogo Propiedades de la capa de terreno en ArcMap proporcionan una indicación de si se debe reconstruir el dataset.

• Considere la posibilidad de habilitar la opción de vista general para los tipos de entidad de línea de corte y superficie de polígono únicamente si las entidades contienen geometría simplificada y son visualmente relevantes para la escala de visualización prevista. Por ejemplo, las líneas de corte podrían no estar lo bastante visibles para importar en una visualización de vista general, mientras que un polígono de recorte resultaría útil. Si la entidad de límite es detallada, considere la posibilidad de generalizarla y use la representación más gruesa para la vista general. La versión detallada se debe usar en escalas de visualización más adecuadas para su resolución de detalle.

• Para los datasets de terreno almacenados en una geodatabase corporativa:

  • El terreno objetivo no puede estar registrado como versionado.
  • La clase de entidad de entrada no se puede registrar como versionada.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Terreno de entrada	El terreno al que se agregarán las clases de entidad. El dataset de terreno ya debe tener uno o más niveles de pirámide creados.	Terrain Layer
Clase de entidad de entrada	Identifica las entidades que se están agregando al terreno. Cada entidad debe residir en el mismo dataset de entidades que el terreno y debe tener su función definida a través de las siguientes propiedades: Input Features—Nombre de la clase de entidad que se está agregando al terreno. Height Field—Campo que contiene la información de altura de la entidad. Puede especificar cualquier campo numérico y las entidades con Z habilitada también pueden elegir el campo de geometría. Si elige la opción <none>, los valores z se interpolan a partir de la superficie. Type—Tipo de entidad de superficie que define cómo contribuyen las entidades al terreno. Los puntos de masa denotan entidades que contribuyen con mediciones z; las líneas de corte denotan entidades lineales con mediciones z conocidas, además de varios tipos de polígono. Las líneas de corte y los tipos de entidad basados en polígonos también tienen calificadores bruscos y suaves que definen el comportamiento de interpolación en torno a los bordes de la entidad cuando se exporta a ráster. Las entidades suaves presentan cambios de pendiente graduales, mientras que las bruscas representan discontinuidades acusadas. Group—Define el grupo de cada entidad contribuyente. La no especificación de líneas de corte y las entidades de superficie de polígono que representan las mismas entidades geográficas a diferentes niveles de detalle se usan para la visualización en determinados rangos de escala. Los datos que representan las mismas entidades geográficas, pero con distintos niveles de detalle se pueden agrupar asignando el mismo valor numérico. Por ejemplo, al asignar dos entidades de límite con un nivel de detalle alto y bajo al mismo grupo, se garantizará que no hay superposición en el rango de escala de visualización asociado. Min/Max Resolution—Define el rango de resoluciones de pirámide en el que se aplicará una entidad en el terreno. Los puntos de masa deben usar el rango de valores más grande y el más pequeño. Overview—Indica si la entidad se aplica en la representación más gruesa del dataset de terreno. Para obtener el máximo rendimiento de visualización, asegúrese de que las clases de entidad representadas en la vista general contienen geometría simplificada. Solo es válido para los tipos de entidad distintos de los puntos de masa. Embed—Al definir esta opción como TRUE, se indica que las entidades de origen se copiarán en una clase de entidad oculta a la que se hará referencia en el terreno y que solo estará disponible para este. Las entidades insertadas no estarán visibles directamente, ya que solo se puede acceder a ellas a través de las herramientas de terreno. Solo es válido para las entidades multipunto. Embed Name—El nombre de la clase de entidad integrada. Solo se aplica si la entidad se está integrando. Embed Fields—Especifica los atributos de campo BLOB que se deben conservar en la clase de entidad integrada. Estos atributos se pueden usar para simbolizar el terreno. La atribución de LAS se puede almacenar en los campos BLOB de entidades multipunto a través de la herramienta De LAS a multipunto. Anchor—Especifica si la clase de entidad de puntos se delimitará en todos los niveles de pirámide de terreno. Los puntos delimitadores nunca se filtran ni se excluyen para garantizar que permanecen en la superficie del terreno. Esta opción solo se aplica a las clases de entidad de un punto.	Value Table

Salida derivada

Etiqueta	Explicación	Tipo de datos
Terreno de entrada actualizado	El terreno actualizado.	Capa de terreno

Python

arcpy.ddd.AddFeatureClassToTerrain(in_terrain, in_features)

Nombre	Explicación	Tipo de datos
in_terrain	El terreno al que se agregarán las clases de entidad. El dataset de terreno ya debe tener uno o más niveles de pirámide creados.	Terrain Layer
in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...]	Identifica las entidades que se están agregando al terreno. Cada entidad debe residir en el mismo dataset de entidades que el terreno y debe tener su función definida a través de las siguientes propiedades: Input Features—Nombre de la clase de entidad que se está agregando al terreno. Height Field—Campo que contiene la información de altura de la entidad. Puede especificar cualquier campo numérico y las entidades con Z habilitada también pueden elegir el campo de geometría. Si elige la opción <none>, los valores z se interpolan a partir de la superficie. Type—Tipo de entidad de superficie que define cómo contribuyen las entidades al terreno. Los puntos de masa denotan entidades que contribuyen con mediciones z; las líneas de corte denotan entidades lineales con mediciones z conocidas, además de varios tipos de polígono. Las líneas de corte y los tipos de entidad basados en polígonos también tienen calificadores bruscos y suaves que definen el comportamiento de interpolación en torno a los bordes de la entidad cuando se exporta a ráster. Las entidades suaves presentan cambios de pendiente graduales, mientras que las bruscas representan discontinuidades acusadas. Group—Define el grupo de cada entidad contribuyente. La no especificación de líneas de corte y las entidades de superficie de polígono que representan las mismas entidades geográficas a diferentes niveles de detalle se usan para la visualización en determinados rangos de escala. Los datos que representan las mismas entidades geográficas, pero con distintos niveles de detalle se pueden agrupar asignando el mismo valor numérico. Por ejemplo, al asignar dos entidades de límite con un nivel de detalle alto y bajo al mismo grupo, se garantizará que no hay superposición en el rango de escala de visualización asociado. Min/Max Resolution—Define el rango de resoluciones de pirámide en el que se aplicará una entidad en el terreno. Los puntos de masa deben usar el rango de valores más grande y el más pequeño. Overview—Indica si la entidad se aplica en la representación más gruesa del dataset de terreno. Para obtener el máximo rendimiento de visualización, asegúrese de que las clases de entidad representadas en la vista general contienen geometría simplificada. Solo es válido para los tipos de entidad distintos de los puntos de masa. Embed—Al definir esta opción como TRUE, se indica que las entidades de origen se copiarán en una clase de entidad oculta a la que se hará referencia en el terreno y que solo estará disponible para este. Las entidades insertadas no estarán visibles directamente, ya que solo se puede acceder a ellas a través de las herramientas de terreno. Solo es válido para las entidades multipunto. Embed Name—El nombre de la clase de entidad integrada. Solo se aplica si la entidad se está integrando. Embed Fields—Especifica los atributos de campo BLOB que se deben conservar en la clase de entidad integrada. Estos atributos se pueden usar para simbolizar el terreno. La atribución de LAS se puede almacenar en los campos BLOB de entidades multipunto a través de la herramienta De LAS a multipunto. Anchor—Especifica si la clase de entidad de puntos se delimitará en todos los niveles de pirámide de terreno. Los puntos delimitadores nunca se filtran ni se excluyen para garantizar que permanecen en la superficie del terreno. Esta opción solo se aplica a las clases de entidad de un punto.	Value Table

Salida derivada

Nombre	Explicación	Tipo de datos
derived_out_terrain	El terreno actualizado.	Capa de terreno

Muestra de código

Ejemplo 1 de AddFeatureClassToTerrain (ventana de Python)

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

arcpy.env.workspace = "C:/data"
terrain_data = ["terrain.gdb/terrainFDS/points2", "SHAPE", "masspoints", 2, 0, 
                10, "true", "false", "points_embed", "<None>", "false"]
arcpy.ddd.AddFeatureClassToTerrain("test.gdb/featuredataset/terrain", terrain_data)

Ejemplo 2 de AddFeatureClassToTerrain (script independiente)

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

"""****************************************************************************
Name: Create Terrain from TIN
Description: This script demonstrates how to create a terrain dataset using
             features extracted from a TIN. It is particularly useful in
             situations where the source data used in the TIN is not available,
             and the amount of data stored in the TIN proves to be too large
             for the TIN. The terrain's scalability will allow improved
             display performance and faster analysis. The script is designed
             to work as a script tool with 5 input arguments.
****************************************************************************"""
# Import system modules
import arcpy

# Set local variables
tin = arcpy.GetParameterAsText(0) # TIN used to create terrain
gdbLocation = arcpy.GetParameterAsText(1) # Folder that will store terran GDB
gdbName = arcpy.GetParameterAsText(2) # Name of terrain GDB
fdName = arcpy.GetParameterAsText(3) # Name of feature dataset
terrainName = arcpy.GetParameterAsText(4) # Name of terrain

try:
    # Create the file gdb that will store the feature dataset
    arcpy.management.CreateFileGDB(gdbLocation, gdbName)
    gdb = '{0}/{1}'.format(gdbLocation, gdbName)
    # Obtain spatial reference from TIN
    SR = arcpy.Describe(tin).spatialReference
    # Create the feature dataset that will store the terrain
    arcpy.management.CreateFeatureDataset(gdb, fdName, SR)
    fd = '{0}/{1}'.format(gdb, fdName)
    # Export TIN elements to feature classes for terrain
    arcpy.AddMessage("Exporting TIN footprint to define terrain boundary...")
    boundary = "{0}/boundary".format(fd)
    # Execute TinDomain
    arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
    arcpy.AddMessage("Exporting TIN breaklines...")
    breaklines = "{0}/breaklines".format(fd)
    # Execute TinLine
    arcpy.ddd.TinLine(tin, breaklines, "Code")
    arcpy.AddMessage("Exporting TIN nodes...")
    masspoints = "{0}/masspoints".format(fd)
    # Execute TinNode
    arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
    arcpy.AddMessage("Creating terrain dataset...")
    terrain = "terrain_from_tin"
    # Execute CreateTerrain
    arcpy.ddd.CreateTerrain(fd, terrainName, 10, 50000, "",
                            "WINDOWSIZE", "ZMEAN", "NONE", 1)
    arcpy.AddMessage("Adding terrain pyramid levels...")
    terrain = "{0}/{1}".format(fd, terrainName)
    pyramids = ["20 5000", "25 10000", "35 25000", "50 50000"]
    # Execute AddTerrainPyramidLevel
    arcpy.ddd.AddTerrainPyramidLevel(terrain, "", pyramids)
    arcpy.AddMessage("Adding features to terrain...")
    inFeatures = "{0} Shape softclip 1 0 10 true false boundary_embed <None> "\
             "false; {1} Shape masspoints 1 0 50 true false points_embed "\
             "<None> false; {2} Shape softline 1 0 25 false false lines_embed "\
             "<None> false".format(boundary, masspoints, breaklines)
    # Execute AddFeatureClassToTerrain
    arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
    arcpy.AddMessage("Building terrain...")
    # Execute BuildTerrain
    arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
    arcpy.GetMessages()

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Entornos

Espacio de trabajo actual, Auto ejecución

Información de licenciamiento

• Basic: Requiere 3D Analyst
• Standard: Requiere 3D Analyst
• Advanced: Requiere 3D Analyst