NCDF_CONTROL

The NCDF_CONTROL procedure performs miscellaneous NetCDF operations.

Different options are controlled by keywords. Only one keyword can be specified in any call to NCDF_CONTROL, unless the OLDFILL keyword is specified.

Examples

See the examples under NCDF_ATTINQ and NCDF_VARPUT.

Syntax

NCDF_CONTROL, Cdfid [, /ABORT] [, /ENDEF] [, /FILL | , /NOFILL] [, /NOVERBOSE | , /VERBOSE] [, OLDFILL=variable] [, /REDEF] [, /SYNC]

Arguments

Cdfid

The NetCDF ID, returned from a previous call to NCDF_OPEN, NCDF_CREATE, or NCDF_GROUPDEF.

Keywords

ABORT

Set this keyword to close a NetCDF file that is not in define mode. If the file is being created and is still in define mode, the file is deleted. If define mode was entered by a call to NCDF_CONTROL with the REDEF keyword, the NetCDF file is restored to its state before definition mode was entered, and the file is closed.

ENDEF

Set this keyword to take an open NetCDF file out of define mode (and into data mode).

FILL

Set this keyword so that data in the NetCDF file is pre-filled with default fill values. The default values (which cannot be changed) are:

Data Type

Fill Value

BYTE

0

CHAR

0

SHORT

-32767

LONG

-2147483647

FLOAT

9.96921E+36

DOUBLE

9.96921E+36

NOFILL

Set this keyword so that data in the NetCDF file is not pre-filled. This option saves time when it is certain that variable values will be written before a read is attempted.

NOVERBOSE

Set this keyword to suppress the printing of NetCDF error messages. Cdfid is required but not used.

OLDFILL

This keyword specifies a named variable in which the previous fill value is returned. This keyword can only be used in combination with the FILL or NOFILL keywords. For example:

NCDF_CONTROL, id, FILL=1, OLDFILL=previous_fill

REDEF

Set this keyword to put an open NetCDF file into define mode.

SYNC

Set this keyword to update the disk copy of a NetCDF file that is open for writing. The NetCDF file must be in data mode. A NetCDF file in define mode will be updated only when NCDF_CONTROL is called with the ENDEF keyword.

VERBOSE

Set this keyword to cause NetCDF error messages to be printed. Cdfid is required but not used. For example:

NCDF_CONTROL, 0, /VERBOSE

is a valid command even if 0 is not a valid NetCDF file ID.

Version History

Pre 4.0

Introduced

See Also

NCDF_CLOSE, NCDF_CREATE, NCDF_OPEN