Subset Features (Geostatisical Analyst)

License Level:BasicStandardAdvanced

Summary

Divides the original dataset into two parts: one part to be used to model the spatial structure and produce a surface, the other to be used to compare and validate the output surface.

Learn more about Subset Features

Usage

Syntax

SubsetFeatures_ga (in_features, out_training_feature_class, {out_test_feature_class}, {size_of_training_dataset}, {subset_size_units})
ParameterExplanationData Type
in_features

Points, lines, polygon features or table from which to create a subset.

Table View
out_training_feature_class

The subset of training features to be created.

Feature Class; Table
out_test_feature_class
(Optional)

The subset of test features to be created.

Feature Class; Table
size_of_training_dataset
(Optional)

The size of the output training feature class, entered either as a percentage of the input features or as an absolute number of features.

Double
subset_size_units
(Optional)

Type of subset size.

  • PERCENTAGE_OF_INPUT The percentage of the input features that will be in the training dataset.
  • ABSOLUTE_VALUE The number of features that will be in the training dataset.
Boolean

Code Sample

SubsetFeatures example 1 (Python window)

Randomly split the features into two feature classes.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.SubsetFeatures_ga("ca_ozone_pts", "C:/gapyexamples/output/training", 
                        "", "", "PERCENTAGE_OF_INPUT")
SubsetFeatures example 2 (stand-alone script)

Randomly split the features into two feature classes.

# Name: SubsetFeatures_Example_02.py
# Description: Randomly split the features into two feature classes.
# Requirements: Geostatistical Analyst Extension

# Import system modules
import arcpy

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

# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
outtrainPoints = "C:/gapyexamples/output/training.shp"
outtestPoints = ""
trainData = ""
subsizeUnits = "PERCENTAGE_OF_INPUT"

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

# Execute SubsetFeatures
arcpy.SubsetFeatures_ga(inPointFeatures, outtrainPoints, outtestPoints, 
                        trainData, subsizeUnits)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires Geostatistical Analyst
ArcGIS for Desktop Standard: Requires Geostatistical Analyst
ArcGIS for Desktop Advanced: Requires Geostatistical Analyst
6/24/2013