Numerar entidades (Defensa)

Resumen

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

Uso

  • Agregar un número secuencial a un campo existente sobrescribirá los valores de ese campo.

  • Las entidades fuera del valor del parámetro Área de entrada a numerar establecerán automáticamente el parámetro Campo a numerar (existente o nuevo) como Nulo.

  • Al especificar un nuevo campo para numerar en el parámetro Campo a numerar (existente o nuevo), la primera letra debe ser un carácter alfanumérico 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 del parámetro Área de entrada a numerar o que se intersequen con él.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada que se numerarán.

Feature Set
Campo a numerar (existente o nuevo)

El campo de entrada que se 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 proporcionará 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.
  • NingunaNo 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 que se utilizará para el nuevo campo. Este parámetro solo se utiliza si el nombre de campo no existe en la tabla de entrada.

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

El valor que se utilizará para iniciar la numeración.

Long
Incremento de
(Opcional)

El valor que se utilizará para incrementar respecto del valor anterior.

Long
Punto central
(Opcional)

El punto central que se utilizará para ordenar y numerar entidades.

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 que se numerarán.

Feature Set
field_to_number

El campo de entrada que se 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 proporcionará 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 que se utilizará para el nuevo campo. Este parámetro solo se utiliza si el nombre de campo no existe en la tabla de entrada.

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

El valor que se utilizará para iniciar la numeración.

Long
increment_by
(Opcional)

El valor que se utilizará para incrementar respecto del valor anterior.

Long
center_point
(Opcional)

El punto central que se utilizará para ordenar y numerar entidades.

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.defense.NumberFeatures("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.management.FeatureToPoint("Buildings_1", result_points)

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