FieldTrip

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

  FT_ARTIFACT_THRESHOLD scans for trials in which the range, i.e. the minimum,
  the maximum or the range (min-max difference) of the signal in any
  channel exceeds a specified threshold.
 
  Use as
    [cfg, artifact] = ft_artifact_threshold(cfg)
  with the configuration options
    cfg.dataset
    cfg.headerfile
    cfg.datafile
 
  Alternatively you can use it as
    [cfg, artifact] = ft_artifact_threshold(cfg, data)
 
  In both cases the configuration should also contain
    cfg.trl        = structure that defines the data segments of interest, see FT_DEFINETRIAL
    cfg.continuous = 'yes' or 'no' whether the file contains continuous data
 
  The following configuration options can be specified
    cfg.artfctdef.threshold.channel   = cell-array with channel labels
    cfg.artfctdef.threshold.bpfilter  = 'no' or 'yes'
    cfg.artfctdef.threshold.bpfreq    = [0.3 30]
    cfg.artfctdef.threshold.bpfiltord = 4
 
  The detection of artifacts is done according to the following settings,
  you should specify at least one of these thresholds
    cfg.artfctdef.threshold.range     = value in uV/T, default  inf
    cfg.artfctdef.threshold.min       = value in uV/T, default -inf
    cfg.artfctdef.threshold.max       = value in uV/T, default  inf
 
  When cfg.artfctdef.threshold.range is used, the within-channel
  peak-to-peak range is checked against the specified maximum range (so not
  the overall range across channels).
 
  Contrary to the other artifact detection functions, this function
  will mark the whole trial as an artifact if the threshold is exceeded.
  Furthermore, this function does not support artifact- or filterpadding.
 
  To facilitate data-handling and distributed computing with the peer-to-peer
  module, this function has the following options
    cfg.inputfile   =  ...
  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.
 
  See also FT_REJECTARTIFACT, FT_ARTIFACT_CLIP, FT_ARTIFACT_ECG, FT_ARTIFACT_EOG,
  FT_ARTIFACT_JUMP, FT_ARTIFACT_MUSCLE, FT_ARTIFACT_THRESHOLD, FT_ARTIFACT_ZVALUE