The NCDF_VARGET1 procedure retrieves one element from a NetCDF variable. The NetCDF file must be in data mode to use this procedure.

Examples


Suppose that the file dave.nc contains an image saved with the NetCDF variable name “dave”. The following commands extract the value of a single pixel from the image:

; The location of the single element (pixel) whose value we will
; retrieve:
offset = [180,190]
; Open the NetCDF file:
id = NCDF_OPEN('dave.nc')
; Get the variable ID for variable "dave":
varid = NCDF_VARID(id, 'dave')
; Extract the element and return the value in the variable
; single_pixel:
NCDF_VARGET1, id, varid, single_pixel, OFFSET=offset
; Close the NetCDF file:
NCDF_CLOSE, id

Syntax


NCDF_VARGET1, Cdfid, Varid, Value [, OFFSET=vector]

Arguments


Cdfid

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

Varid

The NetCDF variable ID, returned from a previous call to NCDF_VARDEF or NCDF_VARID, or the name of the variable.

Value

A named variable in which the value of the variable is returned. NCDF_VARGET1 sets Value’s size and data type as appropriate.

Keywords


OFFSET

A vector containing the starting position of the read. The default starting position is [0, 0, ...].

Version History


Pre 4.0

Introduced

See Also


NCDF_VARGET, NCDF_VARID, NCDF_VARINQ, NCDF_VARPUT