Skip to content

Commit a275cfe

Browse files
authored
Update README.md
synchronize README with that showing on the webpage
1 parent e9da432 commit a275cfe

File tree

1 file changed

+10
-11
lines changed

1 file changed

+10
-11
lines changed

README.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
1-
# niphlem
21

3-
*niphlem* is a toolbox that extracts physiological recordings during MRI scanning and estimates the signal phases so that they can be used as a covariate in your general linear model (GLM) with fMRI data.
2+
*niphlem*: NeuroImaging-oriented Physiological Log Extraction for Modeling
3+
=====================================================================
44

5-
*niphlem* can generate multiple models of physiological noise to include as regressors in your GLM model from either ECG, pneumatic breathing belt or pulse-oximetry data. These are described in Verstynen and Deshpande (2011).
5+
*niphlem* is a toolbox that extracts physiological signals recorded coincidentally with functional MRI data and estimates the signal phases so that they can be used as a covariate in subsequent analyses.
66

7-
Briefly, niphlem implements two physiological models for regressors generation:
7+
*niphlem* can generate multiple models of physiological noise to include as regressors from either ECG, pneumatic breathing belt or pulse-oximetry data. These are described in detail in Verstynen and Deshpande (2011).
88

9-
- *RETROICOR*: A phasic decomposition method that isolates the fourier series that best describes the spectral properties of the input signal. This was first described by Glover and colleagues.
10-
- *Variation Models*: For low frequency signals (like the pneumatic belt and low-pass filtered pulse-oximetry) this does the combined respiration variance and response function described by Birn and colleagues (2008). For high frequency signals (i.e., ECG or high-pass filtered pulse-oximetry), this generates the heart-rate variance and cardiac response function described by Chang and colleagues (2009).
9+
Briefly, niphlem implements two physiological models for regressors generation:
1110

12-
*niphlem* can also extract cardiac and respiratory signals from the pulse-oximitry data stream itself, as described in Verstynen and Deshpande (2011).
11+
- **RETROICOR**: A phasic decomposition method that isolates the fourier series that best describes the spectral properties of the input signal. This was first described by Glover and colleagues (2000).
12+
- **Variation Models**: For low frequency signals (like the pneumatic belt and low-pass filtered pulse-oximetry) this does the combined respiration variance and response function described by Birn and colleagues (2006, 2008). For high frequency signals (i.e., ECG or high-pass filtered pulse-oximetry), this generates the heart-rate variance and cardiac response function described by Chang and colleagues (2009).
1313

1414
## Dependencies
1515

@@ -21,19 +21,18 @@ Python 3.6 or greater is required. Any of the below dependencies compatible wth
2121
- scipy
2222
- scikit_learn
2323
- outlier_utils
24-
24+
2525
## Install
2626

2727
pip install - U niphlem
28-
28+
2929
Alternatively, if you are interested in installing the latest version under development, you may clone the github repository and install it from there directly:
3030

3131
git clone https://github.com/CoAxLab/niphlem.git
3232
cd niphlem
3333
pip install -U .
34-
34+
3535
## References:
3636
- Verstynen TD, Deshpande V. Using pulse oximetry to account for high and low frequency physiological artifacts in the BOLD signal. Neuroimage. 2011 Apr 15;55(4):1633-44.
3737
- Chang C, Cunningham JP, Glover GH. Influence of heart rate on the BOLD signal: the cardiac response function. Neuroimage. 2009 Feb 1;44(3):857-69.
3838
- Birn RM, Smith MA, Jones TB, Bandettini PA. The respiration response function: the temporal dynamics of fMRI signal fluctuations related to changes in respiration. Neuroimage. 2008;40(2):644-654.
39-

0 commit comments

Comments
 (0)