next up previous contents
Next: Function: mxFind_chirp Up: Functions Previous: Function: mxDetector_site   Contents


Function: mxFget_ch

[fgetoutput]=mxFget_ch(fgetinput)

This function does not behave properly. GRASP treats Matlab as the calling function so it has no way of knowing when you want to reset your search. Be especially cautious if you use this function. Most of the input and output structures are the same--however since there are slight difference the full descriptions are given below.

fgetinput.npoint: the number of data points you want to get

fgetinput.inlock: 1 means get only locked data 0 means get both locked and unlocked data

fgetinput.seek: 1 means operate in seek mode (do not return data) 0 means return data

fgetinput.calibrate: 1 means return calibration data 0 means do not return calibration data

fgetinput.nchan: number of channels to read from

fgetinput.chnames: cell array whose elements are strings containing the channel names

fgetoutput.tstart: time stamp of the first point output in channel chnames{1}

fgetoutput.srate] sample rate at which data was recorded

fgetoutput.npoint: npoint(i)is the number of points returned for channel chnames{i}

fgetoutput.ratios: ratios(i) is the sample rate of channel chnames{1} divided by the sample rate of channel chnames{i}

fgetoutput.discarded: number of points discarded from channel chnames{1}

fgetoutput.tfirst: the time stamp of the first point returned in the first call to mxFget_ch

fgetoutput.dt: tstart-tfirst

fgetoutput.lostlock: time at which we lost lock (if searching for locked segments only)

fgetoutput.lastlock: time at which we last regained lock (if searching for locked segments only)

fgetoutput.returnval: 0 if unable to satisfy the request, 1 if request is satisfied by beginning new locked or continuous-in-time section, 2 if the data returned is part of an ongoing locked or continuous-in-time sequence

fgetoutput.frinum: three times the number of frequency values for which re are returning static calibration information.

fgetoutput.fri: calibration data fri(1)$=f_{0},$ fri(2)$=r_{0},$ fri(3)$=i_{0},$ fri(4)$=f_{1},$ fri(5)$=r_{1},$ fri(6)$=i_{1}$ $\cdots$ (see section 4.7)

fgetoutput.tcalibrate: time at which current calibration data became valid

fgetoutput.locklow: minimum value (inclusive) for ``in-lock'' in the lock channel,
set only if fgetinput.inlock is nonzero

fgetoutput.lockhi: maximum value (inclusive) for ``in-lock'' in the lock channel,
set only if fgetinput.inlock is nonzero

fgetoutput.data: a cell array. fgetoutput.data{i} is a vector containing the returned data for channel chnames{i}

Author: Steve Drasco, steve.drasco@cornell.edu
Comments: A possible fix to this function would be to write a reset function for fget_ch. The reset function would tell fget_ch that we are going to start a new data input run. Another possible fix would be to add a field fgetinput.reset which could reset the function.


next up previous contents
Next: Function: mxFind_chirp Up: Functions Previous: Function: mxDetector_site   Contents
Bruce Allen 2000-11-19