Generar anillos de rango a partir de una tabla de búsqueda (Defensa)

Resumen

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

Heredado:

Esta es una herramienta obsoleta. Esta función se ha reemplazado por la herramienta Generar anillos de rango a partir de entidades.

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.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada (puntos centrales)

El conjunto de entidades de punto que identifica el centro del anillo de rango. La entrada debe tener al menos un punto.

Feature Set
Tabla de búsqueda de entrada

La tabla de entrada que contiene los valores para crear anillos.

Table
Clase de entidad de salida (anillos)

La clase de entidad de salida que contiene las entidades de anillo.

Feature Class
Nombre seleccionado

La fila de la Tabla de búsqueda de entrada que contiene los valores de entrada para los valores mínimo y máximo o el número de anillos e intervalo.

String
Tipo de anillo de rango

Especifica el método utilizado para crear los anillos de rango.

  • IntervaloSe generarán anillos de rango basándose en el número de anillos y la distancia entre anillos. Es la opción predeterminada.
  • Mínimo y máximoSe generarán anillos de rango basándose en las distancias mínima y máxima.
String
Clase de entidad de salida (radiales)
(Opcional)

La clase de entidad que contiene las entidades radiales de salida.

Feature Class
Número de radiales
(Opcional)

El número de radiales que se crearán.

Long
Unidades de distancia
(Opcional)

Especifica la unidad de medida lineal para el parámetro Campo de intervalo de anillos o los parámetros Rango mínimo de tabla de entrada y Rango máximo de tabla de entrada.

  • MetrosLa unidad será metros. Esta es la opción predeterminada.
  • KilómetrosLa unidad será kilómetros.
  • MillasLa unidad será millas.
  • Millas náuticasLa unidad será millas náuticas.
  • PiesLa unidad será pies.
  • Pies de agrimensura de EE. UU.La unidad será pies de agrimensura de EE. UU.
String
Campo de nombre seleccionado de tabla de entrada
(Opcional)

El campo de la tabla de entrada que contiene el valor de Nombre seleccionado. El nombre de campo predeterminado es Name.

Field
Rango mínimo de tabla de entrada
(Opcional)

El campo de la tabla de entrada que contiene el valor de rango mínimo. El nombre de campo predeterminado es Min.

Field
Rango máximo de tabla de entrada
(Opcional)

El campo de la tabla de entrada que contiene el valor de rango máximo. El nombre de campo predeterminado es Max.

Field
Campo de número de anillos
(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
Campo de intervalo de anillos
(Opcional)

El campo de la tabla de entrada que contiene el valor de intervalo de anillos. El nombre de campo predeterminado es Interval.

Field

arcpy.defense.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})
NombreExplicació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 lineal de medida 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")