NetCDFFileProperties

Summary

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

Syntax

NetCDFFileProperties ({netCDFFile})

Parameter	Explanation	Data Type
netCDFFile	The input netCDF file.	String

Method Overview

Method	Explanation
getAttributeNames ({variable_name})	Gets the attribute names of a variable in a NetCDF file.
getAttributeValue (variable_name, attribute_name)	Get the value of an attribute.
getDimensionIndex (dimension_name, value)	Gets the dimension index.
getDimensionSize (dimension_name)	Gets the dimension size.
getDimensionValue (dimension_name, index)	Gets the dimension value.
getDimensions ()	Gets the dimensions.
getDimensionsByVariable (variable_name)	Gets the dimensions by variable.
getFieldType (name)	Gets the field type of a variable or dimension.
getSpatialReference (variable_name, x_dimension, y_dimension)	Gets the spatial reference of a variable.
getVariables ()	Gets the variables.
getVariablesByDimension (dimension_name)	Get the variables by dimension.

Methods

getAttributeNames ({variable_name})

Parameter	Explanation	Data Type
variable_name [variable_name,...]	Variable name of the NetCDF file.	String

Return Value

Data Type	Explanation
String	The attribute names of the variable.

getAttributeValue (variable_name, attribute_name)

Parameter	Explanation	Data Type
variable_name	Variable name of the netCDF file.	String
attribute_name	Attribute name of the netCDF file.	String

Return Value

Data Type	Explanation
Object	The value of the attribute. The type of returned value depends on the dimension type.

getDimensionIndex (dimension_name, value)

Parameter	Explanation	Data Type
dimension_name	Dimension name of the NetCDF file.	String
value	The dimension value.	Integer

Return Value

Data Type	Explanation
Integer	The dimension index.

getDimensionSize (dimension_name)

Parameter	Explanation	Data Type
dimension_name	Dimension name of the NetCDF file.	String

Return Value

Data Type	Explanation
Integer	The dimension size.

getDimensionValue (dimension_name, index)

Parameter	Explanation	Data Type
dimension_name	Dimension name of the NetCDF file.	String
index	The index position.	Integer

Return Value

Data Type	Explanation
Object	The dimension value. The type of returned value depends on the dimension type.

getDimensions ()

Return Value

Data Type	Explanation
String	List of dimensions.

getDimensionsByVariable (variable_name)

Parameter	Explanation	Data Type
variable_name	Variable name of the NetCDF file.	String

Return Value

Data Type	Explanation
String	The dimensions by variable.

getFieldType (name)

Parameter	Explanation	Data Type
name	Variable or dimension name of the NetCDF file.	String

Return Value

Data Type	Explanation
String	The field type.

getSpatialReference (variable_name, x_dimension, y_dimension)

Parameter	Explanation	Data Type
variable_name	Variable name of the NetCDF file.	String
x_dimension	The x-dimension.	Integer
y_dimension	The y-dimension.	Integer

Return Value

Data Type	Explanation
SpatialReference	The spatial reference of a variable.

getVariables ()

Return Value

Data Type	Explanation
String	List of variables.

getVariablesByDimension (dimension_name)

Parameter	Explanation	Data Type
dimension_name	Variable name of the netCDF file	String

Return Value

Data Type	Explanation
String	List of variables by dimension

Code Sample

NetCDFFileProperties example

Display properties of NetCDF file.

import arcpy

InNetCDF = "c:/NetCDF/crwr.nc"
try:
    ncFP = arcpy.NetCDFFileProperties(InNetCDF)

    #Get Variables    
    ncVars = ncFP.getVariables()
    for ncVar in ncVars:
        print "Variable: %s" % ncVar
        ncVarType = ncFP.getFieldType(ncVar)        
        print "\t" + "Variable type: %s " % ncVarType

        #Get dimensions by variable        
        ncDimsByVar = ncFP.getDimensionsByVariable(ncVar)
        for ncDimByVar in ncDimsByVar:
            print "Dimension: %s " % ncDimByVar
        print ncFP.getAttributeValue(ncVar, "units")

        #Get Variable Attribues
        ncVANames = ncFP.getAttributeNames(ncVar)

        for ncVAName in ncVANames:
            print "Attribute Name: %s " % ncVAName        

    #Get Dimensions
    ncDims = ncFP.getDimensions()

    for ncDim in ncDims:
        print "Dimension: %s " % ncDim
        ncDimSize = ncFP.getDimensionSize(ncDim)
        print "\t" + "Dimension size: %s " % ncDimSize
        ncDimType = ncFP.getFieldType(ncDim)        
        print "\t" + "Dimension type: %s " % ncDimType

        for i in range(0, ncFP.getDimensionSize(ncDim)):
            ncDimValue = ncFP.getDimensionValue(ncDim, i)
            print "\t" + "Dimension value: %s" % ncDimValue
            ncDimIndex = ncFP.getDimensionIndex(ncDim, ncDimValue)
            print "\t" + "Dimension index: %s" % ncDimIndex

        #Get Variable by dimension
        ncVarsByDim = ncFP.getVariablesByDimension(ncDim)
        for ncVarByDim in ncVarsByDim:
            print "\t" + "Variable by dimension: %s" % ncVarByDim  

    #Get Global Attribues
    ncAttributeNames = ncFP.getAttributeNames("")
    for ncAttributeName in ncAttributeNames:
        print "Attribute Name: %s " % ncAttributeName
        print ncFP.getAttributeValue("", ncAttributeName)

except:
    print arcpy.GetMessages(2)