Skip to main content

TE-Dependent Analysis (tedana) of multi-echo functional magnetic resonance imaging (fMRI) data.

Project description

tedana: TE Dependent ANAlysis

Latest Version PyPI - Python Version JOSS DOI Zenodo DOI License CircleCI Documentation Status Codecov Average time to resolve an issue Percentage of issues still open Join the chat on Mattermost Join our Google Group mailing list All Contributors Code style: black

TE-dependent analysis (tedana) is a Python library for denoising multi-echo functional magnetic resonance imaging (fMRI) data. tedana originally came about as a part of the ME-ICA pipeline, although it has since diverged. An important distinction is that while the ME-ICA pipeline originally performed both pre-processing and TE-dependent analysis of multi-echo fMRI data, tedana now assumes that you're working with data which has been previously preprocessed.

http://tedana.readthedocs.io/

More information and documentation can be found at https://tedana.readthedocs.io.

Citing tedana

If you use tedana, please cite the following papers, as well as our most recent Zenodo release:

Installation

Use tedana with your local Python environment

You'll need to set up a working development environment to use tedana. To set up a local environment, you will need Python >=3.8 and the following packages will need to be installed:

You can then install tedana with

pip install tedana

Creating a miniconda environment for use with 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.

You can confirm that tedana has successfully installed by launching a Python instance and running:

import tedana

You can check that it is available through the command line interface (CLI) with:

tedana --help

If no error occurs, tedana has correctly installed in your environment!

Use and contribute to tedana as a developer

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.

Getting involved

We :yellow_heart: 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 Mattermost 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 Google Group mailing list. You can view the previous newsletters and/or sign up to receive future ones by joining at https://groups.google.com/g/tedana-newsletter.

We ask that all contributors to tedana across all project-related spaces (including but not limited to: GitHub, Mattermost, and project emails), adhere to our code of conduct.

Contributors

Thanks goes to these wonderful people (emoji key):

Logan Dowdle
Logan Dowdle

๐Ÿ’ป ๐Ÿ’ฌ ๐ŸŽจ ๐Ÿ› ๐Ÿ‘€
Elizabeth DuPre
Elizabeth DuPre

๐Ÿ’ป ๐Ÿ“– ๐Ÿค” ๐Ÿš‡ ๐Ÿ‘€ ๐Ÿ’ก โš ๏ธ ๐Ÿ’ฌ
Marco Flores-Coronado
Marco Flores-Coronado

๐Ÿค” ๐Ÿ“–
Javier Gonzalez-Castillo
Javier Gonzalez-Castillo

๐Ÿค” ๐Ÿ’ป ๐ŸŽจ
Dan Handwerker
Dan Handwerker

๐ŸŽจ ๐Ÿ“– ๐Ÿ’ก ๐Ÿ‘€ ๐Ÿ’ป
Prantik Kundu
Prantik Kundu

๐Ÿ’ป ๐Ÿค”
Ross Markello
Ross Markello

๐Ÿ’ป ๐Ÿš‡ ๐Ÿ’ฌ
Pete Molfese
Pete Molfese

๐Ÿ’ป
Neha Reddy
Neha Reddy

๐Ÿ› ๐Ÿ“– ๐Ÿค” ๐Ÿ’ฌ ๐Ÿ‘€
Taylor Salo
Taylor Salo

๐Ÿ’ป ๐Ÿค” ๐Ÿ“– โœ… ๐Ÿ’ฌ ๐Ÿ› โš ๏ธ ๐Ÿ‘€
Joshua Teves
Joshua Teves

๐Ÿ“† ๐Ÿ“– ๐Ÿ‘€ ๐Ÿšง ๐Ÿ’ป
Kirstie Whitaker
Kirstie Whitaker

๐Ÿ“– ๐Ÿ“† ๐Ÿ‘€ ๐Ÿ“ข
Monica Yao
Monica Yao

๐Ÿ“– โš ๏ธ
Stephan Heunis
Stephan Heunis

๐Ÿ“–
Benoรฎt Bรฉranger
Benoรฎt Bรฉranger

๐Ÿ’ป
Eneko Uruรฑuela
Eneko Uruรฑuela

๐Ÿ’ป ๐Ÿ‘€ ๐Ÿค”
Cesar Caballero Gaudes
Cesar Caballero Gaudes

๐Ÿ“– ๐Ÿ’ป
Isla
Isla

๐Ÿ‘€
mjversluis
mjversluis

๐Ÿ“–
Maryam
Maryam

๐Ÿ“–
aykhojandi
aykhojandi

๐Ÿ“–
Stefano Moia
Stefano Moia

๐Ÿ’ป ๐Ÿ‘€ ๐Ÿ“–
Zaki A.
Zaki A.

๐Ÿ› ๐Ÿ’ป ๐Ÿ“–
Manfred G Kitzbichler
Manfred G Kitzbichler

๐Ÿ’ป
giadaan
giadaan

๐Ÿ“–
Basile
Basile

๐Ÿ’ป
Chris Markiewicz
Chris Markiewicz

๐Ÿ’ป
Sarah Goodale
Sarah Goodale

๐Ÿ“– ๐Ÿค” ๐Ÿ’ฌ
Maitane Martinez Eguiluz
Maitane Martinez Eguiluz

๐Ÿ’ป
Marta Arbizu Gรณmez
Marta Arbizu Gรณmez

๐Ÿ’ป

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tedana-24.0.0.tar.gz (23.0 MB view hashes)

Uploaded Source

Built Distribution

tedana-24.0.0-py3-none-any.whl (191.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page