auto_GetData

auto_GetData returns the data of the given channels as a matrix. The function can only be used to read numeric data channels.

rmData = auto_GetData(ssNetCDFFileName, svVarName)
rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName)
rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName, bFilter)
rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName, bFilter, bRemoveMissingValues)
rmData = auto_GetData(ncid, ssNetCDFFileName, svVarName, bFilter, bRemoveMissingValues, rsStart, rsCount)

Return Value

rmData is a real Matrix. The matrix contains one column for each channel. If one of the channels does not exists or is a string channel the function returns the scalar number 0.If the function cannot open the file or the first channel name in the paramter svVarName does not exist in the file the function returns a vector with the values 0. The vector length is identical to the numer of channels given in parameter svVarName.

If the first channel name exists but one or more of the other given channels do not exists the matrix is filled with the values 0.

For all other errors the function returns the scalar value ERROR_VALUE.

Parameters

ssNetCDFFileName

ssNetCDFFileName is the complete name of a netCDF file (.nc). If ncid contains a valid ncid, ssNetCDFFileName can be an empty string.

ncid

ncid is the nc file handle. The handle is returned by the function nc_open. If ssNetCDFFileName contains a valid NC file name, p|ncid| can be set to -1.

svVarName

svVarName is a vector of channel names.

bFilter

bFilter specifies if the record filter is evaluated. Default value is FALSE (0).

bRemoveMissingValues

bRemoveMissingValues specifies if all values or only valid values are returned. Default value is TRUE (1).

rsStart
rsStart is a scalar value specifying the index of the the first data value.
rsStart starts with 0. Default value is 0.
rvCount

rvCount is a scalar value specifying the number of data points to read. Default value is “all points”.

id-1879209