| Etiqueta | Explicación | Tipo de datos |
Ráster de probabilidad de inclusión de entrada | Este ráster define las probabilidades de inclusión para cada ubicación en el área de interés. Los valores de ubicación varían de 0 (probabilidad de inclusión baja) a 1 (probabilidad de inclusión alta). | Raster Layer; Mosaic Layer |
Número de puntos de salida | Especifique cuántas ubicaciones de muestra se deben generar. | Long |
Clase de entidad de puntos de salida | La clase de entidad de salida contiene las ubicaciones de muestra seleccionadas y sus probabilidades de inclusión. | Feature Class |
Disponible con una licencia de Geostatistical Analyst.
Resumen
Genera un conjunto de puntos de muestra basados en probabilidades de inclusión, lo que genera un diseño de muestra espacialmente equilibrado. Esta herramienta se utiliza generalmente para diseñar una red de supervisión sugiriendo ubicaciones para la toma de muestras, y se puede definir una preferencia por determinadas ubicaciones mediante una trama de probabilidad de inclusión.
Más información sobre el funcionamiento de Crear puntos espacialmente equilibrados
Uso
El ráster de probabilidad de entrada debe contener solo valores entre 0 y 1. Cuanto más alto sea el valor, más probable será que se incluya la celda en el diseño de muestra.
Todos los valores del área de estudio deben tener probabilidades de inclusión >= 0, mientras que todas las áreas fuera del área de estudio deben tener valores nulos.
El tamaño de celda ráster de probabilidad de inclusión determina la mejor resolución con la que se generarán las muestras. Es decir, los puntos que crea la herramienta siempre estarán ubicados en los centros de las celdas ráster. El uso de una celda de menor tamaño para el ráster de probabilidad de inclusión dará como resultado ubicaciones más posibles para la creación de los puntos.
Cuando las entidades de punto, línea o polígono se convierten a ráster (para obtener el ráster de probabilidad de entrada), se debe tener en cuenta lo siguiente:
- El tamaño de celda (resolución) debe ser lo suficientemente fino como para distinguir todas las entidades importantes de la población. Para ello, el tamaño de celda se puede establecer en menos de la mitad de la distancia mínima entre entidades. Esta distancia se puede calcular con la herramienta Generar tabla de cercanía.
- Para las entidades de línea y poligonales, el tamaño de celda se debe establecer de modo que las entidades (como las transmisiones de meandros) se representen adecuadamente en el ráster resultante. Por ejemplo, es posible que no pueda representar un río complejo con un tamaño de celda de trama grande; las curvas en el río pueden ser suavizadas si el tamaño de la celda es demasiado grande.
- La precisión con la que se pueden ubicar las ubicaciones de muestra en el campo también se debe tener en cuenta. Por ejemplo, si las ubicaciones se van a encontrar utilizando un GPS con una exactitud posicional de 10 metros, el tamaño de celda debe ser de 10 metros.
- Tenga en cuenta el tamaño de la trama de probabilidad de inclusión, ya que a medida que el número de celdas aumente, también lo hará el tiempo de procesamiento.
Para evitar que los resultados aparezcan desequilibrados espacialmente, se recomienda que el número de ubicaciones de la muestra sea inferior al 1% del número de celdas del ráster de probabilidad de inclusión.
Esta herramienta utiliza un generador de números aleatorios en sus operaciones. El Valor de inicialización utilizado se puede controlar en el entorno Generador de números aleatorios.
- Si se utiliza un valor de inicialización de 0 (el valor predeterminado), cada vez que se ejecute la herramienta se utilizará un conjunto diferente de números aleatorios y se generará una salida diferente.
- Si el valor de inicialización de números aleatorios se establece en un número fijo mayor que 0, la herramienta producirá el mismo conjunto de ubicaciones de muestra cada vez que se ejecute, hasta que se cambie el valor de inicialización. Establecer el valor de inicialización de número aleatorio en un número fijo > 0 es útil si desea generar redes de muestreo candidatas para que pueda elegir la que funcione mejor para sus necesidades.
Nota:
Solo se admite el tipo de generador de números aleatorios Mersenne Twister; si se elige Algoritmo 599 capturado por ACM o Rand C estándar, se utilizará Mersenne Twister en su lugar.
Parámetros
arcpy.ga.CreateSpatiallyBalancedPoints(in_probability_raster, number_output_points, out_feature_class)
| Nombre | Explicación | Tipo de datos |
in_probability_raster | Este ráster define las probabilidades de inclusión para cada ubicación en el área de interés. Los valores de ubicación varían de 0 (probabilidad de inclusión baja) a 1 (probabilidad de inclusión alta). | Raster Layer; Mosaic Layer |
number_output_points | Especifique cuántas ubicaciones de muestra se deben generar. | Long |
out_feature_class | La clase de entidad de salida contiene las ubicaciones de muestra seleccionadas y sus probabilidades de inclusión. | Feature Class |
Muestra de código
Crear un conjunto de puntos espacialmente equilibrados basados en un ráster de probabilidad de inclusión de entrada.
import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.CreateSpatiallyBalancedPoints_ga("ca_prob", "10", "C:/gapyexamples/output/csbp")Crear un conjunto de puntos espacialmente equilibrados basados en un ráster de probabilidad de inclusión de entrada.
# Name: CreateSpatiallyBalancedPoints_Example_02.py
# Description: This tool generates a set of sample points based on inclusion
# probabilities. The resulting sample design is spatially balanced, meaning
# that the spatial independence between samples is maximized, making the
# design more efficient than sampling the study area at random.
# Requirements: Geostatistical Analyst Extension
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"
# Set local variables
inProb = "ca_prob"
numberPoints = 10
outPoints = "C:/gapyexamples/output/csbp"
# Execute CreateSpatiallyBalancedPoints
arcpy.CreateSpatiallyBalancedPoints_ga(inProb, numberPoints, outPoints)Entornos
Información de licenciamiento
- Basic: Requiere Geostatistical Analyst
- Standard: Requiere Geostatistical Analyst
- Advanced: Requiere Geostatistical Analyst