Couche GA 3D vers raster multidimensionnel (Geostatistical Analyst)

Disponible avec une licence Geostatistical Analyst.

Synthèse

Exporte une couche géostatistique 3D créée à l’aide de l’outil Krigeage bayésien empirique 3D vers un jeu de données raster au format Cloud Raster Format multidimensionnel (fichier *.crf). Les outils du jeu d’outils Analyse multidimensionnelle de la boîte à outils Image Analyst sont conçus pour fonctionner directement sur des rasters multidimensionnels et peuvent identifier la nature 3D des données.

Les couches géostatistiques 3D stockent les résultats d’interpolation 3D continus et s’affichent sous forme de tranches horizontales 2D à une élévation donnée. L’élévation actuelle peut être modifiée avec le curseur de plage, et la couche calcule et affiche les valeurs prévues de la nouvelle élévation. Les rasters des prévisions interpolées peuvent être extraits à n’importe quelle élévation à l’aide de l’outil Couche GA vers rasters. L’outil Couche GA 3D vers raster multidimensionnel automatise le processus d’extraction des rasters à plusieurs élévations et les stocke sous forme de jeu de données raster multidimensionnel.

Utilisation

  • La Couche géostatistique 3D en entrée doit être créée avec l’outil Krigeage bayésien empirique 3D.

  • Vous pouvez fournir les élévations souhaitées de l’une des façons suivantes :

    • Fournir les valeurs d’élévation avec un itérateur : laissez le paramètre Saisir des valeurs d’élévation explicites décoché et indiquez des valeurs pour les paramètres Élévation minimale, Élévation maximale et Intervalle d’élévation. L’itération commence à la valeur minimale et augmente en respectant l’intervalle jusqu’à la valeur maximale. Par exemple, si vous fournissez une élévation minimale de 0, une valeur maximale de 100 et un intervalle de 20, la sortie aura six élévations : 0, 20, 40, 60, 80 et 100.
    • Fournir les valeurs d’élévation explicites : cochez le paramètre Saisir des valeurs d’élévation explicites et indiquez les élévations souhaitées dans le paramètre Valeurs d’élévation.
    Le paramètre Unités d’élévation spécifie l’unité de chaque valeur d’élévation.

  • Si la valeur Intervalle d’élévation fournie ne permet pas de diviser équitablement la plage d’élévation (Élévation maximale moins Élévation minimale), une élévation qui dépasse l’élévation maximale est utilisée. Par exemple, si vous fournissez une élévation minimale de 10, une élévation maximale de 80 et un intervalle d’élévation de 20, la sortie aura cinq élévations : 10, 30, 50, 70 et 90.

  • La taille de cellule raster par défaut du paramètre Jeu de données raster multidimensionnel en sortie est la plus petite étendue en sortie des dimensions x et y, divisée par 100. Le nombre par défaut de tranches d’élévation est 10. Cela génère un raster multidimensionnel avec une résolution x et y qui est au moins 10 fois supérieure à la résolution z. Il est donc important de faire attention à ces valeurs, en particulier si vous voulez approximativement la même résolution dans les trois dimensions. L’augmentation de la taille de cellule ou l’augmentation du nombre de tranches d’élévation a pour effet de générer des sorties plus proches de la même résolution dans toutes les dimensions.

  • Le temps d’exécution de l’outil est approximativement proportionnel au nombre de prévisions globales requises, et chaque cellule raster de chaque élévation nécessite le calcul d’une valeur prévue. Par défaut, le temps d’exécution de l’outil est environ 60 pour cent plus long que l’exportation d’une seule tranche d’élévation à l’aide de l’outil Couche GA vers rasters. L’intégration de Types de sorties supplémentaires n’augmente pas considérablement le temps d’exécution car plusieurs types en sortie peuvent être prévus simultanément.

  • Si des Types de sorties supplémentaires sont fournis, le raster en sortie sera un jeu de données raster multidimensionnel multivarié avec une variable différente pour chaque type en sortie.

  • Les performances de tous les outils du jeu d’outils Analyse multidimensionnelle de la boîte à outils Image Analyst sont accrues si des transpositions sont créées sur le raster multidimensionnel. Vous pouvez utiliser le paramètre Créer une transposition multidimensionnelle pour les créer automatiquement, mais cela augmente le temps d’exécution de l’outil. Vous pouvez également utiliser l’outil Créer une transposition multidimensionnelle pour créer les transpositions ultérieurement.

Paramètres

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

Couche géostatistique 3D représentant le modèle à exporter vers un jeu de données raster multivarié.

Geostatistical Layer
Jeu de données raster multidimensionnel en sortie

Jeu de données raster en sortie contenant les résultats de l’exportation du modèle géostatistique. La sortie doit être enregistrée sous forme d’un fichier Cloud Raster Format (*.crf).

Raster Dataset
Taille de cellule
(Facultatif)

Taille de cellule du raster multidimensionnel en sortie.

Analysis Cell Size
Saisir des valeurs d’élévation explicites
(Facultatif)

