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).
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)
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) (in_fields en la secuencia de comandos) se utiliza para identificar polígonos o grupos de polígonos y reporta su información de vecindad por 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 Vecinos de polígono para obtener detalles sobre el uso de este parámetro.
Incluir superposición de área se puede utilizar si desea analizar las relaciones que superponen el área. Cuando se selecciona Incluir la superposición de área, la tabla de salida contiene un campo denominado ÁREA que contiene el área de superposición del vecino superpuesto que se analiza. Si no se encuentra una superposición, el ÁREA 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 no está interesado en analizar a los vecinos superpuestos, asegúrese de que la casilla de verificación Incluir superposición de área está desmarcada en el cuadro de diálogo de la herramienta o el parámetro area_overlap se establece en NO_AREA_OVERLAP en la secuencia de comandos.
Precaución:Para obtener registro de los vecinos que están completamente incluidos en un polígono de origen, la casilla de verificación Incluir superposición de área debe estar marcada en el cuadro de diálogo, o el parámetro area_overlap se debe establecer en AREA_OVERLAP en una secuencia de comandos. Si no tiene marcada la casilla de verificación Incluir superposición de área, la tabla de salida no incluirá los registros para los vecinos que están totalmente contenidos por 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 ambas partes de la relación de vecino en el cuadro de diálogo de la herramienta (el parámetro both_sides en la secuencia de comandos) se utiliza para controlar las relaciones incluidas en la salida. Para informar todas las relaciones de contigüidad, incluso las relaciones recíprocas, marque Incluir ambas partes de la relación de vecino (both_sides = "BOTH_SIDES" ). 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, desmarque Incluir ambas partes de la relación de vecino. Con el ejemplo anterior, pero con Incluir ambas partes de la relación de vecino desmarcada, 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á marcado (area_overlap = " = " AREA_OVERLAP "). Cuando Superposición de área está marcada, las unidades utilizadas para calcular la superposición de área de los vecinos son especificados 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 contiene los siguientes campos:
- Src_field(s): el prefijo, src, representa la fuente; el campo es el que utiliza el parámetro Informe por campos, por ejemplo, src_MYID. Obtendrá tantos campos como especifique en el parámetro Informe por campos.
- Nbr_field(s): el prefijo, nbr, representa el vecino; el campo es el que utiliza el parámetro Informe por campos, por ejemplo, nbr_MYID. Similar a los campos src, obtiene tanto campos como especifica en el parámetro Informe por campos.
- Campo AREA: este almacena el área de superposición total entre un polígono de origen y un polígono vecino (vecinos superpuestos). Este campo se incluye en la tabla de salida solo cuando el parámetro Incluir superposición de área está marcado (area_overlap = "AREA_OVERLAP").
- Campo LENGTH: almacena la longitud total de bordes coincidentes entre un polígono de origen y un polígono vecino.
- Campo NODE_COUNT: almacena el número de veces que un polígono de origen y un polígono vecino cruza o se toca en un punto.
Si hay una selección de las entidades de entrada, solo las entidades seleccionadas se analizan.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_features |
Entidades de polígono de entrada. | Feature Layer |
out_table |
La tabla de salida. | Table |
in_fields [in_fields,...] (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.
| Boolean |
both_sides (Opcional) | Determina si ambas partes de las relaciones de vecino se incluirán en la salida.
| 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. | Linear unit |
out_linear_units (Opcional) |
Las unidades utilizadas para indicar la longitud total del borde coincidente entre polígonos vecinos. El valor predeterminado son las unidades de la entidad de entrada. | 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 el parámetro area_overlap se establece en AREA_OVERLAP. | String |
Ejemplo de código
Busque cada vecino del distrito electoral en la provincia de Nueva Escocia.
import arcpy, sys arcpy.env.overwriteOutput = True arcpy.MakeFeatureLayer_management(r"C:\Data\Canada\CanadaElecDist.shp",r"Canada_ElectoralDist") arcpy.SelectLayerByAttribute_management(r"Canada_ElectoralDist", "NEW_SELECTION", "\"PROVCODE\" = 'NS'") print "Selected feature count: " + str(arcpy.GetCount_management(r"Canada_ElectoralDist")) arcpy.PolygonNeighbors_analysis(r"Canada_ElectoralDist", "ENNAME", r"C:\Data\Output\NS_elec_neigh.dbf") print arcpy.GetMessages()