Agregar clase de entidad al terreno (3D Analyst)

Resumen

Agrega una o más clases de entidad a un dataset de terreno.

Uso

Sintaxis

AddFeatureClassToTerrain_3d (in_terrain, in_features)
ParámetroExplicaciónTipo 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:

  • Entidades de entradaNombre de la clase de entidad que se está agregando al terreno.
  • Campo de alturaCampo que contiene la información de altura de la entidad. Se puede especificar cualquier campo numérico, y las entidades habilitadas para Z también pueden elegir el campo de geometría. Si se elige la opción <none>, los valores Z se interpolan a partir de la superficie.
  • Tipo de entidad de superficieTipo 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.
  • GrupoDefine 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.
  • Resolución mínima/máximaDefine 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.
  • Vista generalIndica 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.
  • IncorporarAl 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.
  • Nombre incluidoEl nombre de la clase de entidad integrada. Solo se aplica si la entidad se está integrando.
  • Integrar camposEspecifica 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 las entidades multipunto a través de la herramienta LAS a multipunto.
  • DelimitadorEspecifica 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

Ejemplo de código

Ejemplo 1 de AddFeatureClassToTerrain (ventana de Python)

El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana Python:

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
params = "terrain.gdb/terrainFDS/points2 SHAPE masspoints 2 0 10 true false "\
       "points_embed <None> false"
arcpy.AddFeatureClassToTerrain_3d("test.gdb/featuredataset/terrain", params)
Ejemplo 2 de AddFeatureClassToTerrain (secuencia de comandos independiente)

El siguiente ejemplo 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
import exceptions, sys, traceback
from arcpy import env

# 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:
    arcpy.CheckOutExtension("3D")
    # 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:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = "PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}"\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = "ArcPy ERRORS:\n {0}\n".format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)
finally:
    arcpy.CheckInExtension("3D")

Entornos

Temas relacionados

9/11/2013