Unfold.jl

Beta Toolbox to perform linear regression on biological signals.

This tool combines mass-univariate linear (mixed) models with overlap correction.

This kind of overlap correction is also known as encoding modeling, linear deconvolution, Temporal Response Functions (TRFs) and probably under other names. fMRI models with HRF-basis functions are also supported.

Citation

Please cite

or Ehinger & Dimigen

Relation to Unfold (matlab)

I regularly use Unfold.jl in my research, but there are likely more hard corners there compared to the matlab version (but julia is more flexible and has some unique features)

Feature	Unfold	unmixed	Unfold.jl
overlap correction	x	x	x
non-linear splines	x	x	x
plotting tools	x		UnfoldMakie.jl - beta
sanity checks	x
tutorials	x		x
speed	x		x
unittests	x		x
HRF (fMRI) basis			x
mix different basisfunctions			x
different timewindows per event			x
mixed models		x	x
item & subject effects		x	x
decoding			back2back regression

Install

]add Unfold

Usage

For a quickstart:

f = @formula 0~1+condA
fLMM = @formula 0~1+condA+(1|subject) + (1|item)
events::DataFrame
data::Array{Float64,2}
epochs::Array{Float64,3} # channel x time x epochs (n-epochs == nrows(events))
times = range(0,length=size(epochs,3),step=1/sampling_rate)

basisfunction::Unfold.BasisFunction
basis = firbasis(τ=(-0.3,0.5),srate=250)

1. Timeexpansion No, Mixed No : fit(UnfoldModel,Dict(Any=>(f,times)),evts,data_epoch)
2. Timeexpansion Yes, Mixed No : fit(UnfoldModel,Dict(Any=>(f,basis)),evts,data)
3. Timeexpansion No, Mixed Yes : fit(UnfoldModel,Dict(Any=>(fLMM,times)),evts,data_epoch)
4. Timeexpansion Yes, Mixed Yes: fit(UnfoldModel,Dict(Any=>(fLMM,basis)),evts,data)

Documentation

Most functions have documentation, e.g. ?Unfold.fit

Tutorials see the documentation

Adding Documentation

1. We recommend to write a Literate.jl document and place it in docs/_literate/FOLDER/FILENAME.jl with FOLDER being HowTo, Explanation, Tutorial or Reference (recommended reading on the 4 categories).
2. Literate.jl converts the .jl file to a .md automatically and places it in doc/src/_literate/FILENAME.jl.
3. Edit make.jl with a reference to doc/src/_literate/FILENAME.jl

Contributors (alphabetically)

• Phillip Alday
• Benedikt Ehinger
• Dave Kleinschmidt
• Judith Schepers
• Felix Schröder
• René Skukies

Acknowledgements

This work was supported by the Center for Interdisciplinary Research, Bielefeld (ZiF) Cooperation Group "Statistical models for psychological and linguistic data".

Funded by Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) under Germany´s Excellence Strategy – EXC 2075 – 390740016

Research notice

Please note that this repository is participating in a study into sustainability of open source projects. Data will be gathered about this repository for approximately the next 12 months, starting from June 2021.

Data collected will include number of contributors, number of PRs, time taken to close/merge these PRs, and issues closed.

For more information, please visit our informational page or download our participant information sheet.