Read_netCDF_Field

Synopsis

read a field from a netCDF file

V Name

NETCDF.Read_Field

Input Port

parent

user interface parent object

Parameters

Output Port

field	Mesh + Node_Data
obj	output renderable object

Description

Network Common Data Form, also known as NetCDF, is an interface and library which provides an implementation of an interface for array oriented data access. A machine-independent format for representing scientific data is defined by the netCDF library.

Read_netCDF_Field reads a dataset from a standard netCDF file into an AVS/Express field. When you use Read_netCDF_Field, you will enter the file name in a typein box. AVS/Express examines the file to generate a list of possible variables.

Read_netCDF_Field attempts to determine if the netCDF file is best represented as a uniform field, a rectilinear field, or a structured/irregular field. Most "standard" netCDF files will be mapped into a rectilinear field. A manual override is provided for users to control the field type. You can leave the field type menu set to the default, "Unspecified" or more experienced users can force a netCDF file to be read in as a user-specified field type. The most common use of this would be to force a nominally rectilinear field to be read in as a uniform field.

You can select one or more variables with the same dimensions to be read. If the netCDF file has an unlimited dimension, the user interface will present you with the option of extracting a single time step. You can use the slider to select the time step you wish to visualize. If you do not check the toggle for extracting a time step this slider will be ignored. If your netCDF file does not have unlimited dimensions both the toggle and slider will not appear. When you are finished with the selections you may click on the Read File button. You must click this button in order for your file to be read.

Objects not typical of AVS/Express fields will be created by the NC reader as necessary. These fields can be found using Group Reference. Each of the added objects contains a prefix of NC. For example, NC Title, NC History, NC dim names, ect.

Input

parent

A port to connect to a user interface object that contains the macro's widgets. By default, it is connected to the default user interface object in the application in which the macro is instanced. (This default connection is not drawn.)

Parameters

netCDF Filename

UIfileSB. The name of the netCDF file to read.

variables

The variables in the field

timestep

int

fldtype

the Fldtype of the field.

Output Port

field

Mesh+Node_Data. The output field.

obj

Renderable object corresponding to field.

Example

Libraries.Examples.Visualization.NetCDF_SeaSurface

v/dv_examp/nc_sst.v

File

v/netcdf.v

See also related modules

Write_netCDF_Field