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. When visually selection data, a right-click will bring up a context-menu containing functions to be executed on the selected data. You can use your own function using cfg.selfun and cfg.selcfg. You can use multiple functions by giving the names/cfgs as a cell-array. 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 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 = 'markartifact', 'markpeakevent', 'marktroughevent' (default = 'markartifact') 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 using the right-click context menu The selected data and cfg.selcfg are passed on to this function. cfg.selcfg = configuration options for function in cfg.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.mychanscale = number, scaling to apply to the channels specified in cfg.mychan cfg.mychan = Nx1 cell-array with selection of channels 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') In case of component viewmode, a layout is required. If no layout is give, an attempt is made to construct one from the sensor definition. EEG or MEG sensor positions can be present in the data or can be specified as cfg.elec = structure with electrode positions, see FT_DATATYPE_SENS cfg.grad = structure with gradiometer definition, see FT_DATATYPE_SENS cfg.elecfile = name of file containing the electrode positions, see FT_READ_SENS cfg.gradfile = name of file containing the gradiometer definition, see FT_READ_SENS