A family of functions that returns information about a netCDF variable, given its ID. Information about a variable includes its name, type, number of dimensions, a list of dimension IDs describing the shape of the variable, and the number of variable attributes that have been assigned to the variable.
The function NF_INQ_VAR returns all the information about a netCDF variable, given its ID. The other functions each return just one item of information about a variable.
These other functions include NF_INQ_VARNAME, NF_INQ_VARTYPE, NF_INQ_VARNDIMS, NF_INQ_VARDIMID, and NF_INQ_VARNATTS.
INTEGER FUNCTION NF_INQ_VAR (INTEGER NCID, INTEGER VARID, CHARACTER*(*) name, INTEGER xtype, INTEGER ndims, INTEGER dimids(*), INTEGER natts) INTEGER FUNCTION NF_INQ_VARNAME (INTEGER NCID, INTEGER VARID, CHARACTER*(*) name) INTEGER FUNCTION NF_INQ_VARTYPE (INTEGER NCID, INTEGER VARID, INTEGER xtype) INTEGER FUNCTION NF_INQ_VARNDIMS (INTEGER NCID, INTEGER VARID, INTEGER ndims) INTEGER FUNCTION NF_INQ_VARDIMID (INTEGER NCID, INTEGER VARID, INTEGER dimids(*)) INTEGER FUNCTION NF_INQ_VARNATTS (INTEGER NCID, INTEGER VARID, INTEGER natts)
NCID
VARID
NAME
xtype
ndims
dimids
natts
These functions return 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_INQ_VAR to find out about a variable named rh in an existing netCDF dataset named foo.nc:
INCLUDE 'netcdf.inc' ... INTEGER STATUS, NCID INTEGER RHID ! variable ID CHARACTER*31 RHNAME ! variable name INTEGER RHTYPE ! variable type INTEGER RHN ! number of dimensions INTEGER RHDIMS(NF_MAX_VAR_DIMS) ! variable shape INTEGER RHNATT ! number of attributes ... STATUS = NF_OPEN ('foo.nc', NF_NOWRITE, NCID) IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS) ... STATUS = NF_INQ_VARID (NCID, 'rh', RHID) ! get ID IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS) STATUS = NF_INQ_VAR (NCID, RHID, RHNAME, RHTYPE, RHN, RHDIMS, RHNATT) IF (STATUS .NE. NF_NOERR) CALL HANDLE_ERR(STATUS)