Numerar entidades por sector (Superposición por pares)

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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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. Corto—El campo será de tipo corto. Esta es la opción predeterminada. Largo—El campo será de tipo largo. Texto—El 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 derecha—Las entidades se ordenarán comenzando en la esquina superior derecha. Esta es la opción predeterminada. Superior izquierda—Las entidades se ordenarán comenzando en la esquina superior izquierda. Inferior derecha—Las entidades se ordenarán comenzando en la esquina inferior derecha. Inferior izquierda—Las entidades se ordenarán comenzando en la esquina inferior derecha. Curva de Peano—Las entidades se ordenarán utilizando un algoritmo de curva como relleno de espacio, también conocido como curva de Peano. Centro—Las entidades se ordenarán comenzando desde un punto central (si no se proporciona ningún centro, se utilizará el centro medio). Sentido horario—Las 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 reloj—Las entidades se ordenarán comenzando desde un punto central y moviéndose en sentido contrario a las agujas del reloj. Ninguno—No 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 rumbo—No se agregarán campos de distancia o rumbo a la salida. Esta es la opción predeterminada. Agregue distancia y rumbo—DIST_TO_CENTER y los campos ANGLE_TO_CENTER se agregarán a la salida.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de salida	La clase de entidad actualizada.	Feature Class

Python

arcpy.defense.NumberFeaturesBySector(in_features, sector_polygons, field_to_number, {new_field_type}, {spatial_sort_method}, {increment_by}, {center_point}, {add_distance_and_bearing})

Nombre	Explicación	Tipo 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. SHORT—El campo será de tipo corto. Esta es la opción predeterminada. LONG—El campo será de tipo largo. TEXT—El 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. UR—Las entidades se ordenarán comenzando en la esquina superior derecha. Esta es la opción predeterminada. 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.	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_DISTANCE—No se agregarán campos de distancia o rumbo a la salida. Esta es la opción predeterminada. ADD_DISTANCE—DIST_TO_CENTER y los campos ANGLE_TO_CENTER se agregarán a la salida.	Boolean

Salida derivada

Nombre	Explicación	Tipo 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")

Entornos

Extensión, Espacio de trabajo actual, Espacio de trabajo temporal

Casos especiales

Información de licenciamiento

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