Generar anillos de rango a partir de una tabla (Superposición por pares)

Resumen

Crea un conjunto de círculos concéntricos desde un centro a partir de unos valores almacenados en una tabla.

Uso

• El parámetro Tipo de anillo de rango se utiliza para determinar si los anillos se crearán a partir de un intervalo y número de anillos o de unas distancias mínima y máxima. Estos dos tipos de anillo de rango se describen de la siguiente manera:

  • La generación de anillos de rango a partir de un intervalo implica que usted especificará el número de anillos que se crearán. El primer anillo será una distancia desde el punto central que usted especifique y cada anillo posterior se creará a esa misma distancia del anillo anterior.
  • La generación de anillos de rango a partir de unas distancias mínima y máxima implica que usted especificará dos valores: un mínimo y un máximo. Se creará un anillo para cada valor a la distancia especificada del centro.

• Los valores de anillo de rango, ya sean intervalos o distancias mínima y máxima, se deben almacenar en una tabla de la siguiente manera:

  • La tabla utilizada para crear anillos de rango a partir de un intervalo debe contener al menos una fila con los siguientes tres campos:
    • Un campo de texto que contenga un nombre de búsqueda que se usará para elegir la fila que contiene los valores del intervalo y el número de anillos que se crearán. El nombre de campo predeterminado es Name.
    • Un campo largo, corto, doble o flotante que contenga un valor para el intervalo al que se crearán los anillos. El nombre de campo predeterminado es Intervals.
    • Un campo largo, corto o de tipo entero que contenga un valor para el número de anillos que se crearán. El nombre de campo predeterminado es Rings.
  • La tabla utilizada para crear anillos de rango a partir de unas distancias mínima y máxima debe contener al menos una fila con los siguientes tres campos:
    • Un campo de texto que contenga un nombre de búsqueda que se usará para elegir la fila que contiene los valores de las distancias mínima y máxima a las que se crearán los anillos. El nombre de campo predeterminado es Name.
    • Un campo largo, corto, doble o flotante que contenga un valor para la distancia mínima a la que se creará un anillo. El nombre de campo predeterminado es Min.
    • Un campo largo, corto, doble o flotante que contenga un valor para la distancia máxima a la que se creará un anillo. El nombre de campo predeterminado es Max.

Sintaxis

GenerateRangeRingsFromTable(in_features, in_table, out_feature_class_rings, lookup_name, range_rings_type, {out_feature_class_radials}, {number_of_radials}, {distance_units}, {lookup_name_field}, {min_range_field}, {max_range_field}, {number_of_rings_field}, {ring_interval_field})

Parámetro	Explicación	Tipo de datos
in_features	El conjunto de entidades de punto que identifica el centro del anillo de rango. La entrada debe tener al menos un punto.	Feature Set
in_table	La tabla de entrada que contiene los valores para crear anillos.	Table
out_feature_class_rings	La clase de entidad de salida que contiene las entidades de anillo.	Feature Class
lookup_name	La fila de la in_table que contiene los valores de entrada para los valores mínimo y máximo o el número de anillos e intervalo.	String
range_rings_type	Especifica el método utilizado para crear los anillos de rango. INTERVAL —Se generarán anillos de rango basándose en el número de anillos y la distancia entre anillos. Es la opción predeterminada. MIN_MAX —Se generarán anillos de rango basándose en las distancias mínima y máxima.	String
out_feature_class_radials (Opcional)	La clase de entidad que contiene las entidades radiales de salida.	Feature Class
number_of_radials (Opcional)	El número de radiales que se crearán.	Long
distance_units (Opcional)	Especifica la unidad de medida lineal para el parámetro ring_interval_field o los parámetros min_range_field y max_range_field. METERS —La unidad será metros. Esta es la opción predeterminada. KILOMETERS —La unidad será kilómetros. MILES —La unidad será millas. NAUTICAL_MILES —La unidad será millas náuticas. FEET —La unidad será pies. US_SURVEY_FEET —La unidad será pies de agrimensura de EE. UU.	String
lookup_name_field (Opcional)	El campo de la tabla de entrada que contiene el valor de lookup_name. El nombre de campo predeterminado es Name.	Field
min_range_field (Opcional)	El campo de la tabla de entrada que contiene el valor de rango mínimo. El nombre de campo predeterminado es Min.	Field
max_range_field (Opcional)	El campo de la tabla de entrada que contiene el valor de rango máximo. El nombre de campo predeterminado es Max.	Field
number_of_rings_field (Opcional)	El campo de la tabla de entrada que contiene el valor de número de anillos. El nombre de campo predeterminado es Rings.	Field
ring_interval_field (Opcional)	El campo de la tabla de entrada que contiene el valor de intervalo de anillos. El nombre de campo predeterminado es Interval.	Field

Muestra de código

Ejemplo 1 de GenerateRangeRingsFromTable (ventana de Python)

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

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.GenerateRangeRingsFromTable_defense("RLOS_Observers",
                                          "rrInputTable",
                                          "OutputRR",
                                          "M4",
                                          "MIN_MAX")

Ejemplo 2 de GenerateRangeRingsFromTable (script independiente)

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

# Description: Generate range rings around active airports
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\Data.gdb"
arcpy.env.overwriteOutput = True
# Select points from airports from input
airports = "Airports"
active = "Active_Airports"
whereClause = "Active = 'Yes'"
arcpy.Select_analysis(airports, active, whereClause)
# Generate Range Rings around selected airports
outputRings = "Rings"
outputRadials = "Radials"
ringType = "MIN_MAX"
distType = "KILOMETERS"
arcpy.GenerateRangeRingsFromTable_defense(active,
                                          "rrInputTable",
                                          outputRings,
                                          "M4",
                                          ringType,
                                          outputRadials,
                                          3,
                                          distType,
                                          "Name",
                                          "Min",
                                          "Max")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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