Agregar información de Z (3D Analyst)

Resumen

Agrega información sobre las propiedades de elevación de las entidades de una clase de entidad con z habilitada.

Se examina cada forma 3D y las propiedades seleccionadas se incorporan a la tabla de atributos de la clase de entidad de entrada. Las opciones de salida varían según la geometría de la entidad.

Uso

  • Están disponibles las siguientes propiedades de z:

    Geometría de entidadPropiedades de z

    Punto

    El valor z del punto.

    Multipunto

    Recuento de puntos y valores z mínimo, máximo y medio de todos los puntos del registro multipunto.

    Polilínea y polígono

    Conteo de vértices y distancia 3D de la línea o el perímetro del polígono.

    Mínimo, máximo y valor medio del valor z y la pendiente de la línea o el perímetro del polígono.

    Multiparche

    Área y volumen de la superficie de un multiparche cerrado.

    Mínimo, máximo y valor medio del valor z y la pendiente a lo largo de la superficie multiparche.

  • La pendiente se obtiene como valor porcentual o grado, y se calcula de un modo distinto para cada tipo de geometría compatible con esta propiedad. Un valor de -1 indica que la entidad es vertical.

    • Los valores de pendiente de las entidades de línea y de los perímetros de polígonos se calculan a lo largo de cada segmento:
      • La pendiente mínima se obtiene desde el segmento cuyo valor es más cercano a 0, o grado horizontal.
      • La pendiente máxima se obtiene desde el segmento con el mayor valor calculado.
      • La pendiente promedio se obtiene promediando la pendiente de todos los segmentos de línea después de ponderar cada segmento por su longitud 3D. Como resultado, los segmentos más largos tienen una influencia mayor que los segmentos más cortos.
    • Los valores de pendiente de las entidades multiparche se calculan para cada cara del triángulo.
      • La pendiente mínima se obtiene de la cara cuyo valor es más cercano a 0, o grado horizontal.
      • La pendiente máxima se obtiene de la cara con el valor más grande.
      • La pendiente promedio se obtiene promediando la pendiente de todas las caras del triángulo después de ponderar cada segmento por su área tridimensional. Como resultado, las áreas más grandes tienen una influencia mayor en el valor resultante que las más pequeñas.
    • Los valores de pendiente de las entidades poligonales se calculan en los bordes usando la misma técnica que se aplica en el caso de los segmentos de línea.
  • El valor z medio para las entidades poligonales se calcula de la misma manera que las entidades de línea. Los interiores de polígonos se ignoran, ya que solo se evalúa el límite. El valor z del punto medio de cada segmento se multiplica por la longitud 3D de ese segmento y se suma el producto de todos los segmentos. A continuación, esta suma se divide entre la longitud 3D total de la entidad de línea o límite del polígono para producir el resultado.

  • El valor z medio de cada entidad multiparche se calcula multiplicando el valor z del punto medio de cada triángulo por el área 3D de ese triángulo. Se suma el producto de todos los triángulos de una entidad concreta y, a continuación, se divide entre el área total de superficie 3D de la entidad multiparche para producir el resultado.

  • El volumen solo se puede calcular para los multiparches cerrados. Una entidad multiparche abierta devolverá un valor 0.0. En la plataforma Solaris, una limitación de diseño impide actualmente que la herramienta determine si un multiparche es cerrado y, como resultado, las mediciones de volumen se calculan para todos los multiparches suponiendo que son cerrados.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada que se van a procesar.

Feature Layer
Propiedad de salida

Especifica las propiedades de z que se agregarán a la tabla de atributos de la clase de entidad de entrada.

  • Punto ZElevación puntual de las entidades de un punto.
  • Recuento de puntosNúmero de puntos de cada entidad multipunto.
  • Z más bajoValor z más bajo encontrado en cada entidad poligonal, multiparche, de multipunto o de polilínea.
  • Z más altoValor z más alto encontrado en cada entidad poligonal, multiparche, de multipunto o de polilínea.
  • Z promedioValor z promedio encontrado en cada entidad poligonal, multiparche, de multipunto o de polilínea.
  • Longitud tridimensionalLongitud tridimensional de cada entidad de polilínea o de polígono.
  • Área de superficieÁrea total de la superficie de una entidad multiparche.
  • conteo de vérticesNúmero total de vértices de cada entidad de polilínea o de polígono.
  • Pendiente más bajaValor de pendiente más bajo calculado para cada entidad de polilínea, polígono o multiparche.
  • Pendiente más altaValor de pendiente más alto calculado para cada entidad de polilínea, polígono o multiparche.
  • Pendiente mediaValor de pendiente promedio calculado para cada entidad de polilínea, polígono o multiparche.
  • VolumenVolumen del espacio rodeado por cada entidad multiparche.
