./toolbox
dcextract.pro

Last modification date:

Wed Sep 28 13:27:10 2016

dcextract

function dcextract(dc[, startat][, endat][, stride])

Extract a region from a data container, producing a new data container with fewer elements in it. The caller is responsible for eventually freeing the pointer(s) contained in the returned data container using data_free. The only header words modified are the reference_channel and frequency_interval for spectral line data. If only the dc is supplied, this function is equivalent to data_copy.

Returns

The extracted data container. The user is responsible for eventually freeing this using data_free. Returns -1 on error.

Version

$Id$

Parameters
dc in, required data container	The data container to extract the region from.
startat in, optional integer (def. 0)	The first element to include in the extracted region.
endat in, optional integer	The last element to include in the extracted region. If not supplied, the last element is used. endat must be greater than or equal to startat.
stride in, optional integer (def. 1)	The increment in elements to extract, starting with startat. stride must be greater than 0.