./guide
getdata.pro

Last modification date:

Wed Sep 28 13:27:09 2016

getdata

function getdata([buffer][, elements], [count=variable])

Extract some or all of the data array from one of the global buffers.

Use of getdata frees the user from having to deal with pointers by providing a copy of some or all of the data array in one of the global buffers (data containers).

Returns

The extracted data.

Examples

    filein,'file.fits'
    getrec,0
    x = getdata()
    help, x
    X               FLOAT     = Array[1026]
    y = getdata(0,0)
    help, y
    Y               FLOAT     = 34.5000
    z = getdata(0,[0,2])
    help, z
    z               FLOAT     = Array[3]
 

Uses

data_valid getdcdata

Parameters
buffer in, optional integer (def. 0)	The data container buffer from which the data are retrieved (defaults to buffer 0).
elements in, optional integer (def. all)	A subset of the full data array can be retrieved by specifying either a single data array index, or a two-element array to specify a range of data array indices. Defaults to all elements.

Keywords
count out, optional variable	The total number of elements returned. On error, this will be 0 and the returned value for this function will be -1.