Numerar entidades (Superposición por pares)

Resumen

Agrega un número secuencial a un campo nuevo o existente de un conjunto de entidades de entrada.

Uso

  • Usar un campo existente para la numeración sobrescribirá los valores de ese campo.

  • Las entidades fuera del valor Área de entrada a numerar tendrán el valor Campo a numerar (existente o nuevo) definido como Nulo.

  • Al especificar un nuevo nombre de campo para numerar en el parámetro Campo a numerar (existente o nuevo), la primera letra debe ser alfa y las letras restantes deben ser caracteres alfanuméricos o guiones bajos.

  • Al numerar entidades que no son puntos, se numerarán todas las entidades contenidas dentro del valor Área de entrada a numerar o que se intersequen con él.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada a numerar.

Feature Set
Campo a numerar (existente o nuevo)

El campo de entrada a numerar. El campo puede ser un campo existente corto, largo o de texto, o bien un campo nuevo.

Field
Área de entrada a numerar
(Opcional)

El área que limitará las entidades a numerar; solo se numerarán las entidades que estén dentro de esta área.

Feature Set
Método de ordenación espacial
(Opcional)

Especifica cuántas entidades se ordenarán espacialmente con fines de numeración. Las entidades no se reordenan en la tabla.

  • Superior derechaLas entidades se ordenarán comenzando en la esquina superior derecha. Esta es la opción predeterminada.
  • Superior izquierdaLas entidades se ordenarán comenzando en la esquina superior izquierda.
  • Inferior derechaLas entidades se ordenarán comenzando en la esquina inferior derecha.
  • Inferior izquierdaLas entidades se ordenarán comenzando en la esquina inferior derecha.
  • Curva de PeanoLas entidades se ordenarán utilizando un algoritmo de curva como relleno de espacio, también conocido como curva de Peano.
  • CentroLas entidades se ordenarán comenzando desde un punto central (si no se proporciona ningún centro, se utilizará el centro medio).
  • Sentido horarioLas entidades se ordenarán comenzando desde un punto central y moviéndose en el sentido de las agujas del reloj.
  • En el sentido contrario a las agujas del relojLas entidades se ordenarán comenzando desde un punto central y moviéndose en sentido contrario a las agujas del reloj.
  • NingunoNo se utilizará ningún orden espacial. Se utilizará el mismo orden que la clase de entidad.
String
Tipo de campo para nuevo campo
(Opcional)

Especifica el tipo de campo del nuevo campo. Este parámetro solo se utiliza si el nombre de campo no existe en la tabla de entrada.

  • CortoEl campo será de tipo corto. Esta es la opción predeterminada.
  • LargoEl campo será de tipo largo.
  • TextoEl campo será de tipo texto.
String
Comienza por
(Opcional)

El valor desde el que empezar a numerar.

Long
Incremento de
(Opcional)

El valor por el que se incrementará desde el valor anterior.

Long
Punto central
(Opcional)

El punto central que se utilizará para clasificar y numerar características.

Feature Set
Agregar distancia y rumbo al centro
(Opcional)

Especifica si se agregarán campos a la salida para la distancia y el rumbo hasta un punto central.

  • No agregue distancia ni rumboNo se agregarán campos de distancia o rumbo a la salida. Esta es la opción predeterminada.
  • Agregue distancia y rumboDIST_TO_CENTER y los campos ANGLE_TO_CENTER se agregarán a la salida.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de salida

La clase de entidad actualizada.

Feature Class

arcpy.defense.NumberFeatures(in_features, field_to_number, {in_area}, {spatial_sort_method}, {new_field_type}, {starting_number}, {increment_by}, {center_point}, {add_distance_and_bearing})
NombreExplicaciónTipo de datos
in_features

Las entidades de entrada a numerar.

Feature Set
field_to_number

El campo de entrada a numerar. El campo puede ser un campo existente corto, largo o de texto, o bien un campo nuevo.

Field
in_area
(Opcional)

El área que limitará las entidades a numerar; solo se numerarán las entidades que estén dentro de esta área.

Feature Set
spatial_sort_method
(Opcional)

Especifica cuántas entidades se ordenarán espacialmente con fines de numeración. Las entidades no se reordenan en la tabla.

  • URLas entidades se ordenarán comenzando en la esquina superior derecha. Esta es la opción predeterminada.
  • ULLas entidades se ordenarán comenzando en la esquina superior izquierda.
  • LRLas entidades se ordenarán comenzando en la esquina inferior derecha.
  • LLLas entidades se ordenarán comenzando en la esquina inferior derecha.
  • PEANOLas entidades se ordenarán utilizando un algoritmo de curva como relleno de espacio, también conocido como curva de Peano.
  • CENTERLas entidades se ordenarán comenzando desde un punto central (si no se proporciona ningún centro, se utilizará el centro medio).
  • CLOCKWISELas entidades se ordenarán comenzando desde un punto central y moviéndose en el sentido de las agujas del reloj.
  • COUNTERCLOCKWISELas entidades se ordenarán comenzando desde un punto central y moviéndose en sentido contrario a las agujas del reloj.
  • NONENo se utilizará ningún orden espacial. Se utilizará el mismo orden que la clase de entidad.
String
new_field_type
(Opcional)

Especifica el tipo de campo del nuevo campo. Este parámetro solo se utiliza si el nombre de campo no existe en la tabla de entrada.

  • SHORTEl campo será de tipo corto. Esta es la opción predeterminada.
  • LONGEl campo será de tipo largo.
  • TEXTEl campo será de tipo texto.
String
starting_number
(Opcional)

El valor desde el que empezar a numerar.

Long
increment_by
(Opcional)

El valor por el que se incrementará desde el valor anterior.

Long
center_point
(Opcional)

El punto central que se utilizará para clasificar y numerar características.

Feature Set
add_distance_and_bearing
(Opcional)

Especifica si se agregarán campos a la salida para la distancia y el rumbo hasta un punto central.

  • DONT_ADD_DISTANCENo se agregarán campos de distancia o rumbo a la salida. Esta es la opción predeterminada.
  • ADD_DISTANCEDIST_TO_CENTER y los campos ANGLE_TO_CENTER se agregarán a la salida.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

La clase de entidad actualizada.

Feature Class

Muestra de código

Ejemplo 1 de NumberFeatures (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función NumberFeatures.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.NumberFeatures_defense("Structures", "structure_number", None, "LL", 
                             "SHORT")
Ejemplo 2 de NumberFeatures (script independiente)

El siguiente ejemplo utiliza la función NumberFeatures en un script de flujo de trabajo de ejemplo.

# Convert building footprints to points and number the points.

# Import modules
import arcpy

# Set workspace
arcpy.env.workspace = r"C:/Data.gdb"

# Get building center points
result_points = "Building_Points"
arcpy.FeatureToPoint_management("Buildings_1", result_points)

# Number the points that represent buildings
arcpy.NumberFeatures_defense(result_points,
                             "building_number",
                             None,
                             "CENTER",
                             "TEXT",
                             25,
                             5,
                             "center_bldg",
                             "ADD_DISTANCE")

Información de licenciamiento

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

Temas relacionados