| Etiqueta | Explicación | Tipo de datos |
Entidades de puntos de entrada | Los puntos que se agruparán en subconjuntos. | Feature Layer |
Clase de entidad de salida | Los polígonos que definen la región de cada subconjunto. Todos los puntos dentro de una única entidad poligonal se consideran parte del mismo subconjunto. La clase de entidad poligonal contendrá un campo denominado PointCount que almacenará el número de puntos contenidos en cada subconjunto de polígonos. | Feature Class |
Cantidad mínima de puntos por subconjunto (Opcional) | El número mínimo de puntos que se pueden agrupar en un subconjunto. Todos los polígonos de subconjunto contendrán al menos este número de puntos. | Long |
Cantidad máxima de puntos por subconjunto (Opcional) | El número máximo de puntos que se pueden agrupar en un subconjunto. Cada subconjunto siempre contendrá menos de dos veces la Cantidad mínima de puntos por subconjunto, independientemente del número máximo proporcionado. Se debe a que, si un subconjunto contiene al menos el doble de la cantidad mínima de puntos, siempre se subdividirá en dos o más subconjuntos nuevos. | Long |
Tratar los puntos coincidentes como un único punto (Opcional) | Especifica si los puntos coincidentes (puntos que están en la misma ubicación) se tratan como un único punto o como varios puntos individuales. Si tiene previsto usar los polígonos de subconjunto como Entidades poligonales de subconjunto en EBK Regression Prediction, debe mantener la coherencia entre este parámetro y el entorno Puntos coincidentes en EBK Regression Prediction. Si este parámetro está desactivado, es posible que los polígonos de Clase de entidad de salida se superpongan.
| Boolean |
Disponible con una licencia de Geostatistical Analyst.
Resumen
Genera entidades poligonales de subconjuntos no superpuestos a partir de un conjunto de puntos de entrada. El objetivo es dividir los puntos en subconjuntos compactos y no superpuestos, y crear regiones de polígonos alrededor de cada subconjunto de puntos. Es posible controlar el número mínimo y máximo de puntos de cada subconjunto.
El proceso de generar entidades poligonales de subconjuntos comienza por conectar todos los puntos con una curva lineal y cortar esta curva en segmentos. Estos segmentos se eligen para minimizar la distancia cuadrada total desde el centro del segmento hasta cada punto del segmento dado el número mínimo y máximo de puntos permitidos para cada subconjunto. A continuación, se elimina cualquier superposición entre los segmentos y se crean nuevos segmentos. Después de varias iteraciones de segmentación y eliminación de superposición, no se mantendrá ninguna superposición y todos los puntos dentro de cada segmento se declararán parte del mismo subconjunto. A continuación, se generan polígonos de Thiessen para los puntos de entrada y todos los polígonos de Thiessen que pertenecen al mismo subconjunto se disuelven en una única entidad poligonal.
Ilustración
Uso
La finalidad principal de esta herramienta es crear polígonos que se puedan usar como Entidades poligonales de subconjunto en EBK Regression Prediction. El algoritmo de subconjunto predeterminado de EBK Regression Prediction crea subconjuntos que se superpondrán. Sin embargo, si necesita subconjuntos que no se superpongan, esta herramienta puede crearlos.
Esta herramienta es conceptualmente similar a las herramientas del conjunto de herramientas Clustering de la caja de herramientas Minería de patrones en espacio-tiempo. La diferencia principal es que esas herramientas crean clústeres de puntos asignando valores de Id. únicos a cada miembro de un clúster, y esta herramienta define subconjuntos creando regiones de subconjunto de polígonos alrededor de los puntos de cada subconjunto. La diferencia se debe a que EBK Regression Prediction requiere la definición de subconjuntos mediante regiones poligonales.
Considere el número de Entidades de puntos de entrada al elegir la Cantidad mínima de puntos por subconjunto y la Cantidad máxima de puntos por subconjunto. Si el número de puntos de entrada no puede respetar el mínimo y el máximo proporcionados, se lanzará un error durante la ejecución de la herramienta. Por ejemplo, si tiene diez puntos y pide un mínimo de seis puntos por subconjunto y un máximo de siete puntos por subconjunto, recibirá un error. Esto se debe a que no hay forma de dividir diez puntos en subconjuntos de tamaño seis o siete.
La extensión de salida predeterminada de la Clase de entidad de salida será la extensión de las Entidades de puntos de entrada con una zona de influencia del 10 por ciento. Esta creación de zonas de influencia garantiza que todos los puntos de entrada estén dentro de los polígonos de salida de forma predeterminada. Si se proporciona un entorno Extensión de salida, no se creará una zona de influencia.
Las Entidades de puntos de entrada que se encuentran en un sistema de coordenadas geográficas (GCS) tardarán bastante más tiempo en calcularse que si los mismos puntos estuvieran en un sistema de coordenadas proyectadas (PCS). Esto se debe a que los datos de las coordenadas geográficas se agruparán según sus ubicaciones en la Tierra en lugar de donde aparezcan en un mapa proyectado plano. Si los puntos de entrada están contenidos en un área pequeña, se recomienda proyectar los datos antes de usar esta herramienta.
Parámetros
arcpy.ga.GenerateSubsetPolygons(in_point_features, out_feature_class, {min_points_per_subset}, {max_points_per_subset}, {coincident_points})| Nombre | Explicación | Tipo de datos |
in_point_features | Los puntos que se agruparán en subconjuntos. | Feature Layer |
out_feature_class | Los polígonos que definen la región de cada subconjunto. Todos los puntos dentro de una única entidad poligonal se consideran parte del mismo subconjunto. La clase de entidad poligonal contendrá un campo denominado PointCount que almacenará el número de puntos contenidos en cada subconjunto de polígonos. | Feature Class |
min_points_per_subset (Opcional) | El número mínimo de puntos que se pueden agrupar en un subconjunto. Todos los polígonos de subconjunto contendrán al menos este número de puntos. | Long |
max_points_per_subset (Opcional) | El número máximo de puntos que se pueden agrupar en un subconjunto. Cada subconjunto siempre contendrá menos de dos veces la min_points_per_subset, independientemente del número máximo proporcionado. Se debe a que, si un subconjunto contiene al menos el doble de la cantidad mínima de puntos, siempre se subdividirá en dos o más subconjuntos nuevos. | Long |
coincident_points (Opcional) | Especifica si los puntos coincidentes (puntos que están en la misma ubicación) se tratan como un único punto o como varios puntos individuales. Si tiene previsto usar los polígonos de subconjunto como Entidades poligonales de subconjunto en EBK Regression Prediction, debe mantener la coherencia entre este parámetro y su elección para el entorno Puntos coincidentes en EBK Regression Prediction. Si se elige COINCIDENT_ALL, es posible que los polígonos de Out_feature_class se superpongan.
| Boolean |
Muestra de código
Agrupar un conjunto de puntos en subconjuntos de polígono.
arcpy.ga.GenerateSubsetPolygons("myPoints","polygonSubsets",20,30,"COINCIDENT_SINGLE")Agrupar un conjunto de puntos en subconjuntos de polígono.
# Name: GenerateSubsetPolygons_Example_02.py
# Description: Groups points into polygon subsets of a similar size.
# Requirements: Geostatistical Analyst Extension
# Author: Esri
# Import system modules
import arcpy
# Set local variables
inPoints = "C:/gapyexamples/input/myPoints.shp"
outFeatureClass = "C:/gapyexamples/output/myPolygons.shp"
minPoints = 50
maxPoints = 75
coincidentPoints = "COINCIDENT_ALL"
# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")
# Execute GenerateSubsetPolygons
arcpy.ga.GenerateSubsetPolygons(inPoints, outFeatureClass, minPoints, maxPoints, coincidentPoints)Entornos
Información de licenciamiento
- Basic: Requiere Geostatistical Analyst
- Standard: Requiere Geostatistical Analyst
- Advanced: Requiere Geostatistical Analyst