Indique si des élévations seront fournies sous forme de liste explicite ou si un itérateur sera utilisé. Chaque élévation est représentée par une dimension dans le raster multidimensionnel en sortie.

  • Activé : des valeurs d’élévation seront fournies sous forme de liste.
  • Désactivé : des valeurs d’élévation seront fournies à l’aide d’un itérateur. Il s’agit de l’option par défaut.
Boolean
Élévation minimale
(Facultatif)

Élévation minimale utilisée pour démarrer l’itération.

Double
Élévation maximale
(Facultatif)

Élévation maximale utilisée pour arrêter l’itération.

Double
Intervalle d’élévation
(Facultatif)

Incrément dont augmentera l’élévation à chaque itération.

Double
Valeurs d’élévation
(Facultatif)

Valeurs d’élévation à exporter.

Double
Unités d’élévation
(Facultatif)

Indique l’unité de mesure des valeurs d’élévation.

  • Pouces d’arpentage américainsLes élévations sont en pouces d’arpentage américains.
  • Pieds d’arpentage américainsLes élévations sont en pieds d’arpentage américains.
  • Yards d’arpentage américainsLes élévations sont en yards d’arpentage américains.
  • Miles d’arpentage américainsLes élévations sont en miles d’arpentage américains.
  • Milles nautiques d’arpentage américainsLes élévations sont en milles nautiques d’arpentage américains.
  • MillimètresLes élévations sont en millimètres.
  • CentimètresLes élévations sont en centimètres.
  • DécimètresLes élévations sont en décimètres.
  • MètresLes élévations sont en mètres.
  • KilomètresLes élévations sont en kilomètres.
  • Pouces internationauxLes élévations sont en pouces internationaux.
  • Pieds internationauxLes élévations sont en pieds internationaux.
  • Yards internationauxLes élévations sont en yards internationaux.
  • Milles terrestresLes élévations sont en milles terrestres.
  • Milles nautiques internationauxLes élévations sont en milles nautiques internationaux.
String
Type en sortie
(Facultatif)

Indique le type en sortie principal du raster multidimensionnel en sortie. Vous pouvez utiliser le paramètre Types de sorties supplémentaires pour spécifier des variables supplémentaires dans le raster multidimensionnel 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 multidimensionnel de valeurs prévues. Il s’agit de l’option par défaut.
  • Erreur standard de prévisionRaster multidimensionnel d’erreurs standards de prévision.
  • ProbabilitéRaster multidimensionnel prévoyant la probabilité de dépassement d’un seuil.
  • QuantileRaster multidimensionnel prévoyant le quantile de la valeur prévue.
String
Valeur de seuil de quantile ou de probabilité
(Facultatif)

Si l’option Type en sortie est définie sur Quantile, utilisez ce paramètre pour saisir le quantile demandé. Si l’option Type 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. Soustrayez cette valeur de un pour obtenir la probabilité de non-dépassement du seuil.

Double
Types de sorties supplémentaires
(Facultatif)

Spécifie le type en sortie et la valeur de quantile ou de probabilité pour chaque type en sortie supplémentaire. Si plusieurs types de sorties supplémentaires sont fournis, le raster en sortie sera un jeu de données raster multivarié avec une variable différente pour chaque type en sortie.

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

Value Table
Créer une transposition multidimensionnelle
(Facultatif)

Indique si des transpositions multidimensionnelles seront créées sur le raster multidimensionnel en sortie.

  • Activé : des transpositions multidimensionnelles seront créées sur le raster multidimensionnel en sortie.
  • Désactivé : aucune transposition multidimensionnelle ne sera créée sur le raster multidimensionnel en sortie. Il s’agit de l’option par défaut.
Boolean

arcpy.ga.GALayer3DToMultidimensionalRaster(in_3d_geostat_layer, out_multidimensional_raster, {cell_size}, {explicit_only}, {min_elev}, {max_elev}, {elev_interval}, {elev_values}, {elev_units}, {output_type}, {quantile_probability_value}, {additional_outputs}, {build_transpose})
NomExplicationType de données
in_3d_geostat_layer

Couche géostatistique 3D représentant le modèle à exporter vers un jeu de données raster multivarié.

Geostatistical Layer
out_multidimensional_raster

Jeu de données raster en sortie contenant les résultats de l’exportation du modèle géostatistique. La sortie doit être enregistrée sous forme d’un fichier Cloud Raster Format (*.crf).

Raster Dataset
cell_size
(Facultatif)

Taille de cellule du raster multidimensionnel en sortie.

Analysis Cell Size
explicit_only
(Facultatif)

Indique si des élévations seront fournies sous forme de liste explicite ou si un itérateur sera utilisé.

  • EXPLICIT_VALUESDes valeurs d’élévation seront fournies sous forme de liste.
  • NO_EXPLICIT_VALUESDes valeurs d’élévation seront fournies à l’aide d’un itérateur. Il s’agit de l’option par défaut.
Boolean
min_elev
(Facultatif)

Élévation minimale utilisée pour démarrer l’itération.

Double
max_elev
(Facultatif)

Élévation maximale utilisée pour arrêter l’itération.

