Polígonos vecinos (Analysis)

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

Uso

• La herramienta analiza la contigüidad de polígono, resumiendo

  • Á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)
  entre polígonos de origen y polígonos vecinos. 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 anteriores.

• 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 campo(s) (in_fields en Python) 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 a los vecinos de cada polígono individual en la entrada, especifique uno o más campos de entrada que resultan en un valor único o conjunto de valores (en el caso del uso de varios campos) 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.

• Incluir superposición de área se puede utilizar si desea que se analicen relaciones de superposiciones de áreas. Al seleccionar Incluir superposición de área, la tabla de salida contiene un campo denominado AREA que contiene el área de superposición del vecino superpuesto que se está analizando. Si no se encuentra ninguna superposición, AREA es 0.

  Sugerencia:

  Calcular las relaciones de superposición de área es una operación de altos recursos y el rendimiento puede 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 preocupa analizar vecinos superpuestos, asegúrese de que la casilla de verificación Incluir superposición de área esté desactivada en el cuadro de diálogo de la herramienta (area_overlap="NO_AREA_OVERLAP" en Python).

  Precaución:

  La casilla de verificación Incluir superposición de área debe estar activada en el cuadro de diálogo (area_overlap="AREA_OVERLAP" en Python) para obtener registros de vecinos que están contenidos completamente en un polígono de origen. Si la casilla de verificación Incluir superposición de área no está activada, 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.

• La casilla de verificación Incluir ambos lados de la relación de elementos próximos del cuadro de diálogo de la herramienta 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 (both_sides="BOTH_SIDES" en Python). 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 a usar 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 Superposición de área está activado (area_overlap="AREA_OVERLAP" en Python). Cuando 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.

• La Tabla de salida puede ser una tabla de geodatabase de archivos o una tabla .dbf.

• La tabla de salida contiene los siguientes campos:

  • src_field(s): el prefijo, src, hace referencia al origen y field es un campo especificado en el parámetro Informe por campo(s). Obtendrá tantos campos como especifique en el parámetro Informe por campo(s).
  • nbr_field(s): el prefijo, nbr, hace referencia al vecino y field es un campo especificado en el parámetro Informe por campo(s). Como en el caso de src_field(s), obtendrá tantos campos como especifique en el parámetro Informe por campo(s).
  • 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 (area_overlap="AREA_OVERLAP" en Python).
  • 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 las entidades seleccionadas se analizan.

Sintaxis

arcpy.analysis.PolygonNeighbors(in_features, out_table, {in_fields}, {area_overlap}, {both_sides}, {cluster_tolerance}, {out_linear_units}, {out_area_units})

Parámetro	Explicación	Tipo de datos
in_features	Las entidades de polígono de entrada.	Feature Layer
out_table	La tabla de salida.	Table
in_fields [field,...] (Opcional)	El campo o campos de atributo de entrada se utilizan para identificar los polígonos únicos o grupos de polígonos y los representan en la salida.	Field
area_overlap (Opcional)	Determina si los polígonos superpuestos se analizarán y se informarán en la salida. NO_AREA_OVERLAP —Las relaciones superpuestas no se analizarán ni se incluirán en la salida. Esta es la opción predeterminada. AREA_OVERLAP —Las relaciones superpuestas se analizarán y se incluirán en la salida.	Boolean
both_sides (Opcional)	Determina si ambas partes de las relaciones de vecino se incluirán en la salida. BOTH_SIDES — Para un par de polígonos vecinos, reporte la información de vecindad de un polígono siendo la fuente y el otro siendo el vecino y viceversa. Esta es la opción predeterminada. NO_BOTH_SIDES — Para un par de polígonos vecinos, solo reporte la información de vecindad de un polígono siendo el origen y el otro siendo el vecino. No incluyen la relación recíproca.	Boolean
cluster_tolerance (Opcional)	La distancia mínima entre las coordenadas antes de que se consideren iguales. De manera predeterminada, esta es la tolerancia XY 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)	Unidades utilizadas para indicar la longitud total del borde coincidente entre polígonos vecinos. El valor predeterminado son las unidades de entidad de entrada. UNKNOWN —Se desconoce INCHES —Pulgadas FEET —Pies YARDS —Yardas MILES —Millas NAUTICAL_MILES —Millas náuticas MILLIMETERS —Milímetros CENTIMETERS —Centímetros DECIMETERS —Decímetros METERS —Metros KILOMETERS —Kilómetros DECIMAL_DEGREES —Grados decimales POINTS —Puntos	String
out_area_units (Opcional)	Unidades utilizadas 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 la casilla de verificación area_overlap="AREA_OVERLAP" está activada. UNKNOWN —Se desconoce ARES —Áreas ACRES —Acres HECTARES —Hectáreas SQUARE_INCHES —Pulgadas cuadradas SQUARE_FEET —Pies cuadrados SQUARE_YARDS —Yardas cuadradas SQUARE_MILES —Millas cuadradas SQUARE_MILLIMETERS —Milímetros cuadrados SQUARE_CENTIMETERS —Centímetros cuadrados SQUARE_DECIMETERS —Decímetros cuadrados SQUARE_METERS —Metros cuadrados SQUARE_KILOMETERS —Kilómetros cuadrados	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.MakeFeatureLayer_management(r"C:\Data\Canada\CanadaElecDist.shp", 
                                  "Canada_ElectoralDist")
arcpy.SelectLayerByAttribute_management("Canada_ElectoralDist", "NEW_SELECTION", 
                                        "\"PROVCODE\" = 'NS'")
count = arcpy.GetCount_management("Canada_ElectoralDist")[0]
print("Selected feature count: {}".format(count))
arcpy.PolygonNeighbors_analysis("Canada_ElectoralDist", 
                                r"C:\Data\Output\NS_elec_neigh.dbf", "ENNAME")
print(arcpy.GetMessages())

Entornos

Auto ejecución, Nombres de campos calificados, Extensión, Espacio de trabajo temporal, Espacio de trabajo actual

Información de licenciamiento

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