Couche GA vers rasters (Geostatistical Analyst)

Disponible avec une licence Geostatistical Analyst.

Synthèse

Exporte une couche géostatistique vers un ou plusieurs rasters.

En savoir plus sur la création d’un raster à partir d’une couche géostatistique.

Utilisation

  • Le principal objectif de cet outil consiste à exporter des couches géostatistiques vers plusieurs types de sorties. Par exemple, une couche géostatistique créée à partir de l’outil Krigeage bayésien empirique peut être exportée dans un raster de prédiction, un raster d’erreur standard, un raster quantile et un raster de probabilité en exécutant l’outil une seule fois. Cela permet d’exporter rapidement différents types en sortie.

  • Utiliser cet outil est la seule façon de créer des cartes d’erreurs standard, de quantiles ou de probabilités à partir de l’outil Prévision de la régression EBK. Pour générer ces sorties, créez une couche géostatistique à l’aide de l’outil Prévision de la régression EBK, puis fournissez la couche géostatistique en entrée dans cet outil.

  • Si Couche géostatistique en entrée représente une méthode de krigeage Indicator, Probability ou Disjunctive, vous pouvez uniquement utiliser la valeur de seuil qui a servi à créer la couche géostatistique. Avec ces méthodes, le semi-variogramme est calculé pour ce seuil en particulier. Il ne peut pas être recalculé pour toute autre valeur de seuil.

  • Si Couche géostatistique en entrée représente un modèle d’interpolation 3D, vous devez spécifier l’élévation des isolignes à exporter avec le paramètre Élévation en sortie. Les paramètres Nombre de points dans la cellule (horizontale) et Nombre de points dans la cellule (verticale) ne s’appliquent pas aux modèles 3D. L’outil utilisera un point horizontalement et verticalement, quelles que soient les valeurs fournies dans ces paramètres.

Paramètres

ÉtiquetteExplicationType de données
Couche géostatistique en entrée

Couche géostatistique à analyser.

Geostatistical Layer
Raster en sortie

Raster en sortie principal à créer. Des rasters supplémentaires peuvent être créés avec le paramètre Rasters en sortie supplémentaires.

Raster Dataset
Type de surface en sortie
(Facultatif)

Type de surface du raster en sortie.

Pour en savoir plus, reportez-vous à Quels types de surface en sortie peuvent générer les modèles d’interpolation ?

  • PrévisionRaster de valeurs prédites.
  • Erreur standard de prédictionRaster d’erreurs standard de prédiction.
  • ProbabilitéRaster prédisant la probabilité de dépassement d’un seuil.
  • QuantileRaster prédisant le quantile de la valeur prédite.
  • Erreur standard des indicatricesRaster d’erreurs standard des indicatrices.
  • Indice de conditionnementRaster présentant l’indice de conditionnement des prédictions dans l’interpolation polynomiale locale. La surface de l’indice de conditionnement indique la stabilité des calculs à une localisation particulière. Plus l’indice de conditionnement est élevé, plus la prédiction est instable ; les localisations affichant des indices de conditionnement élevés sont susceptibles de contenir des artefacts et des valeurs prédites irrégulières.
String
Valeur de quantile ou de probabilité
(Facultatif)

Si l’option Type de surface en sortie est définie sur Quantile, utilisez ce paramètre pour saisir le quantile demandé. Si l’option Type de surface en sortie est définie sur Probabilité, utilisez ce paramètre pour saisir la valeur de seuil demandée, et la probabilité de dépassement du seuil sera calculée.

Remarque :

Si la valeur Couche géostatistique en entrée est une carte des probabilités ou d’erreurs standard des indicatrices créée avec l’option Ne pas dépasser, la probabilité de non-dépassement de ce seuil sera calculée. Cela s’applique à tous les rasters de probabilité en sortie de cet outil.

Double
Taille de cellule en sortie
(Facultatif)

Taille de cellule des rasters en sortie. Cette valeur est partagée par les paramètres Raster en sortie et Rasters en sortie supplémentaires.

Analysis Cell Size
Nombre de points dans la cellule (horizontale)
(Facultatif)

Nombre de prévisions pour chaque cellule dans la direction horizontale pour l’interpolation par bloc. La valeur par défaut est 1.

Long
Nombre de points dans la cellule (verticale)
(Facultatif)

Nombre de prévisions pour chaque cellule dans la direction verticale pour l’interpolation par bloc. La valeur par défaut est 1.

Long
Rasters en sortie supplémentaires
(Facultatif)

Fournissez le nom, le type en sortie et la valeur de quantile ou de probabilité pour chaque raster en sortie supplémentaire. Pour plus d’informations, consultez les descriptions des paramètres ci-dessus. Ces rasters supplémentaires sont enregistrés dans la même localisation que le paramètre Raster en sortie.

Value Table
Élévation en sortie
(Facultatif)

Pour les modèles d’interpolation 3D, vous pouvez exporter des rasters à n’importe quelle élévation. Utilisez ce paramètre pour spécifier l’élévation à exporter. Si vous ne renseignez pas ce paramètre, l’élévation est héritée de la couche en entrée. Les unités seront par défaut celles de la couche en entrée.

Linear Unit

Sortie obtenue

