Numerar entidades por sector (Defensa)

Resumen

Agrega un número secuencial a un campo nuevo o existente de un conjunto de entidades de entrada según una agrupación geográfica a la que pertenecen las entidades.

Uso

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

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

  • Las entidades fuera del valor del parámetro Polígonos de sector establecerán automáticamente el parámetro Campo a numerar (existente o nuevo) como nulo.

  • Al numerar entidades que no son puntos, se numerarán todas las entidades contenidas en el valor del parámetro Polígonos de sector o que se intersequen con él.

  • Cada sector inicia una nueva secuencia numérica basada en un valor de incremento.

  • El parámetro Método de ordenación espacial estará inactivo si existe un campo SortMethod en el valor del parámetro Polígonos de sector. En su lugar, se utilizarán los valores del campo SortMethod. Los valores válidos para el campo SortMethod son los siguientes:

    • UR: las entidades se ordenarán comenzando en la esquina superior derecha.
    • UL: las entidades se ordenarán comenzando en la esquina superior izquierda.
    • LR: las entidades se ordenarán comenzando en la esquina inferior derecha.
    • LL: las entidades se ordenarán comenzando en la esquina inferior derecha.
    • PEANO: las entidades se ordenarán utilizando un algoritmo de curva como relleno de espacio, también conocido como curva de Peano.
    • CENTER: las entidades se ordenarán comenzando desde un punto central (si no se proporciona ningún centro, se utilizará el centro medio).
    • CLOCKWISE: las entidades se ordenarán comenzando desde un punto central y moviéndose en el sentido de las agujas del reloj.
    • COUNTERCLOCKWISE: las entidades se ordenarán comenzando desde un punto central y moviéndose en sentido contrario a las agujas del reloj.
    • NONE: no se utilizará ningún orden espacial. Se utilizará el mismo orden que la clase de entidad.

  • El parámetro Incrementar sectores por estará inactivo si existe un campo StartNumber en el valor del parámetro Polígonos de sector. En su lugar, se utilizarán los valores del campo StartNumber. El tipo de campo StartNumber debe ser Largo.

  • Los siguientes métodos de ordenación no utilizan un punto central y se aplican por sector:

    • Superior derecha
    • Superior izquierda
    • Inferior derecha
    • Inferior izquierda
    • Curva de Peano

  • Los siguientes métodos de ordenación se aplican por sector cuando el valor del parámetro Punto central no está especificado:

    • Centro
    • Sentido horario
    • En el sentido contrario a las agujas del reloj

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada que se numerarán.

Feature Set
Polígonos de sector

Los polígonos de entrada que representan los sectores que se utilizarán para la numeració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
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 campo será de tipo corto. Esta es la opción predeterminada.
  • LargoEl campo será de tipo largo.
  • TextoEl campo será de tipo texto.
String
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
Incrementar sectores por
(Opcional)

El valor que se utilizará para incrementar desde el sector 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.NumberFeaturesBySector(in_features, sector_polygons, field_to_number, {new_field_type}, {spatial_sort_method}, {increment_by}, {center_point}, {add_distance_and_bearing})
NombreExplicaciónTipo de datos
in_features

Las entidades de entrada que se numerarán.

Feature Set
sector_polygons

Los polígonos de entrada que representan los sectores que se utilizarán para la numeració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
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 campo será de tipo corto. Esta es la opción predeterminada.
  • LONGEl campo será de tipo largo.
  • TEXTEl campo será de tipo texto.
String
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. Si existe un campo SortMethod en la entrada de sector_polygons, ese valor se utilizará en su lugar.

  • 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
increment_by
(Opcional)

El valor que se utilizará para incrementar desde el sector anterior. Si existe un campo StartNumber en la entrada de sector_polygons, ese valor se utilizará en su lugar.

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 NumberFeaturesBySector (ventana de Python)

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.NumberFeaturesBySector_defense("bldg_footprints", "sectors", "bldg_number")
Ejemplo 2 de NumberFeaturesBySector (secuencias de comandos independientes)

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

# Assign buildings a number based on their sector and export the first building in sector 700

# Import modules
import arcpy

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

# Number the buildings by sector
arcpy.NumberFeaturesBySector_defense("bldg_footprints",
                                     "sectors",
                                     "bldg_number",
                                     "LONG",
                                     "CENTER",
                                     100,
                                     "neighborhood_center",
                                     "DONT_ADD_DISTANCE")

# Select the first building in sector 700
select_from = "bldg_footprints"
expression = "bldg_number = 700"
arcpy.SelectLayerByAttribute_management(select_from,
                                        "NEW_SELECTION",
                                        expression)

# Export to new feature class
arcpy.FeatureClassToFeatureClass_conversion(select_from,
                                            arcpy.env.workspace,
                                            "bldg700")