Vecinos de polígonos (Análisis)

Resumen

Crea una tabla con estadísticas basadas en la contigüidad de polígono (superposiciones, bordes coincidentes o nodos).

Más información sobre cómo funciona Polígonos vecinos

Ilustración

Ilustración de la herramienta Vecinos de polígonos
Se muestra un diagrama de un polígono de origen y sus polígonos vecinos.

Uso

  • La herramienta analiza la contigüidad de los polígonos, resumiendo lo siguiente entre los polígonos de origen y los polígonos vecinos:

    • El área de superposiciones (vecinos superpuestos, opcional)
    • La longitud de bordes coincidentes (vecinos de borde)
    • El número de veces que cruzan límites o se tocan en un punto (vecinos de nodo)
    La información de resumen se escribe en una tabla de salida. Un polígono de origen puede tener uno o más polígonos vecinos; un polígono vecino está espacialmente relacionado con el polígono de origen en al menos una de las formas descritas arriba.

  • La herramienta solo analiza y reporta la contigüidad de primer orden. Las relaciones más allá que no se examinan; es decir, los vecinos de vecinos (contigüidad de segundo orden) no se examinan.

  • El parámetro Informe por campos se usa para identificar polígonos únicos o grupos de polígonos e informar de su información de vecindad referida a los polígonos o grupos de polígonos. Para encontrar los vecinos de cada polígono individual en la entrada, especifique uno o más campos de entrada que den como resultado un valor único o un conjunto de valores (en el caso de campos múltiples) para cada polígono.

    Si los campos especificados identifican grupos de polígonos únicos, la información de vecindad se resume y reporta por grupos.

    Consulte Cómo funciona Polígonos vecinos para obtener más información sobre cómo utilizar este parámetro.

  • Puede utilizar el parámetro Incluir superposición de áreas para analizar las relaciones de superposición de áreas. Al activar Incluir superposición de área, la tabla de salida contiene un campo AREA que contiene el área de superposición del vecino superpuesto que se está analizando. Si no se encuentra ninguna superposición, el valor del campo AREA es 0.

    Sugerencia:

    Calcular las relaciones de superposición de área es una operación de altos recursos y el rendimiento podría ser mucho más lento que determinar las relaciones de vecino de nodos y bordes coincidentes. Si sabe que sus datos no tienen entidades superpuestas o si no le interesa analizar vecinos superpuestos, asegúrese de que el parámetro Incluir superposición de área no esté activado.

    Precaución:

    El parámetro Incluir superposición de área debe estar activado para obtener registros de vecinos que están contenidos completamente en un polígono de origen. Si el parámetro Incluir superposición de área no está activado, la tabla de salida no contendrá registros de los vecinos contenidos completamente en un polígono de origen.

  • No hay entrada en la tabla de salida para entidades que no son vecinas.

  • El parámetro Incluir ambos lados de la relación de elementos próximos se usa para controlar las relaciones incluidas en la salida. Para informar de todas las relaciones de contigüidad, incluidas las relaciones recíprocas, active Incluir ambas partes de la relación de vecino. Por ejemplo, si OID1 es vecino de OID2, una entrada se escribe en la tabla de salida de OID1 con un OID2 vecino y de OID2 con un vecino OID1. Si solo desea el primer lado de la relación, desactive Incluir ambas partes de la relación de vecino. Con el ejemplo anterior, pero con Incluir ambas partes de la relación de vecino desactivada, solo la entrada de OID1 con un OID2 vecino se introduce en la tabla de salida.

  • Unidades lineales de salida especifica las unidades que se usarán para la longitud de límite compartido entre vecinos. El valor predeterminado es usar las mismas unidades como lo define el sistema de coordenadas de la entidad de entrada.

  • Unidades de área de salida solo se utiliza cuando el parámetro Incluir superposición de área está activado. Si Incluir superposición de área está activado, las unidades utilizadas para calcular la superposición de área de los vecinos se especifican en el parámetro Unidades de área de salida. La opción predeterminada es utilizar las mismas unidades definidas por el sistema de coordenadas de la entidad de entrada.

  • El valor del parámetro Tabla de salida puede ser una tabla de geodatabase de archivos o una tabla .dbf.

  • Para cada campo especificado en el parámetro Informe por campos, la tabla de salida contendrá dos campos que utilizan la siguiente convención de nombres: src_<field> y nbr_<field>. Los campos representan los valores de los campos de origen y vecinos de la entrada.

    La tabla de salida también contendrá los siguientes campos:

    • AREA- este campo almacena el área de superposición total entre un polígono de origen y un polígono vecino (vecinos superpuestos). Este campo solo se incluye en la tabla de salida cuando el parámetro Incluir superposición de área está activado.
    • LENGTH- este campo almacena la longitud total de bordes coincidentes entre un polígono de origen y un polígono vecino.
    • NODE_COUNT- este campo almacena el número de veces que un polígono de origen y un polígono vecino se cruzan o se tocan en un punto.

  • Si hay una selección de las entidades de entrada, solo se analizarán las entidades seleccionadas.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades poligonales de entrada.