ÉtiquetteExplicationType de données
Rasters supplémentaires

Conteneur du paramètre Rasters en sortie supplémentaires.

Multiple Value (raster)

arcpy.ga.GALayerToRasters(in_geostat_layer, out_raster, {output_type}, {quantile_probability_value}, {cell_size}, {points_per_block_horz}, {points_per_block_vert}, {additional_rasters}, {out_elevation})
NomExplicationType de données
in_geostat_layer

Couche géostatistique à analyser.

Geostatistical Layer
out_raster

Raster en sortie principal à créer. Des rasters supplémentaires peuvent être créés avec le paramètre Rasters en sortie supplémentaires.

Raster Dataset
output_type
(Facultatif)

Type de surface du raster en sortie.

Pour en savoir plus, reportez-vous à Quels types de surface en sortie peuvent générer les modèles d’interpolation ?

  • PREDICTIONRaster de valeurs prédites.
  • PREDICTION_STANDARD_ERRORRaster d’erreurs standard de prédiction.
  • PROBABILITYRaster prédisant la probabilité de dépassement d’un seuil.
  • QUANTILERaster prédisant le quantile de la valeur prédite.
  • STANDARD_ERROR_INDICATORSRaster d’erreurs standard des indicatrices.
  • CONDITION_NUMBERRaster présentant l’indice de conditionnement des prédictions dans l’interpolation polynomiale locale. La surface de l’indice de conditionnement indique la stabilité des calculs à une localisation particulière. Plus l’indice de conditionnement est élevé, plus la prédiction est instable ; les localisations affichant des indices de conditionnement élevés sont susceptibles de contenir des artefacts et des valeurs prédites irrégulières.
String
quantile_probability_value
(Facultatif)

Si l’option Type de surface en sortie est définie sur Quantile, utilisez ce paramètre pour saisir le quantile demandé. Si l’option Type de surface en sortie est définie sur Probabilité, utilisez ce paramètre pour saisir la valeur de seuil demandée, et la probabilité de dépassement du seuil sera calculée.

Remarque :

Si la valeur Couche géostatistique en entrée est une carte des probabilités ou d’erreurs standard des indicatrices créée avec l’option Ne pas dépasser, la probabilité de non-dépassement de ce seuil sera calculée. Cela s’applique à tous les rasters de probabilité en sortie de cet outil.

Double
cell_size
(Facultatif)

Taille de cellule des rasters en sortie. Cette valeur est partagée par les paramètres Raster en sortie et Rasters en sortie supplémentaires.

Analysis Cell Size
points_per_block_horz
(Facultatif)

Nombre de prévisions pour chaque cellule dans la direction horizontale pour l’interpolation par bloc. La valeur par défaut est 1.

Long
points_per_block_vert
(Facultatif)

Nombre de prévisions pour chaque cellule dans la direction verticale pour l’interpolation par bloc. La valeur par défaut est 1.

Long
additional_rasters
[[out_raster, output_type, quantile_probability_value],...]
(Facultatif)

Fournissez le nom, le type en sortie et la valeur de quantile ou de probabilité pour chaque raster en sortie supplémentaire. Pour plus d’informations, consultez les descriptions des paramètres ci-dessus. Ces rasters supplémentaires sont enregistrés dans la même localisation que le paramètre Raster en sortie.

Value Table
out_elevation
(Facultatif)

Pour les modèles d’interpolation 3D, vous pouvez exporter des rasters à n’importe quelle élévation. Utilisez ce paramètre pour spécifier l’élévation à exporter. Si vous ne renseignez pas ce paramètre, l’élévation est héritée de la couche en entrée. Les unités seront par défaut celles de la couche en entrée.

Linear Unit

Sortie obtenue

NomExplicationType de données
out_additional_rasters

Conteneur du paramètre Rasters en sortie supplémentaires.

Multiple Value (raster)

Exemple de code

Exemple 1 d’utilisation de la fonction GALayerToRasters (fenêtre Python)

Convertissez une couche géostatistique en raster.

import arcpy
arcpy.GALayerToRasters_ga("ebk", "C:/gapyexamples/output/ras_predict",
                      "PREDICTION", None, "5000", 1, 1, "")
Exemple 2 d’utilisation de la fonction GALayerToRasters (script autonome)

Convertissez une couche géostatistique en plusieurs rasters.

# Name: GALayerToRaster_Example_02.py
# Description: Exports a geostatistical layer to a
#              - prediction raster
#              - standard error of prediction raster
#              - quantile raster
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/output"

# Set local variables
inLayer = "C:/gapyexamples/data/ebk.lyr"
outPredict = "ras_predict"
cellSize = 5000
cellptsHor = 1
cellptsVer = 1

# Execute GALayerToRasters
arcpy.GALayerToRasters_ga(inLayer, outPredict, "PREDICTION", None, cellSize,
                       cellptsHor, cellptsVer,
                       "ras_se PREDICTION_STANDARD_ERROR #;ras_quantile QUANTILE 0.67")

Informations de licence

  • Basic: Nécessite Geostatistical Analyst
  • Standard: Nécessite Geostatistical Analyst
  • Advanced: Nécessite Geostatistical Analyst

Rubriques connexes