Next: NF_GET_VARA_ type, Previous: NF_GET_VAR1_ type, Up: Variables
The members of the NF_GET_VAR_ type family of functions read all the values from a netCDF variable of an open netCDF dataset. This is the simplest interface to use for reading the value of a scalar variable or when all the values of a multidimensional variable can be read at once. The values are read into consecutive locations with the first dimension varying fastest. The netCDF dataset must be in data mode.
INTEGER FUNCTION NF_GET_VAR_TEXT (INTEGER NCID, INTEGER VARID, CHARACTER*(*) text) INTEGER FUNCTION NF_GET_VAR_INT1 (INTEGER NCID, INTEGER VARID, INTEGER*1 i1vals(*)) INTEGER FUNCTION NF_GET_VAR_INT2 (INTEGER NCID, INTEGER VARID, INTEGER*2 i2vals(*)) INTEGER FUNCTION NF_GET_VAR_INT (INTEGER NCID, INTEGER VARID, INTEGER ivals(*)) INTEGER FUNCTION NF_GET_VAR_REAL (INTEGER NCID, INTEGER VARID, REAL rvals(*)) INTEGER FUNCTION NF_GET_VAR_DOUBLE(INTEGER NCID, INTEGER VARID, DOUBLE dvals(*))
NCID
VARID
text
i1vals
i2vals
ivals
rvals
dvals
NF_GET_VAR_ type returns the value NF_NOERR if no errors occurred. Otherwise, the returned status indicates an error. Possible causes of errors include:
Here is an example using NF_GET_VAR_DOUBLE to read all the values of the variable named rh from an existing netCDF dataset named foo.nc. For simplicity in this example, we assume that we know that rh is dimensioned with lon, lat, and time, and that there are ten lon values, five lat values, and three time values.
INCLUDE 'netcdf.inc' ... PARAMETER (TIMES=3, LATS=5, LONS=10) ! dimension lengths INTEGER STATUS, NCID INTEGER RHID ! variable ID DOUBLE RHVALS(LONS, LATS, TIMES) ... STATUS = NF_OPEN ('foo.nc', NF_NOWRITE, NCID) IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS) ... STATUS = NF_INQ_VARID (NCID, 'rh', RHID) IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS) STATUS = NF_GET_VAR_DOUBLE (NCID, RHID, RHVALS) IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)