FieldTrip

Note that this reference documentation is identical to the help that is displayed in Matlab when you type “help ft_databrowser_old”.

  FT_DATABROWSER can be used for visual inspection of data. Artifacts that were detected
  by artifact functions (see FT_ARTIFACT_xxx functions where xxx is the type of artifact)
  are marked. Additionally data pieces can be marked and unmarked as artifact by
  manual selection. The output cfg contains the updated artifactdef field.
 
  Use as
    cfg = ft_databrowser(cfg)
    required configuration options:
    cfg.dataset or both cfg.headerfile and cfg.datafile
  or as
    cfg = ft_databrowser(cfg, data)
  with the data as obtained from FT_PREPROCESSING
 
  The following configuration options are supported:
    cfg.trl                     = structure that defines the data segments of interest. See FT_DEFINETRIAL
    cfg.continuous              = 'yes' or 'no' wh ether the file contains continuous data
    cfg.channel                 = cell-array with channel labels, see FT_CHANNELSELECTION
    cfg.comps                   = a vector with the components to plot (ex. 1:10) (optional)
    cfg.zscale                  = [zmin zmax] or 'auto' (default = 'auto')
    cfg.blocksize               = number (in seconds), only aplicable if data contains only 1 (long) trial
    cfg.viewmode                = string, 'butterfly', 'vertical', 'component' (default = 'butterfly')
    cfg.artfctdef.xxx.artifact  = Nx2 matrix with artifact segments see FT_ARTIFACT_xxx functions
    cfg.selectfeature           = string, name of feature to be selected/added (default = 'visual')
    cfg.selectmode              = string, what to do with a selection, can be 'mark', or 'eval' (default = 'mark')
                                  'mark': artfctdef field is updated, 'eval': the function defined in
                                  cfg.selfun is evaluated f.i. browse_movieplotER calls movieplotER which makes
                                  a movie of the selected data
    cfg.colorgroups             = 'sequential' 'labelcharx' (x = xth character in label), 'chantype' or
                                   vector with length(data/hdr.label) defining groups (default = 'sequential')
    cfg.channelcolormap         = COLORMAP (default = customized lines map with 15 colors)
    cfg.selfun                  = string, name of function which is evaluated if selectmode is set to 'eval'.
                                   The selected data and the selcfg are passed on to this function.
    cfg.selcfg                  = configuration options for selfun
    cfg.eegscale                = number, scaling to apply to the EEG channels prior to display
    cfg.eogscale                = number, scaling to apply to the EOG channels prior to display
    cfg.ecgscale                = number, scaling to apply to the ECG channels prior to display
    cfg.emgscale                = number, scaling to apply to the EMG channels prior to display
    cfg.megscale                = number, scaling to apply to the MEG channels prior to display
 
  The "artifact" field in the output cfg is a Nx2 matrix comparable to the
  "trl" matrix of FT_DEFINETRIAL. The first column of which specifying the
  beginsamples of an artifact period, the second column contains the
  endsamples of the artifactperiods.
 
  To facilitate data-handling and distributed computing with the peer-to-peer
  module, this function has the following options:
    cfg.inputfile   =  ...
    cfg.outputfile  =  ...
  If you specify one of these (or both) the input data will be read from a *.mat
  file on disk and/or the output data will be written to a *.mat file.
  These mat
  files should contain only a single variable, corresponding with the
  input/output structure.
 
  NOTE for debugging: in case the databrowser crashes, use delete(gcf) to kill the figure.
 
  See also FT_PREPROCESSING, FT_REJECTARTIFACT, FT_ARTIFACT_EOG, FT_ARTIFACT_MUSCLE,
  FT_ARTIFACT_JUMP, FT_ARTIFACT_MANUAL, FT_ARTIFACT_THRESHOLD, FT_ARTIFACT_CLIP, FT_ARTIFACT_ECG