Select By Dimension (Multidimension)
Release 9.2 Last modified November 9, 2006	Print all topics in : "Tools"

Updates the netCDF layer display or netCDF table view based on the dimension value.

Usage tips

• Inputs for this tool can be created using the MakeNetCDFFeatureLayer, MakeNetCDFRasterLayer, or MakeNetCDFTableView tools.

• If a dimension is not specified, its value is set to the first value. The first value is considered the default value.

• Auxiliary coordinate variables are not listed in the Dimension Values parameter dropdown list and cannot be set as the value of this parameter at the command line or in a script.

• The BY_INDEX option matches the input value with the position or index of a dimension value. The index is 1 based, that is, the position starts at 1.

• This tool updates the input. In ModelBuilder, an output variable appears that can chain the updated input as input to another tool in the model, but the tool does not produce a new output.

• The following environment settings affect this tool: workspace and scratch workspace.

Command line syntax
An overview of the Command Line window
SelectByDimension_md <in_layer_or_table> {dimension {value};dimension {value}...} {BY_VALUE | BY_INDEX}

Parameter	Explanation	Data Type
<in_layer_or_table>	The input netCDF raster layer, netCDF feature layer, or netCDF table view.	Raster Layer | Feature Layer | Table View
{dimension {value};dimension {value}...}	A set of dimension – value pairs used to specify a slice of a multidimensional variable. dimension — A netCDF dimension. {value} — A value of the dimension to specify a slice of a multidimensional variable.	(String String; String String;...)
{BY_VALUE | BY_INDEX}	Specifies the dimension value selection method. BY_VALUE — The input value is matched with the actual dimension value. BY_INDEX — The input value is matched with the position or index of a dimension value. The index is 0 based, that is, the position starts at 0.	String

Data types for geoprocessing tool parameters

Command line example

SelectByDimension rainfall_layer "time '1900-12-31 00:00:0'" BY_VALUE

Scripting syntax
About getting started with writing geoprocessing scripts
SelectByDimension_md (in_layer_or_table, dimension_values, value_selection_method)

Parameter	Explanation	Data Type
in_layer_or_table (Required)	The input netCDF raster layer, netCDF feature layer, or netCDF table view.	Raster Layer | Feature Layer | Table View
dimension_values (Optional)	A set of dimension – value pairs used to specify a slice of a multidimensional variable. dimension — A netCDF dimension. {value} — A value of the dimension to specify a slice of a multidimensional variable.	(String String; String String;...)
value_selection_method (Optional)	Specifies the dimension value selection method. BY_VALUE — The input value is matched with the actual dimension value. BY_INDEX — The input value is matched with the position or index of a dimension value. The index is 0 based, that is, the position starts at 0.	String

Data types for geoprocessing tool parameters

Script example

# SelectByDimension.py
# Description: Updates the netCDF layer display based on the dimension value.
# Requirements: None
# Author: ESRI

# Create the Geoprocessor object
import arcgisscripting, sys, string, os
gp = arcgisscripting.create()

try:
    # Set local variables
    InNetCDFRasterLayer = "rainfall_layer"
    InDefaultValues = "time '1900-12-31 00:00:0'"
    InValueSelectionMethod = "BY_VALUE"

    # Process: SelectByDimension
    gp.SelectByDimension(InNetCDFRasterLayer, InDefaultValues, InValueSelectionMethod)

except:
    # Print error message if an error occurs
    print gp.GetMessages()

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.