Feature Layer
Tabla de Salida

La tabla de salida.

Table
Informe por campos
(Opcional)

El campo o campos de atributo de entrada que se utilizarán para identificar los polígonos únicos o grupos de polígonos y representarlos en la salida.

Field
Incluir superposición de área
(Opcional)

Especifica si se analizarán y se incluirán en la salida las relaciones de áreas superpuestas.

  • Desactivado: las relaciones superpuestas no se analizarán ni se incluirán en la salida. Esta es la opción predeterminada.
  • Activado: las relaciones superpuestas se analizarán y se incluirán en la salida.

Boolean
Incluir ambos lados de la relación de elementos próximos
(Opcional)

Especifica si se incluirán en la salida ambas partes de las relaciones de vecino.

  • Activado: para un par de polígonos vecinos, se incluirá la información de vecindad de un polígono como fuente y otro como vecino y viceversa. Esta es la opción predeterminada.
  • Desactivado: para un par de polígonos vecinos, se incluirá la información de vecindad de un polígono como origen y el otro como vecino. No se incluirá la relación recíproca.

Boolean
Tolerancia XY
(Opcional)

La distancia mínima entre las coordenadas antes de que se consideren iguales. De forma predeterminada, es la tolerancia x,y de las entidades de entrada.

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit
Unidades lineales de salida
(Opcional)

Especifica las unidades que se utilizarán para indicar la longitud total del borde coincidente entre polígonos vecinos. El valor predeterminado son las unidades de entidad de entrada.

  • DesconocidoSe desconoce la unidad de longitud.
  • KilómetrosLa unidad de longitud será kilómetros.
  • MetrosLa unidad de longitud será metros.
  • DecímetrosLa unidad de longitud será decímetros.
  • CentímetrosLa unidad de longitud será centímetros.
  • MilímetrosLa unidad de longitud será milímetros.
  • Millas terrestresLa unidad de longitud será millas terrestres.
  • Millas náuticas internacionalesLa unidad de longitud será millas náuticas internacionales.
  • Yardas internacionalesLa unidad de longitud será yardas internacionales.
  • Pies internacionalesLa unidad de longitud será pies internacionales.
  • Pulgadas internacionalesLa unidad de longitud será pulgadas internacionales.
  • Millas de agrimensura de EE. UU.La unidad de longitud será millas topográficas de EE. UU.
  • Millas náuticas topográficas de EE. UU.La unidad de longitud será millas náuticas topográficas de EE. UU.
  • Yardas de agrimensura de EE. UU.La unidad de longitud será yardas topográficas de EE. UU.
  • Pies de agrimensura de EE. UU.La unidad de longitud será pies topográficos de EE. UU.
  • Pulgadas de agrimensura de EE. UU.La unidad de longitud será pulgadas de agrimensura de EE. UU.
  • Grados decimalesLa unidad de longitud será grados decimales.
  • PuntosLa unidad de longitud será puntos.
