Show Navigation | Hide Navigation
You are here:
Geoprocessing tool reference > Multidimensional toolbox > Tools

Make NetCDF Feature Layer (Multidimension)

Release 9.2
Last modified November 9, 2006
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

Makes an in-memory feature layer from a netCDF file.


Usage tips

Command line syntax
An overview of the Command Line window
MakeNetCDFFeatureLayer_md <in_netcdf_file> <variable;variable...> <x_variable> <y_variable> <out_feature_layer> {row_dimension;row_dimension...} {z_variable} {m_variable} {dimension {value};dimension {value}...} {BY_VALUE | BY_INDEX}

Parameter Explanation Data Type
<in_netcdf_file>

The input netCDF file.

File
<variable;variable...>

The netCDF variable, or variables, that will be added as fields in the feature attribute table.

String
<x_variable>

A netCDF coordinate variable used to define the x, or longitude coordinates of the output layer.

String
<y_variable>

A netCDF coordinate variable used to define the y, or latitude coordinates of the output layer.

String
<out_feature_layer>

The name of the output feature layer.

Feature Layer
{row_dimension;row_dimension...}

The netCDF dimension, or dimensions, used to create features with unique values in the feature layer. The dimension or dimensions set here determine the number of features in the feature layer and the fields that will be presented in the feature layer's attribute table.

For instance, if StationID is a dimension in the netCDF file and has 10 values, by setting StationID as the dimension to use, 10 features will be created (10 rows will be created in the feature layer's attribute table). If StationID and time are used, and there are 3 time slices, 30 features will be created (30 rows will be created in the feature layer's attribute table). If you will be animating the netCDF feature layer, it is recommended, for efficiency reasons, to not set time as a row dimension. Time will still be available as a dimension that you can set to animate through, but the attribute table will not store this information.

String
{z_variable}

A netCDF variable used to specify elevation values (z-values) for features.

String
{m_variable}

A netCDF variable used to specify linear measurement values (m-values) for features.

String
{dimension {value};dimension {value}...}

The value (such as 01/30/05) of the dimension (such as Time) or dimensions to use when displaying the variable in the output layer. By default, the first value of the dimension or dimensions will be used. This default value can also be altered on the netCDF tab of the Layer Properties dialog box.

(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 i.e. the position starts from 0.

String
Data types for geoprocessing tool parameters


Command line example

MakeNetCDFFeatureLayer C:\Data\River.nc "Waterlevel; Discharge" lon lat river_Layer StationId # chainage # 

Scripting syntax
About getting started with writing geoprocessing scripts
MakeNetCDFFeatureLayer_md (in_netcdf_file, variable, x_variable, y_variable, out_feature_layer, row_dimension, z_variable, m_variable, dimension_values, value_selection_method)

Parameter Explanation Data Type
in_netcdf_file (Required)

The input netCDF file.

File
variable (Required)

The netCDF variable, or variables, that will be added as fields in the feature attribute table.

String
x_variable (Required)

A netCDF coordinate variable used to define the x, or longitude coordinates of the output layer.

String
y_variable (Required)

A netCDF coordinate variable used to define the y, or latitude coordinates of the output layer.

String
out_feature_layer (Required)

The name of the output feature layer.

Feature Layer
row_dimension (Optional)

The netCDF dimension, or dimensions, used to create features with unique values in the feature layer. The dimension or dimensions set here determine the number of features in the feature layer and the fields that will be presented in the feature layer's attribute table.

For instance, if StationID is a dimension in the netCDF file and has 10 values, by setting StationID as the dimension to use, 10 features will be created (10 rows will be created in the feature layer's attribute table). If StationID and time are used, and there are 3 time slices, 30 features will be created (30 rows will be created in the feature layer's attribute table). If you will be animating the netCDF feature layer, it is recommended, for efficiency reasons, to not set time as a row dimension. Time will still be available as a dimension that you can set to animate through, but the attribute table will not store this information.

String
z_variable (Optional)

A netCDF variable used to specify elevation values (z-values) for features.

String
m_variable (Optional)

A netCDF variable used to specify linear measurement values (m-values) for features.

String
dimension_values (Optional)

The value (such as 01/30/05) of the dimension (such as Time) or dimensions to use when displaying the variable in the output layer. By default, the first value of the dimension or dimensions will be used. This default value can also be altered on the netCDF tab of the Layer Properties dialog box.

(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 i.e. the position starts from 0.

String

Data types for geoprocessing tool parameters


Script example

# MakeNetCDFFeatureLayer.py
# Description: Create a feature layer from a netCDF file.
# Requirements: None
# Author: ESRI

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

try:
    # Set local variables
    InNetCDFFile = "D:/NetCDFSupport/NetCDFScriptSamples/Data/River.nc"
    InVariables = "Waterlevel; Discharge"
    InXVariable = "lon"
    InYVariable = "lat"
    OutFeatureLayer = "river_Layer"
    InRowDimensions = "StationId"
    InZVariable = ""
    InMVariable = "chainage"
    InDefaultValues = ""

    # Process: MakeNetCDFFeatureLayer
    gp.MakeNetCDFFeatureLayer (InNetCDFFile, InVariables, InXVariable, InYVariable, OutTableView, InRowDimensions, InDefaultValues)

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.