Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | Las entidades de punto de entrada que contiene el campo que se interpolará. | Feature Layer |
Campo de elevación | El campo Entidades de entrada que contiene el valor de elevación de cada punto de entrada. Si los valores de elevación se almacenan como atributos de geometría en Shape.Z, se recomienda utilizar ese campo. Si los valores de elevación se almacenan en un campo de atributo, los valores de elevación deben indicar la distancia respecto al nivel del mar. Los valores positivos indican una distancia por encima del nivel del mar, y los valores negativos indican una distancia por debajo del nivel del mar. | Field |
Campo de valor | El campo Entidades de entrada que contiene los valores medidos que se interpolarán. | Field |
Capa de estadísticas geográficas de salida | La capa de estadísticas geográficas de salida que mostrará el resultado de la interpolación. | Geostatistical Layer |
Unidades del campo de elevación (Opcional) | Las unidades de Campo de elevación. Si Shape.Z se proporciona como campo de elevación, las unidades coincidirán automáticamente con las unidades z del sistema de coordenadas verticales.
| String |
Campo de error de medición (Opcional) | Especifica el error de medición de cada punto de las entidades de entrada. Para cada punto, el valor de este campo debería corresponderse con una desviación estándar del valor medido del punto. Utilice este campo si los valores de error de medición no son los mismos en cada punto. Una fuente común de error de medición no constante es cuando los datos se miden con diferentes dispositivos. Un dispositivo puede ser más preciso que otro, lo que significa que tendrá un error de medición menor. Por ejemplo, un termómetro redondea al grado más cercano y otro a la décima más cercana a un grado. La variabilidad de las mediciones la suele proporcionar el fabricante del dispositivo de medición o se puede conocer de la práctica empírica. Deje este parámetro vacío si no hay ningún valor de error de medición o si se desconocen los valores de error de medición. | Field |
Tipo de modelo de semivariograma (Opcional) | El modelo de semivariograma que se utilizará para la interpolación.
| String |
Tipo de transformación (Opcional) | Tipo de transformación que se aplicará a las entidades de entrada.
| String |
Tamaño de subconjunto (Opcional) | El tamaño del subconjunto. Los datos de entrada se dividirán automáticamente en subconjuntos antes del procesamiento. Este parámetro controla el número de puntos que habrá en cada subconjunto. | Long |
Factor de superposición del área del modelo local (Opcional) | Factor que representa el grado de superposición entre los modelos locales (también llamados subconjuntos). Cada punto de entrada puede encontrarse en varios subconjuntos, y el factor de superposición especifica el número promedio de subconjuntos en los que se encontrará cada punto. Un valor alto de factor de superposición hace que la superficie de salida sea más suave, pero también aumenta el tiempo de procesamiento. Los valores deben estar entre 1 y 5. La superposición real que se utilizará generalmente será mayor que este valor, por lo que cada subconjunto contendrá el mismo número de puntos. | Double |
Número de semivariogramas simulados (Opcional) | El número de semivariogramas simulados de cada modelo local. Utilizar más simulaciones hará que los cálculos del modelo sean más estables, pero el modelo tardará más en calcularse. | Long |
Orden de eliminación de tendencias (Opcional) | El orden de eliminación de tendencias en dirección vertical. Para la mayoría de los datos en tres dimensiones, los valores de los puntos cambian más rápido en vertical que en horizontal. Eliminar la tendencia en la dirección vertical ayudará a mitigar la situación y a estabilizar los cálculos.
| String |
Factor de inflación de elevación (Opcional) | Un valor constante que se multiplica por el valor del Campo de elevación antes de crear un subconjunto y una estimación del modelo. Para la mayoría de los datos en tres dimensiones, los valores de los puntos cambian más rápido en vertical que en horizontal; este factor expande las ubicaciones de los puntos de forma que una unidad de distancia en vertical es estadísticamente equivalente a una unidad de distancia en horizontal. Las ubicaciones de los puntos se volverán a mover a sus ubicaciones originales antes de devolver el resultado de la interpolación. Esta corrección es necesaria para estimar con precisión el modelo de semivariograma y para que Vecindad de búsqueda utilice los vecinos correctos. El factor de inflación de elevación no tiene unidades y proporcionará los mismos resultados independientemente de las unidades de la coordenada x, y o z de los puntos de entrada. Si no se proporciona ningún valor para este parámetro, se calculará uno en tiempo de ejecución utilizando una estimación de máxima probabilidad. El valor se imprimirá como un mensaje de geoprocesamiento. El valor calculado en tiempo de ejecución estará comprendido entre 1 y 1000. Sin embargo, puede escribir valores entre 0,01 y 1.000.000. Si el valor calculado es igual a 1 o 1000, puede proporcionar valores fuera de ese rango y elegir un valor basado en la validación cruzada. | Double |
Vecindad de búsqueda (Opcional) | Especifica el número y la orientación de los vecinos que se utilizarán para predecir valores en nuevas ubicaciones. Standard3D
| Geostatistical Search Neighborhood |
Elevación de salida predeterminada (Opcional) | La elevación predeterminada de la Capa de estadísticas geográficas de salida. La capa de estadísticas geográficas siempre se dibujará como una superficie horizontal en una elevación determinada, y este parámetro especifica esta elevación. Una vez creada, la elevación de la capa de estadísticas geográficas se puede cambiar con el control deslizante de rango. | Double |
Tipo de superficie de salida (Opcional) | El tipo de superficie en el que almacenar los resultados de interpolación.
| String |
Valor de cuantil (Opcional) | El valor de cuantil para el cual se generará la capa de salida. | Double |
Tipo de umbral de probabilidad (Opcional) | Especifica si se calculará la probabilidad de exceder o no exceder el umbral especificado.
| String |
Umbral de probabilidad (Opcional) | El valor del umbral de probabilidad. Si se deja vacío, se utilizará la mediana (cuantil 50) de los datos de entrada. | Double |
Disponible con una licencia de Geostatistical Analyst.
Resumen
El kriging bayesiano empírico 3D es un método de interpolación de estadísticas geográficas que utiliza Kriging bayesiano empírico para interpolar datos de puntos 3D. Para poder interpolarlos, todos los puntos deben tener coordenadas x, y, y z, además de un valor medido. La salida es una capa de estadísticas geográficas 3D que se calcula y se renderiza a sí misma como un transecto 2D en una elevación determinada. La elevación de la capa puede cambiarse con un control deslizante de rango y la capa se actualizará para mostrar las predicciones interpoladas de la nueva elevación.
La interpolación 3D tiene las siguientes aplicaciones potenciales:
- Los oceanógrafos pueden crear mapas de oxígeno disuelto y salinidad a distintas profundidades del océano.
- Los científicos atmosféricos pueden crear modelos de contaminación y gases de efecto invernadero por toda la atmósfera.
- Los geólogos pueden predecir propiedades geológicas del subsuelo, como concentraciones de minerales y porosidad.
Ilustración
Uso
El parámetro Entidades de entrada se puede proporcionar de las siguientes maneras:
- Entidades de puntos 3D con elevaciones almacenadas como un atributo de geometría en Shape.Z
- Entidades de puntos 2D con elevaciones almacenadas en un campo con atributos
Se recomienda que proporcione entidades de puntos 3D porque todas unidades y conversiones de unidades se pueden realizar automáticamente. Puede convertir entidades de puntos 2D con un campo de elevación en entidades de puntos 3D mediante la herramienta de geoprocesamiento De entidad a 3D por atributo.
Capas de estadísticas geográficas en 3D puede predecir puntos de destino en 3D, así como exportarse a rásteres y curvas de nivel de entidades a cualquier elevación. También se pueden exportar simultáneamente varios rásteres a distintas elevaciones y guardarlos como un dataset ráster multidimensional.
Todas las entidades de entrada deben estar en un sistema de coordenadas proyectadas. Si sus puntos están almacenados en un sistema de coordenadas geográficas con coordenadas de latitud y longitud, los puntos deben proyectarse con la herramienta Proyectar antes de utilizar esta herramienta.
Se usa una vecindad de búsqueda Standard3D para calcular predicciones. Todas las distancias utilizadas para buscar vecinos se calcularán en el sistema de coordenadas extendido una vez aplicado el parámetro Factor de inflación de elevación. Consulte Cambio horizontal y vertical en valores de datos para obtener más información.
Parámetros
arcpy.ga.EmpiricalBayesianKriging3D(in_features, elevation_field, value_field, out_ga_layer, {elevation_units}, {measurement_error_field}, {semivariogram_model_type}, {transformation_type}, {subset_size}, {overlap_factor}, {number_simulations}, {trend_removal}, {elev_inflation_factor}, {search_neighborhood}, {output_elevation}, {output_type}, {quantile_value}, {threshold_type}, {probability_threshold})
Nombre | Explicación | Tipo de datos |
in_features | Las entidades de punto de entrada que contiene el campo que se interpolará. | Feature Layer |
elevation_field | El campo in_features que contiene el valor de elevación de cada punto de entrada. Si los valores de elevación se almacenan como atributos de geometría en Shape.Z, se recomienda utilizar ese campo. Si los valores de elevación se almacenan en un campo de atributo, los valores de elevación deben indicar la distancia respecto al nivel del mar. Los valores positivos indican una distancia por encima del nivel del mar, y los valores negativos indican una distancia por debajo del nivel del mar. | Field |
value_field | El campo in_features que contiene los valores medidos que se interpolarán. | Field |
out_ga_layer | La capa de estadísticas geográficas de salida que mostrará el resultado de la interpolación. | Geostatistical Layer |
elevation_units (Opcional) | Las unidades de elevation_field. Si Shape.Z se proporciona como campo de elevación, las unidades coincidirán automáticamente con las unidades z del sistema de coordenadas verticales.
| String |
measurement_error_field (Opcional) | Especifica el error de medición de cada punto de las entidades de entrada. Para cada punto, el valor de este campo debería corresponderse con una desviación estándar del valor medido del punto. Utilice este campo si los valores de error de medición no son los mismos en cada punto. Una fuente común de error de medición no constante es cuando los datos se miden con diferentes dispositivos. Un dispositivo puede ser más preciso que otro, lo que significa que tendrá un error de medición menor. Por ejemplo, un termómetro redondea al grado más cercano y otro a la décima más cercana a un grado. La variabilidad de las mediciones la suele proporcionar el fabricante del dispositivo de medición o se puede conocer de la práctica empírica. Deje este parámetro vacío si no hay ningún valor de error de medición o si se desconocen los valores de error de medición. | Field |
semivariogram_model_type (Opcional) | El modelo de semivariograma que se utilizará para la interpolación.
| String |
transformation_type (Opcional) | Tipo de transformación que se aplicará a las entidades de entrada.
| String |
subset_size (Opcional) | El tamaño del subconjunto. Los datos de entrada se dividirán automáticamente en subconjuntos antes del procesamiento. Este parámetro controla el número de puntos que habrá en cada subconjunto. | Long |
overlap_factor (Opcional) | Factor que representa el grado de superposición entre los modelos locales (también llamados subconjuntos). Cada punto de entrada puede encontrarse en varios subconjuntos, y el factor de superposición especifica el número promedio de subconjuntos en los que se encontrará cada punto. Un valor alto de factor de superposición hace que la superficie de salida sea más suave, pero también aumenta el tiempo de procesamiento. Los valores deben estar entre 1 y 5. La superposición real que se utilizará generalmente será mayor que este valor, por lo que cada subconjunto contendrá el mismo número de puntos. | Double |
number_simulations (Opcional) | El número de semivariogramas simulados de cada modelo local. Utilizar más simulaciones hará que los cálculos del modelo sean más estables, pero el modelo tardará más en calcularse. | Long |
trend_removal (Opcional) | El orden de eliminación de tendencias en dirección vertical. Para la mayoría de los datos en tres dimensiones, los valores de los puntos cambian más rápido en vertical que en horizontal. Eliminar la tendencia en la dirección vertical ayudará a mitigar la situación y a estabilizar los cálculos.
| String |
elev_inflation_factor (Opcional) | Un valor constante que se multiplica por el valor del Campo de elevación antes de crear un subconjunto y una estimación del modelo. Para la mayoría de los datos en tres dimensiones, los valores de los puntos cambian más rápido en vertical que en horizontal; este factor expande las ubicaciones de los puntos de forma que una unidad de distancia en vertical es estadísticamente equivalente a una unidad de distancia en horizontal. Las ubicaciones de los puntos se volverán a mover a sus ubicaciones originales antes de devolver el resultado de la interpolación. Esta corrección es necesaria para estimar con precisión el modelo de semivariograma y para que Vecindad de búsqueda utilice los vecinos correctos. El factor de inflación de elevación no tiene unidades y proporcionará los mismos resultados independientemente de las unidades de la coordenada x, y o z de los puntos de entrada. Si no se proporciona ningún valor para este parámetro, se calculará uno en tiempo de ejecución utilizando una estimación de máxima probabilidad. El valor se imprimirá como un mensaje de geoprocesamiento. El valor calculado en tiempo de ejecución estará comprendido entre 1 y 1000. Sin embargo, puede escribir valores entre 0,01 y 1.000.000. Si el valor calculado es igual a 1 o 1000, puede proporcionar valores fuera de ese rango y elegir un valor basado en la validación cruzada. | Double |
search_neighborhood (Opcional) | Especifica el número y la orientación de los vecinos con la clase SearchNeighborhoodStandard3D. Standard3D
| Geostatistical Search Neighborhood |
output_elevation (Opcional) | La elevación predeterminada de la out_ga_layer. La capa de estadísticas geográficas siempre se dibujará como una superficie horizontal en una elevación determinada, y este parámetro especifica esta elevación. Una vez creada, la elevación de la capa de estadísticas geográficas se puede cambiar con el control deslizante de rango. | Double |
output_type (Opcional) | El tipo de superficie en el que almacenar los resultados de interpolación. Para obtener más información sobre los tipos de superficie de salida, consulte ¿Qué tipos de superficie de salida pueden generar los modelos de interpolación?
| String |
quantile_value (Opcional) | El valor de cuantil para el cual se generará la capa de salida. | Double |
threshold_type (Opcional) | Especifica si se calculará la probabilidad de exceder o no exceder el umbral especificado.
| String |
probability_threshold (Opcional) | El valor del umbral de probabilidad. Si se deja vacío, se utilizará la mediana (cuantil 50) de los datos de entrada. | Double |
Muestra de código
Interpola una clase de entidad de punto 3D utilizando la herramienta Empirical Bayesian Kriging 3D.
import arcpy
arcpy.ga.EmpiricalBayesianKriging3D("my3DLayer", "Shape.Z", "myValueField", "myGALayer", "METER", "",
"POWER", "NONE", 100, 1, 100, "NONE", "",
"NBRTYPE=Standard3D RADIUS=10000 NBR_MAX=15 NBR_MIN=10 SECTOR_TYPE=ONE_SECTOR",
"", "PREDICTION", 0.5, "EXCEED", None)
Interpola una clase de entidad de punto 3D utilizando la herramienta Empirical Bayesian Kriging 3D.
# Name: EBK3D_Example_02.py
# Description: Interpolates 3D points.
# Requirements: Geostatistical Analyst Extension
# Author: Esri
# Import system modules
import arcpy
# Set local variables
in3DPoints = "C:/gapyexamples/input/my3DPoints.shp"
elevationField = "Shape.Z"
valueField = "myValueField"
outGALayer = "myGALayer"
elevationUnit = "METER"
measurementErrorField = "myMEField"
semivariogramModel = "LINEAR"
transformationType = "NONE"
subsetSize = 80
overlapFactor = 1.5
numSimulations = 200
trendRemoval = "FIRST"
elevInflationFactor = 20
radius = 10000
maxNeighbors = 15
minNeighbors = 10
sectorType = "FOUR_SECTORS"
searchNeighborhood = arcpy.SearchNeighborhoodStandard3D(radius, maxNeighbors, minNeighbors, sectorType)
outputElev = 1000
outputType = "PREDICTION"
# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")
# Execute Empirical Bayesian Kriging 3D
arcpy.ga.EmpiricalBayesianKriging3D(in3DPoints, elevationField, valueField, outGALayer, elevationUnit, myMEField,
semivariogramModel, transformationType, subsetSize, overlapFactor, numSimulations,
trendRemoval, elevInflationFactor, searchNeighborhood, outputElev, outputType)
Información de licenciamiento
- Basic: Requiere Geostatistical Analyst
- Standard: Requiere Geostatistical Analyst
- Advanced: Requiere Geostatistical Analyst