String
Unidades de área de salida
(Opcional)

Especifica las unidades que se utilizarán para indicar la superposición de área de los polígonos vecinos. El valor predeterminado son las unidades de entidad de entrada. Este parámetro solo está activado si el parámetro Incluir superposición de área está activado.

  • DesconocidoLa unidad de área será el cuadrado desconocido.
  • Kilómetros cuadradosLa unidad de área será kilómetros cuadrados.
  • Metros cuadradosLa unidad de área será metros cuadrados.
  • Decímetros CuadradosLa unidad de área será decímetros cuadrados.
  • Centímetros CuadradosLa unidad de área será centímetros cuadrados.
  • Milímetros CuadradosLa unidad de área será milímetros cuadrados.
  • Millas terrestres cuadradasLa unidad de área será millas terrestres cuadradas.
  • Yardas cuadradas internacionalesLa unidad de área será yardas cuadradas internacionales.
  • Pies cuadrados internacionalesLa unidad de área será pies cuadrados internacionales.
  • Pulgadas cuadradas internacionalesLa unidad de área será pulgadas cuadradas internacionales.
  • Millas cuadradas de agrimensura de EE. UU.La unidad de área será millas cuadradas topográficas de EE. UU.
  • Yardas cuadradas de agrimensura de EE. UU.La unidad de área será yardas cuadradas topográficas de EE. UU.
  • Pies cuadrados de agrimensura de EE. UU.La unidad de área será pies cuadrados topográficos de EE. UU.
  • Pulgadas cuadradas de agrimensura de EE. UU.La unidad de área será pulgadas cuadradas topográficas de EE. UU.
  • Acres topográficos de EE. UU.La unidad de área será acres topográficos de EE. UU.
  • HectáreasLa unidad de área será hectáreas.
  • AcresLa unidad de área será acres internacionales.
  • ÁreasLa unidad de área será áreas.
String

arcpy.analysis.PolygonNeighbors(in_features, out_table, {in_fields}, {area_overlap}, {both_sides}, {cluster_tolerance}, {out_linear_units}, {out_area_units})
NombreExplicaciónTipo de datos
in_features

Las entidades poligonales de entrada.

Feature Layer
out_table

La tabla de salida.

Table
in_fields
[in_fields,...]
(Opcional)

El campo o campos de atributo de entrada que se utilizarán para identificar los polígonos únicos o grupos de polígonos y representarlos en la salida.

Field
area_overlap
(Opcional)

Especifica si se analizarán y se incluirán en la salida las relaciones superpuestas.

  • NO_AREA_OVERLAPLas relaciones superpuestas no se analizarán ni se incluirán en la salida. Esta es la opción predeterminada.
  • AREA_OVERLAPLas relaciones superpuestas se analizarán y se incluirán en la salida.
Boolean
both_sides
(Opcional)

Especifica si se incluirán en la salida ambas partes de las relaciones de vecino.

  • BOTH_SIDESPara un par de polígonos vecinos, se incluirá la información de vecindad de un polígono como fuente y otro como vecino y viceversa. Esta es la opción predeterminada.
  • NO_BOTH_SIDESPara un par de polígonos vecinos, se incluirá la información de vecindad de un polígono como origen y el otro como vecino. No se incluirá la relación recíproca.
Boolean
cluster_tolerance
(Opcional)

La distancia mínima entre las coordenadas antes de que se consideren iguales. De forma predeterminada, es la tolerancia x,y de las entidades de entrada.

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit
out_linear_units
(Opcional)