Double
elev_interval
(Facultatif)

Incrément dont augmentera l’élévation à chaque itération.

Double
elev_values
[elev_values,...]
(Facultatif)

Valeurs d’élévation à exporter.

Double
elev_units
(Facultatif)

Indique l’unité de mesure des valeurs d’élévation.

  • INCHLes élévations sont en pouces d’arpentage américains.
  • FOOTLes élévations sont en pieds d’arpentage américains.
  • YARDLes élévations sont en yards d’arpentage américains.
  • MILE_USLes élévations sont en miles d’arpentage américains.
  • NAUTICAL_MILELes élévations sont en milles nautiques d’arpentage américains.
  • MILLIMETERLes élévations sont en millimètres.
  • CENTIMETERLes élévations sont en centimètres.
  • DECIMETERLes élévations sont en décimètres.
  • METERLes élévations sont en mètres.
  • KILOMETERLes élévations sont en kilomètres.
  • INCH_INTLes élévations sont en pouces internationaux.
  • FOOT_INTLes élévations sont en pieds internationaux.
  • YARD_INTLes élévations sont en yards internationaux.
  • MILE_INTLes élévations sont en milles terrestres.
  • NAUTICAL_MILE_INTLes élévations sont en milles nautiques internationaux.
String
output_type
(Facultatif)

Indique le type en sortie principal du raster multidimensionnel en sortie. Vous pouvez utiliser le paramètre Types de sorties supplémentaires pour spécifier des variables supplémentaires dans le raster multidimensionnel en sortie.

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

  • PREDICTIONRaster multidimensionnel de valeurs prévues. Il s’agit de l’option par défaut.
  • PREDICTION_STANDARD_ERRORRaster multidimensionnel d’erreurs standards de prévision.
  • PROBABILITYRaster multidimensionnel prévoyant la probabilité de dépassement d’un seuil.
  • QUANTILERaster multidimensionnel prévoyant le quantile de la valeur prévue.
String
quantile_probability_value
(Facultatif)

Si l’option Type en sortie est définie sur Quantile, utilisez ce paramètre pour saisir le quantile demandé. Si l’option Type 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. Soustrayez cette valeur de un pour obtenir la probabilité de non-dépassement du seuil.

Double
additional_outputs
[[output_type, quantile_probability_value],...]
(Facultatif)

Spécifie le type en sortie et la valeur de quantile ou de probabilité pour chaque type en sortie supplémentaire. Si plusieurs types de sorties supplémentaires sont fournis, le raster en sortie sera un jeu de données raster multivarié avec une variable différente pour chaque type en sortie.

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

Value Table
build_transpose
(Facultatif)

Indique si des transpositions multidimensionnelles seront créées sur le raster multidimensionnel en sortie.

  • BUILD_TRANSPOSEDes transpositions multidimensionnelles seront créées sur le raster multidimensionnel en sortie.
  • DO_NOT_BUILD_TRANSPOSEAucune transposition multidimensionnelle ne sera créée sur le raster multidimensionnel en sortie. Il s’agit de l’option par défaut.
Boolean

Exemple de code

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

Interpoler des points 3D et convertir la sortie en raster multivarié.

import arcpy
arcpy.ga.EmpiricalBayesianKriging3D("my3DLayer", "Shape.Z", "myValueField", "my3DGALayer")
arcpy.ga.GALayer3DToMultivariateRaster("my3DGALayer", r"C:\\gapydata\\outputMDRD.crf", 1000,
                                       "NO_EXPLICIT_VALUES", 0, 500, 50, "","METERS",
                                       "PREDICTION", "", [["PREDICTION_STANDARD_ERROR",""]],
                                       "BUILD_TRANSPOSE")
Exemple 2 d’utilisation de la fonction GALayer3DToMultivariateRaster (script autonome)

Interpoler des points 3D et convertir la sortie en raster multivarié avec plusieurs types en sortie et transpositions.

# Name: GALayer3DToMDR_Example_02.py
# Description: Interpolates 3D points and exports to a multidimensional raster dataset.
# 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"


# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")

# Execute Empirical Bayesian Kriging 3D
arcpy.ga.EmpiricalBayesianKriging3D(in3DPoints, elevationField, valueField, outGALayer)


# Export predictions and standard errors to multidimensional raster with tranposes.

# Set up variables
outMDRaster = r"C:\\gapydata\\outputMDRD.crf"
explicitVals = "NO_EXPLICIT_VALUES"
cell_size = 1000
min_elev = 0
max_elev = 500
elev_interval = 50
elev_list = ""
elev_units = "METERS"
out_type = "PREDICTION"
quan_value = ""
add_outputs = [["PREDICTION_STANDARD_ERROR",""]]
transpose = "BUILD_TRANSPOSE"

# Additionally output prediction standard errors.
arcpy.ga.GALayer3DToMultivariateRaster(outGALayer, outMDRaster, cell_size, explicitVals,
                                       min_elev, max_elev, elev_interval, elev_list,
                                       elev_units, out_type, quan_value, add_outputs,
                                       transpose)

Informations de licence

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

Rubriques connexes