CrossValidationResult

Summary

The CrossValidationResult class is returned by the Cross Validation tool and contains access to the cross-validation results that can be generated for any geostatistical layer.

Discussion

The CrossValidationResult class is similar to the Result class except for the additional read-only properties that it contains. For detailed help, see the Cross Validation tool.

Only the mean and root mean square error results are available for IDW, Global Polynomial Interpolation, Radial Basis Functions, Diffusion Interpolation With Barriers, and Kernel Interpolation With Barriers.

Percent in 90% Interval, Percent in 95% Interval, and Average CRPS are only available for Empirical Bayesian Kriging and EBK Regression Prediction models.

Properties

PropertyExplanationData Type
averageCRPS
(Read Only)

The average of the Continuous Ranked Probability Scores (CRPS) for all points.

Double
averageStandard
(Read Only)

The average of the prediction standard errors.

Double
count
(Read Only)

The number of input samples.

Long
inputCount
(Read Only)

Returns the number of inputs.

Integer
maxSeverity
(Read Only)

Returns the maximum severity of the messages.

  • 0If the tool produced only informative messages.
  • 1 If the tool produced a warning message, but no error messages.
  • 2 If the tool produced an error message.
Integer
meanError
(Read Only)

The averaged difference between the measured and the predicted values.

Double
meanStandardized
(Read Only)

Mean standardized error.

Double
messageCount
(Read Only)

Returns the number of messages.

Integer
outputCount
(Read Only)

Returns the number of outputs.

Integer
percentIn90Interval
(Read Only)

The percentage of points that are contained in a 90 percent cross validated confidence interval.

Double
percentIn95Interval
(Read Only)

The percentage of points that are contained in a 95 percent cross validated confidence interval.

Double
resultID
(Read Only)

Gets the job ID. If the tool is not a geoprocessing service, the resultID will be "".

String
rootMeanSquare
(Read Only)

The root mean square error.

Double
rootMeanSquareStandardized
(Read Only)

The root-mean-square-standardized error should be close to 1 if the prediction standard errors are valid. If the root-mean-square-standardized error is greater than 1, you are underestimating the variability in your predictions. If the root-mean-square-standardized error is less than 1, you are overestimating the variability in your predictions.

Double
status
(Read Only)

Gets the job status.

  • 0New
  • 1Submitted
  • 2Waiting
  • 3Executing
  • 4Succeeded
  • 5Failed
  • 6Timed out
  • 7Cancelling
  • 8Cancelled
  • 9Deleting
  • 10Deleted
Integer

Method Overview

MethodExplanation
cancel ()

Cancels an associated job

getInput (index)

Returns a given input, either as a string or a RecordSet object.

getMapImageURL ({parameter_list}, {height}, {width}, {resolution})

Returns a map service image for a given output, if one exists.

getMessage (index)

Returns a specific message by index position.

getMessages ({severity})

Returns the geoprocessing tool messages.

getOutput (index)

Returns a given output, either as a RecordSet object or a string.

If the output of the tool, such as Make Feature Layer, is a layer, getOutput will return a Layer object.

getSeverity (index)

Returns the severity of a specific message.

Methods

cancel ()
getInput (index)
ParameterExplanationData Type
index

The index position of the input as an integer, or the parameter name.

Variant
Return Value
Data TypeExplanation
Variant

The input, either as a RecordSet object or a string.

getMapImageURL ({parameter_list}, {height}, {width}, {resolution})
ParameterExplanationData Type
parameter_list

The parameters on which the map service image will be based.

Integer
height

The height of the image.

Double
width

The width of the image.

Double
resolution

The resolution of the image.

Double
Return Value
Data TypeExplanation
String

The URL of the map image.

getMessage (index)
ParameterExplanationData Type
index

The index position of the message.

Integer
Return Value
Data TypeExplanation
String

The geoprocessing message.

getMessages ({severity})
ParameterExplanationData Type
severity

The type of messages to be returned.

  • 0Informative, warning, and error messages are returned.
  • 1Only warning messages are returned.
  • 2Only error messages are returned.

Not specifying a severity level will return all types of messages.

(The default value is 0)

Integer
Return Value
Data TypeExplanation
String

The geoprocessing tool messages.

getOutput (index)
ParameterExplanationData Type
index

The index position of the output as an integer, or the parameter name.

Variant
Return Value
Data TypeExplanation
Variant

The output, either as a RecordSet or a string.

If the output of the tool, such as Make Feature Layer, is a layer, getOutput will return a Layer object.

Result outputs can also be accessed by index by integer or by name. For example, to access the record count from the Get Count tool, result.getOutput(0), result[0], result.getOutput("row_count"), and result["row_count"] are equivalent.

getSeverity (index)
ParameterExplanationData Type
index

The message index position.

Integer
Return Value
Data TypeExplanation
Integer

The severity of the specific message.

  • 0Informative, warning, and error messages are returned.
  • 1Only warning messages are returned.
  • 2Only error messages are returned.

Code sample

CrossValidation (Python window)

Perform cross-validation on an input geostatistical layer.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
cvResult = arcpy.CrossValidation_ga("C:/gapyexamples/data/kriging.lyr")
print("Root Mean Square error = " + str(cvResult.rootMeanSquare))
CrossValidation (stand-alone script)

Perform cross-validation on an input geostatistical layer.

# Name: CrossValidation_Example_02.py
# Description: Perform cross validation on an input geostatistical layer.
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

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

# Set local variables
inLayer = "C:/gapyexamples/data/kriging.lyr"

# Execute CrossValidation
cvResult = arcpy.CrossValidation_ga(inLayer)
print("Root Mean Square error = " + str(cvResult.rootMeanSquare))