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ámetroExplicaciónTipo 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.

  • INTERVALSe generarán anillos de rango basándose en el número de anillos y la distancia entre anillos. Es la opción predeterminada.
  • MIN_MAXSe 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.

  • METERSLa unidad será metros. Esta es la opción predeterminada.
  • KILOMETERSLa unidad será kilómetros.
  • MILESLa unidad será millas.
  • NAUTICAL_MILESLa unidad será millas náuticas.
  • FEETLa unidad será pies.
  • US_SURVEY_FEETLa 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í

Temas relacionados