NetCDFFileProperties

Summary

The network Common Data Form (netCDF) is a binary, self-describing, machine-independent file format for storing scientific data.

Learn more about netCDF

Syntax

 NetCDFFileProperties (netcdffile)
ParameterExplanationData Type
netcdffile

The input netCDF file.

String

Method Overview

MethodExplanation
getAttributeNames ({variable_name})

Returns the attribute names of a variable in a netCDF file.

getAttributeValue (variable_name, attribute_name)

Returns the value of an attribute.

getDimensionIndex (dimension_name, value)

Returns the dimension index.

getDimensionSize (dimension_name)

Returns the dimension size.

getDimensionValue (dimension_name, index)

Returns the dimension value.

getDimensions ()

Returns the dimensions.

getDimensionsByVariable (variable_name)

Returns the dimensions by variable.

getFieldType (name)

Returns the field type of a variable or dimension.

getSpatialReference (variable_name, x_dimension, y_dimension)

Returns the spatial reference of a variable.

getVariables ()

Returns the variables.

getVariablesByDimension (dimension_name)

Returns the variables by dimension.

Methods

getAttributeNames ({variable_name})
ParameterExplanationData Type
variable_name
[variable_name,...]

A variable name of the netCDF file.

String
Return Value
Data TypeExplanation
String

The attribute names of the variable.

getAttributeValue (variable_name, attribute_name)
ParameterExplanationData Type
variable_name

A variable name of the netCDF file.

String
attribute_name

An attribute name of the netCDF file.

String
Return Value
Data TypeExplanation
Object

The value of the attribute. The type of returned value depends on the dimension type.

getDimensionIndex (dimension_name, value)
ParameterExplanationData Type
dimension_name

A dimension name of the netCDF file.

String
value

The dimension value.

Integer
Return Value
Data TypeExplanation
Integer

The dimension index.

getDimensionSize (dimension_name)
ParameterExplanationData Type
dimension_name

A dimension name of the netCDF file.

String
Return Value
Data TypeExplanation
Integer

The dimension size.

getDimensionValue (dimension_name, index)
ParameterExplanationData Type
dimension_name

A dimension name of the netCDF file.

String
index

The index position.

Integer
Return Value
Data TypeExplanation
Object

The dimension value. The type of returned value depends on the dimension type.

getDimensions ()
Return Value
Data TypeExplanation
String

A list of dimensions.

getDimensionsByVariable (variable_name)
ParameterExplanationData Type
variable_name

A variable name of the netCDF file.

String
Return Value
Data TypeExplanation
String

The dimensions by variable.

getFieldType (name)
ParameterExplanationData Type
name

A variable or dimension name of the netCDF file.

String
Return Value
Data TypeExplanation
String

The field type.

getSpatialReference (variable_name, x_dimension, y_dimension)
ParameterExplanationData Type
variable_name

A variable name of the netCDF file.

String
x_dimension

The x-dimension.

Integer
y_dimension

The y-dimension.

Integer
Return Value
Data TypeExplanation
SpatialReference

The spatial reference of a variable.

getVariables ()
Return Value
Data TypeExplanation
String

A list of variables.

getVariablesByDimension (dimension_name)
ParameterExplanationData Type
dimension_name

A variable name of the netCDF file.

String
Return Value
Data TypeExplanation
String

The list of variables by dimension.

Code sample

NetCDFFileProperties example

Display properties of netCDF file.

import arcpy

in_netcdf = "c:/netCDF/crwr.nc"

nc_fp = arcpy.NetCDFFileProperties(in_netcdf)

# Get Variables
for nc_var in nc_fp.getVariables():
    print("Variable: {}".format(nc_var))
    print("\tVariable type: {}".format(nc_fp.getFieldType(nc_var)))

    # Get dimensions by variable
    for nc_dim_by_var in nc_fp.getDimensionsByVariable(nc_var):
        print("Dimension: {}".format(nc_dim_by_var))
    print(nc_fp.getAttributeValue(nc_var, "units"))

    # Get Variable Attributes
    for nc_va_name in nc_fp.getAttributeNames(nc_var):
        print("Attribute Name: {}".format(nc_va_name))

# Get Dimensions
for nc_dim in nc_fp.getDimensions():
    print("Dimension: {}".format(nc_dim))
    print("\tDimension size: {}".format(nc_fp.getDimensionSize(nc_dim)))
    print("\tDimension type: {}".format(nc_fp.getFieldType(nc_dim)))

    for i in range(0, nc_fp.getDimensionSize(nc_dim)):
        nc_dim_value = nc_fp.getDimensionValue(nc_dim, i)
        print("\tDimension value: {}".format(nc_dim_value))
        print("\tDimension index: {}".format(
            nc_fp.getDimensionIndex(nc_dim, nc_dim_value)))

    # Get Variable by dimension
    for nc_vars_by_dim in nc_fp.getVariablesByDimension(nc_dim):
        print("\tVariable by dimension: {}".format(nc_vars_by_dim))

# Get Global Attribues
for nc_att_name in nc_fp.getAttributeNames(""):
    print("Attribute Name: {}".format(nc_att_name))
    print(nc_fp.getAttributeValue("", nc_att_name))

Related topics