The tedana
package is part of the ME-ICA pipeline, performing TE-dependent
analysis of multi-echo functional magnetic resonance imaging (fMRI) data.
TE
-de
pendent ana
lysis (tedana
) is a Python module for denoising
multi-echo functional magnetic resonance imaging (fMRI) data.
tedana
originally came about as a part of the ME-ICA pipeline.
The ME-ICA pipeline originally performed both pre-processing and TE-dependent analysis of multi-echo fMRI data; however, tedana
now assumes that you're working with data which has been previously preprocessed.
More information and documentation can be found at https://tedana.readthedocs.io.
You'll need to set up a working development environment to use tedana
.
To set up a local environment, you will need Python >=3.5 and the following packages will need to be installed:
You can then install tedana
with
pip install tedana
In using tedana
, you can optionally configure a conda environment.
We recommend using miniconda3.
After installation, you can use the following commands to create an environment for tedana
:
conda create -n ENVIRONMENT_NAME python=3 pip mdp numpy scikit-learn scipy
conda activate ENVIRONMENT_NAME
pip install nilearn nibabel
pip install tedana
tedana
will then be available in your path.
This will also allow any previously existing tedana
installations to remain untouched.
To exit this conda environment, use
conda deactivate
NOTE: Conda < 4.6 users will need to use the soon-to-be-deprecated option source
rather than conda
for the activation and deactivation steps.
You can read more about managing conda environments and this discrepancy here.
If you aim to contribute to the tedana
code base and/or documentation, please first read the developer installation instructions in our contributing section. You can then continue to set up your preferred development environment.
We 💛 new contributors! To get started, check out our contributing guidelines and our developer's guide.
Want to learn more about our plans for developing tedana
?
Have a question, comment, or suggestion?
Open or comment on one of our issues!
If you're not sure where to begin, feel free to pop into Gitter and introduce yourself! We will be happy to help you find somewhere to get started.
If you don't want to get lots of notifications, we send out newsletters approximately once per month though our TinyLetter mailing list. You can view the previous newsletters and/or sign up to receive future ones at https://tinyletter.com/tedana-devs.
We ask that all contributors to tedana
across all project-related spaces (including but not limited to: GitHub, Gitter, and project emails), adhere to our code of conduct.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome! To see what contributors feel they've done in their own words, please see our contribution recognition page.