Especifica las unidades que se utilizarán para indicar la longitud total del borde coincidente entre polígonos vecinos. El valor predeterminado son las unidades de entidad de entrada.

  • UNKNOWNSe desconoce la unidad de longitud.
  • KILOMETERSLa unidad de longitud será kilómetros.
  • METERSLa unidad de longitud será metros.
  • DECIMETERSLa unidad de longitud será decímetros.
  • CENTIMETERSLa unidad de longitud será centímetros.
  • MILLIMETERSLa unidad de longitud será milímetros.
  • MILES_INTERNATIONALLa unidad de longitud será millas terrestres.
  • NAUTICAL_MILES_INTERNATIONALLa unidad de longitud será millas náuticas internacionales.
  • YARDS_INTERNATIONALLa unidad de longitud será yardas internacionales.
  • FEET_INTERNATIONALLa unidad de longitud será pies internacionales.
  • INCHES_INTERNATIONALLa unidad de longitud será pulgadas internacionales.
  • MILESLa unidad de longitud será millas topográficas de EE. UU.
  • NAUTICAL_MILESLa unidad de longitud será millas náuticas topográficas de EE. UU.
  • YARDSLa unidad de longitud será yardas topográficas de EE. UU.
  • FEETLa unidad de longitud será pies topográficos de EE. UU.
  • INCHESLa unidad de longitud será pulgadas de agrimensura de EE. UU.
  • DECIMAL_DEGREESLa unidad de longitud será grados decimales.
  • POINTSLa unidad de longitud será puntos.
String
out_area_units
(Opcional)

Especifica las unidades que se utilizarán para indicar la superposición de área de los polígonos vecinos. El valor predeterminado son las unidades de entidad de entrada. Este parámetro solo está habilitado cuando el parámetro area_overlap tiene el valor AREA_OVERLAP.

  • UNKNOWNLa unidad de área será el cuadrado desconocido.
  • SQUARE_KILOMETERSLa unidad de área será kilómetros cuadrados.
  • SQUARE_METERSLa unidad de área será metros cuadrados.
  • SQUARE_DECIMETERSLa unidad de área será decímetros cuadrados.
  • SQUARE_CENTIMETERSLa unidad de área será centímetros cuadrados.
  • SQUARE_MILLIMETERSLa unidad de área será milímetros cuadrados.
  • SQUARE_MILESLa unidad de área será millas terrestres cuadradas.
  • SQUARE_YARDSLa unidad de área será yardas cuadradas internacionales.
  • SQUARE_FEETLa unidad de área será pies cuadrados internacionales.
  • SQUARE_INCHESLa unidad de área será pulgadas cuadradas internacionales.
  • SQUARE_MILES_USLa unidad de área será millas cuadradas topográficas de EE. UU.
  • SQUARE_YARDS_USLa unidad de área será yardas cuadradas topográficas de EE. UU.
  • SQUARE_FEET_USLa unidad de área será pies cuadrados topográficos de EE. UU.
  • SQUARE_INCHES_USLa unidad de área será pulgadas cuadradas topográficas de EE. UU.
  • ACRES_USLa unidad de área será acres topográficos de EE. UU.
  • HECTARESLa unidad de área será hectáreas.
  • ACRESLa unidad de área será acres internacionales.
  • ARESLa unidad de área será áreas.
String

Muestra de código

Ejemplo PolygonNeighbors (ventana de Python)

Buscar los vecinos de cada distrito electoral en la provincia de Nueva Escocia.

import arcpy

arcpy.management.MakeFeatureLayer(r"C:\Data\Canada\CanadaElecDist.shp", 
                                  "Canada_ElectoralDist")

arcpy.management.SelectLayerByAttribute("Canada_ElectoralDist", "NEW_SELECTION", 
                                        "\"PROVCODE\" = 'NS'")
count = arcpy.management.GetCount("Canada_ElectoralDist")[0]
print("Selected feature count: {}".format(count))

arcpy.analysis.PolygonNeighbors("Canada_ElectoralDist", 
                                r"C:\Data\Output\NS_elec_neigh.dbf", "ENNAME")
print(arcpy.GetMessages())

Información de licenciamiento

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

Temas relacionados