Read_netCDF_Field
Synopsis
read a field from a netCDF file
V name
NETCDF.Read_Field
Input Port
|
parent |
user interface parent object |
Output Ports
|
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 Port
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 Ports
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