FieldTrip

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

  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 specification of the artifacts.
 
  Use as
    cfg = ft_databrowser(cfg)
  where the configuration structure contains the reference to the dataset
  on your hard disk (see below), or use as
    cfg = ft_databrowser(cfg, data)
  where the input data is a structure as obtained from FT_PREPROCESSING or
  from FT_COMPONENTANALYSIS.
 
  If you want to browse data that is on disk, you have to specify 
    cfg.dataset                 = string with the filename
  Instead of specifying the dataset, you can also explicitely specify the
  name of the file containing the header information and the name of the
  file containing the data, using
    cfg.datafile                = string with the filename
    cfg.headerfile              = string with the filename
 
  The following configuration options are supported:
    cfg.ylim                    = vertical scaling, can be 'maxmin', 'maxabs' or [ymin ymax] (default = 'maxabs')
    cfg.zlim                    = color scaling to apply to component topographies, 'minmax', 'maxabs' (default = 'maxmin') 
    cfg.blocksize               = duration in seconds for cutting the data up, only aplicable for continuous data
    cfg.trl                     = structure that defines the data segments of interest, only applicable for trial-based data
    cfg.continuous              = 'yes' or 'no' whether the data should be interpreted as continuous or trial-based
    cfg.channel                 = cell-array with channel labels, see FT_CHANNELSELECTION
    cfg.plotlabels              = 'yes' (default), 'no', 'some'; whether
                                  to plot channel labels in vertical viewmode ('some' plots one in every ten
                                  labels; useful when plotting a large number of channels at a time)
    cfg.ploteventlabels         = 'type=value', 'colorvalue' (default = 'type=value');
    cfg.viewmode                = string, 'butterfly', 'vertical', 'component' for visualizing components e.g. from an ICA (default is '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' 'allblack' '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
    cfg.gradscale               = number, scaling to apply to the MEG gradiometer channels prior to display (in addition to the cfg.megscale factor)
    cfg.magscale                = number, scaling to apply to the MEG magnetometer channels prior to display (in addition to the cfg.megscale factor)
    cfg.chanscale               = Nx1 vector with scaling factors, one per channel specified in cfg.channel
    cfg.compscale               = string, 'global' or 'local', defines whether the colormap for the topographic scaling is 
                                   applied per topography or on all visualized components (default 'global')