The purpose of this page is just to serve as todo or scratch pad for the development project and to list and share some ideas.

After making changes to the code and/or documentation, this page should remain on the website as a reminder of what was done and how it was done. However, there is no guarantee that this page is updated in the end to reflect the final state of the project

So chances are that this page is considerably outdated and irrelevant. The notes here might not reflect the current state of the code, and you should not use this as serious documentation.

Explain how to create cfg.design for ft_statistics

cfg.design as input into ft_statistics (freq, timelock, or source) should be designed as Windowssize MxN, where N is the number of trials/conditions.

M is variable length. Along with cfg.design, the other options cfg.ivar, cfg.uvar, cfg.wvar, and cfg.cvar may also need to be specified. They are an index (indices) into which row(s) of the cfg.design correspond to ā€˜independent variablesā€™, ā€˜units of observationā€™, ā€˜within-block variablesā€™ and ā€˜control variablesā€™, respectively.

Not all are needed: see statistics_*.m for what vectors it may include.

See https://www.fieldtriptoolbox.org/walkthrough#non-paired_comparison and https://www.fieldtriptoolbox.org/walkthrough#paired_comparison for examples on ivar and uvar. and https://www.fieldtriptoolbox.org/development/statistics for uvar.

Is there any explanation on the website for more on uvar and wvar? (Seems it is all on the email discussion list specific to peopleā€™s questions).

  • https://www.fieldtriptoolbox.org/walkthrough
  • https://www.fieldtriptoolbox.org/getting_started/biosemi
  • https://www.fieldtriptoolbox.org/tutorial/eventrelatedstatistics
  • https://www.fieldtriptoolbox.org/tutorial/shared/cluster_permutation_background
  • https://www.fieldtriptoolbox.org/tutorial/multivariateanalysis
  • https://www.fieldtriptoolbox.org/tutorial/cluster_permutation_freq
  • https://www.fieldtriptoolbox.org/tutorial/cluster_permutation_timelock
  • https://www.fieldtriptoolbox.org/example/source_statistics
  • https://www.fieldtriptoolbox.org/example/apply_clusterrandanalysis_on_tfrs_of_power_that_were_computed_with_besa
  • https://www.fieldtriptoolbox.org/development/statistics
  • https://www.fieldtriptoolbox.org/development/multivariate
Hierarchy of functions

(figure/diagram helpful https://www.fieldtriptoolbox.org/development/statistics)

User calls ft_*statistics (freq, timelock, or source)

        cfg.method: different methods for calculating probability of null hypothesis
                     will call function: statistics_(cfg.method)

however, in ft_sourcestatistics, instead statistics(cfg.method) is called, or statistics_wrapper if no method specified.

statistics_montecarlo.m (only) calls resampledesign.m

statistics_stat.m (deprecated: see https://www.fieldtriptoolbox.org/example/statistics_toolbox )