Giter VIP home page Giter VIP logo

tddr's Introduction

Temporal Derivative Distribution Repair (TDDR)

TDDR demonstration

About

The code within this repository is the reference implementation for the TDDR algorithm as described in:

Fishburn F.A., Ludlum R.S., Vaidya C.J., & Medvedev A.V. (2019). Temporal Derivative Distribution Repair (TDDR): A motion correction method for fNIRS. NeuroImage, 184, 171-179. doi: 10.1016/j.neuroimage.2018.09.025


Usage

Matlab:

signals_corrected = TDDR(signals, sample_rate);

Python:

from TDDR import TDDR
signals_corrected = TDDR(signals, sample_rate);

Inputs

signals: A [sample x channel] matrix of uncorrected optical density data

sample_rate: A scalar reflecting the rate of acquisition in Hz

Outputs

signals_corrected: A [sample x channel] matrix of corrected optical density data


Toolboxes

NIRS Brain AnalyzIR

The TDDR algorithm is implemented in the nirs.modules.TDDR module. Typical usage looks like this:

% Construct preprocessing job with TDDR motion correction
job = nirs.modules.OpticalDensity();
job = nirs.modules.TDDR(job);
job = nirs.modules.BeerLambertLaw(job);

% Run job on raw data
hb = job.run(raw);

Homer2

While Homer2 does not yet contain the TDDR method, a Homer2-compatible script is available in this repository at toolboxes/Homer2/hmrMotionCorrectTDDR.m. Usage is similar to other motion correction scripts shipped by Homer2.

tddr's People

Contributors

frankfishburn avatar rob-luke avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

tddr's Issues

Porting of TDDR in nirstorm

Dear Dr. Fishburn,

I recently read about your motion correction algorithm and would be interesting in porting it in our Nirs toolbox called Nirstorm (https://github.com/Nirstorm/nirstorm) which is a plugin of the software Brainstorm made for EEG/MEG analysis.

I would like to add your algorithm in the list of the available motion correction algorithm available in our toolbox (with of course the proper citation to your article). Would that be ok for you?

Best regards,
Edouard

Porting of TDDR to MNE

Dear Dr Fishburn,

I am in the field of auditory neuroscience and have enjoyed using your TDDR algorithm for motion correction with the NIRS Toolbox. I have found that your approach greatly improves the quality of my data.

I would like to port your algorithm to MNE. The MIT license for this project seems compatible with this idea. Are you ok with this? Would you like to be involved in this port (I am happy to do the boring bits like docstring, code formatting, data transformation, etc)? I will clearly cite your code and journal articles, but let me know if you want to be credited in a specific way.

You can see an example of the current analysis with MNE here, and a rough timeline for what we have planned here.

Thanks,
Rob

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.