GA Layer To Rasters (Geostatistical Analyst)

Available with Geostatistical Analyst license.

Summary

Exports a geostatistical layer to one or multiple rasters.

Learn more about creating a raster from a geostatistical layer

Usage

  • The primary purpose of this tool is to export geostatistical layers to multiple output types. For example, a geostatistical layer made from Empirical Bayesian Kriging can be exported into a prediction raster, standard error raster, quantile raster, and probability raster with a single run of this tool. This allows fast export of various output types.

  • Using this tool is the only way to create standard error, quantile, or probability maps from the EBK Regression Prediction tool. To get these outputs, create a geostatistical layer using EBK Regression Prediction, and provide the geostatistical layer as input into this tool.

  • If the Input geostatistical layer represents an Indicator, Probability, or Disjunctive kriging method, you can only use the threshold value that was used to create the geostatistical layer. For these methods, the semivariogram is calculated for that particular threshold, and it cannot be recalculated for any other threshold value.

  • If the Input geostatistical layer represents a 3D interpolation model, you must specify the elevation of the contours that you want to export using the Output elevation parameter. The Number of points in the cell (horizontal) and Number of points in the cell (vertical) parameters do not apply to 3D models. The tool will use one point horizontally and vertically regardless of the values provided in these parameters.

Parameters

LabelExplanationData Type
Input geostatistical layer

The geostatistical layer to be analyzed.

Geostatistical Layer
Output raster

The primary output raster to be created. Additional rasters can be created with the Additional output rasters parameter.

Raster Dataset
Output Surface Type
(Optional)

The surface type of the output raster.

For more information, see What output surface types can the interpolation models generate?

  • PredictionA raster of predicted values.
  • Prediction standard errorA raster of standard errors of prediction.
  • ProbabilityA raster predicting the probability that a threshold is exceeded.
  • QuantileA raster predicting the quantile of the predicted value.
  • Standard error of indicatorsA raster of standard errors of indicators.
  • Condition numberA raster showing the condition number for predictions in Local Polynomial Interpolation. The condition number surface indicates the stability of calculations at a particular location. The larger the condition number, the more unstable the prediction, so locations with large condition numbers may be prone to artifacts and erratic predicted values.
String
Quantile or probability value
(Optional)

If the Output surface type is set to Quantile, use this parameter to enter the requested quantile. If the Output surface type is set to Probability, use this parameter to enter the requested threshold value, then the probability that the threshold is exceeded will be calculated.

Note:

If the Input geostatistical layer is a probability or standard errors of indicators map that was created with the Not exceed option, then the probability that this threshold is not exceeded will be calculated. This will apply to all probability raster outputs from this tool.

Double
Output cell size
(Optional)

The cell size of the output rasters. This value will be shared by the Output raster and the Additional output rasters parameters.

Analysis Cell Size
Number of points in the cell (horizontal)
(Optional)

The number of predictions for each cell in the horizontal direction for block interpolation. The default is 1.

Long
Number of points in the cell (vertical)
(Optional)

The number of predictions for each cell in the vertical direction for block interpolation. The default is 1.

Long
Additional output rasters
(Optional)

Provide the name, output type, and quantile or probability value for each additional output raster. See the descriptions of parameters above for more information. These additional rasters will be saved in the same location as the Output raster.

Value Table
Output elevation
(Optional)

For 3D interpolation models, you can export rasters at any elevation. Use this parameter to specify the elevation you want to export. If left empty, the elevation will be inherited from the input layer. The units will default to the same units of the input layer.

Linear Unit

Derived Output

LabelExplanationData Type
Additional rasters

A container for the Additional output rasters.

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})
NameExplanationData Type
in_geostat_layer

The geostatistical layer to be analyzed.

Geostatistical Layer
out_raster

The primary output raster to be created. Additional rasters can be created with the Additional output rasters parameter.

Raster Dataset
output_type
(Optional)

The surface type of the output raster.

For more information, see What output surface types can the interpolation models generate?

  • PREDICTIONA raster of predicted values.
  • PREDICTION_STANDARD_ERRORA raster of standard errors of prediction.
  • PROBABILITYA raster predicting the probability that a threshold is exceeded.
  • QUANTILEA raster predicting the quantile of the predicted value.
  • STANDARD_ERROR_INDICATORSA raster of standard errors of indicators.
  • CONDITION_NUMBERA raster showing the condition number for predictions in Local Polynomial Interpolation. The condition number surface indicates the stability of calculations at a particular location. The larger the condition number, the more unstable the prediction, so locations with large condition numbers may be prone to artifacts and erratic predicted values.
String
quantile_probability_value
(Optional)

If the Output surface type is set to Quantile, use this parameter to enter the requested quantile. If the Output surface type is set to Probability, use this parameter to enter the requested threshold value, then the probability that the threshold is exceeded will be calculated.

Note:

If the Input geostatistical layer is a probability or standard errors of indicators map that was created with the Not exceed option, then the probability that this threshold is not exceeded will be calculated. This will apply to all probability raster outputs from this tool.

Double
cell_size
(Optional)

The cell size of the output rasters. This value will be shared by the Output raster and the Additional output rasters parameters.

Analysis Cell Size
points_per_block_horz
(Optional)

The number of predictions for each cell in the horizontal direction for block interpolation. The default is 1.

Long
points_per_block_vert
(Optional)

The number of predictions for each cell in the vertical direction for block interpolation. The default is 1.

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

Provide the name, output type, and quantile or probability value for each additional output raster. See the descriptions of parameters above for more information. These additional rasters will be saved in the same location as the Output raster.

Value Table
out_elevation
(Optional)

For 3D interpolation models, you can export rasters at any elevation. Use this parameter to specify the elevation you want to export. If left empty, the elevation will be inherited from the input layer. The units will default to the same units of the input layer.

Linear Unit

Derived Output

NameExplanationData Type
out_additional_rasters

A container for the Additional output rasters.

Multiple Value (raster)

Code sample

GALayerToRasters example 1 (Python window)

Convert a geostatistical layer into a raster.

import arcpy
arcpy.GALayerToRasters_ga("ebk", "C:/gapyexamples/output/ras_predict",
                      "PREDICTION", None, "5000", 1, 1, "")
GALayerToRasters example 2 (stand-alone script)

Convert a geostatistical layer into multiple 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")

Licensing information

  • Basic: Requires Geostatistical Analyst
  • Standard: Requires Geostatistical Analyst
  • Advanced: Requires Geostatistical Analyst

Related topics