Routines (alphabetical) > Routines: N > NCDF Routines > NCDF_VARGET1

# NCDF_VARGET1

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