String
Filtrado de ruido
(Opcional)

Un valor numérico que se utilizará para excluir porciones de entidades de los cálculos resultantes. Puede ser útil cuando la entrada 3D contiene entidades relativamente pequeñas con pendientes extremas que pueden sesgar los resultados estadísticos. Si la unidad lineal de la entrada 3D es el metro, especificar un valor de 0,001 causará la exclusión de las líneas o bordes de polígono cuya longitud sea inferior a 0,001 metros. En el caso de las entidades multiparche, este mismo valor causará la exclusión de las subpartes cuya área sea inferior a 0,001 metros cuadrados. Este parámetro no se aplica a las entidades de punto y multipunto.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidades de entrada actualizadas

La clase de entidad con z habilitada actualizada.

Feature Layer

arcpy.ddd.AddZInformation(in_feature_class, out_property, {noise_filtering})
NombreExplicaciónTipo de datos
in_feature_class

Las entidades de entrada que se van a procesar.

Feature Layer
out_property
[out_property,...]

Especifica las propiedades de z que se agregarán a la tabla de atributos de la clase de entidad de entrada.

  • ZElevación puntual de las entidades de un punto.
  • POINT_COUNTNúmero de puntos de cada entidad multipunto.
  • Z_MINValor z más bajo encontrado en cada entidad poligonal, multiparche, de multipunto o de polilínea.
  • Z_MAXValor z más alto encontrado en cada entidad poligonal, multiparche, de multipunto o de polilínea.
  • Z_MEANValor z promedio encontrado en cada entidad poligonal, multiparche, de multipunto o de polilínea.
  • LENGTH_3DLongitud tridimensional de cada entidad de polilínea o de polígono.
  • SURFACE_AREAÁrea total de la superficie de una entidad multiparche.
  • VERTEX_COUNTNúmero total de vértices de cada entidad de polilínea o de polígono.
  • MIN_SLOPEValor de pendiente más bajo calculado para cada entidad de polilínea, polígono o multiparche.
  • MAX_SLOPEValor de pendiente más alto calculado para cada entidad de polilínea, polígono o multiparche.
  • AVG_SLOPEValor de pendiente promedio calculado para cada entidad de polilínea, polígono o multiparche.
  • VOLUMEVolumen del espacio rodeado por cada entidad multiparche.
String
noise_filtering
(Opcional)

Un valor numérico que se utilizará para excluir porciones de entidades de los cálculos resultantes. Puede ser útil cuando la entrada 3D contiene entidades relativamente pequeñas con pendientes extremas que pueden sesgar los resultados estadísticos. Si la unidad lineal de la entrada 3D es el metro, especificar un valor de 0,001 causará la exclusión de las líneas o bordes de polígono cuya longitud sea inferior a 0,001 metros. En el caso de las entidades multiparche, este mismo valor causará la exclusión de las subpartes cuya área sea inferior a 0,001 metros cuadrados. Este parámetro no se aplica a las entidades de punto y multipunto.

String

Salida derivada

NombreExplicaciónTipo de datos
output_feature_class

La clase de entidad con z habilitada actualizada.

Feature Layer

Muestra de código

Ejemplo 1 de AddZInformation (ventana de Python)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.AddZInformation('lines_3D.shp', 'Z_MEAN; LENGTH_3D; AVG_SLOPE', 
                        'NO_FILTER')
Ejemplo 2 de AddZInformation (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

'''******************************************************************
Name: AddZInformation Example
Description: This script demonstrates AddZInformation on all 
             z-aware features in a target workspace.
******************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'
# Create list of feature classes
fcList = arcpy.ListFeatureClasses()
if fcList:
    for fc in fcList:
        desc = arcpy.Describe(fc)
        if desc.hasZ:
            # Set Local Variables
            noise = 'No_Filter'
            if desc.shapeType == 'Polygon':
                Prop = ['Z_MIN', 'Z_MAX', 'VERTEX_COUNT']
            elif desc.shapeType == 'Point':
                Prop = 'Z'
            elif desc.shapeType == 'Multipoint':
                Prop = ['Z_MIN', 'Z_MAX', 'Z_MEAN']
            elif desc.shapeType == 'Polyline':
                Prop = 'LENGTH_3D'
            print('Completed adding Z information.')
            # Execute AddZInformation
            arcpy.ddd.AddZInformation(inFC, Prop, noise)

Información de licenciamiento

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

Temas relacionados