Skip to content

Commit b768437

Browse files
author
LegrandNico
committed
Remove reference to metadPy (instead of metadpy)
1 parent f8b7344 commit b768437

File tree

5 files changed

+32
-24
lines changed

5 files changed

+32
-24
lines changed

README.md

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,10 @@
44

55
# Cardioception
66

7-
<img src="/images/logo.png" align="left" alt="metadPy" height="230" HSPACE=30>
7+
<img src="/images/logo.png" align="left" alt="cardioception" height="230" HSPACE=30>
88

99
The Cardioception Python Package - Measuring Interoception with Psychopy - implements two measures of cardiac interoception (cardioception):
10+
1011
1. The **Heartbeat counting task** developed by Rainer Schandry<sup>1,2</sup>. This task cardiac measures interoception by asking participants to count their heartbeats for a given period of time. An accuracy score is then derived by comparing the reported number of heartbeats and the true number of heartbeats.
1112
2. The **Heart Rate Discrimination Task** <sup>3</sup> implementing an adaptive psychophysical measure of cardiac interoception where participants have to estimate the frequency of their heart rate by comparing it to tones that can be faster or slower. By manipulating the difference between the true heart rate and the presented tone using different staircase procedures, the bias (threshold) and precision (slope) of the psychometric function can be estimated either online or offline (see *Analyses* below), together with metacognitive efficiency.
1213

@@ -18,26 +19,28 @@ The documentation can be found under the following [link](https://embodied-compu
1819

1920
If you are using cardioception in a publication we ask you to cite the following paper:
2021

21-
>Legrand, N., Nikolova, N., Correa, C., Brændholt, M., Stuckert, A., Kildahl, N., Vejlø, M., Fardo, F., &amp; Allen, M. (2021). The Heart Rate Discrimination Task: A psychophysical method to estimate the accuracy and precision of interoceptive beliefs. Biological Psychology, 108239. https://doi.org/10.1016/j.biopsycho.2021.108239
22+
>Legrand, N., Nikolova, N., Correa, C., Brændholt, M., Stuckert, A., Kildahl, N., Vejlø, M., Fardo, F., &amp; Allen, M. (2021). The Heart Rate Discrimination Task: A psychophysical method to estimate the accuracy and precision of interoceptive beliefs. Biological Psychology, 108239. <https://doi.org/10.1016/j.biopsycho.2021.108239>
2223
2324
If you are using [systole](https://systole-docs.github.io/) to interact with your recording device (this is the default behavior in cardioception), you might also cite the following reference:
2425

25-
> Legrand et al., (2022). Systole: A python package for cardiac signal synchrony and analysis. Journal of Open Source Software, 7(69), 3832, https://doi.org/10.21105/joss.03832
26+
> Legrand et al., (2022). Systole: A python package for cardiac signal synchrony and analysis. Journal of Open Source Software, 7(69), 3832, <https://doi.org/10.21105/joss.03832>
2627
2728
## Looking for help?
2829

2930
If you have questions regarding the tasks, want to report a bug or discuss data analysis, please ask on our public [![Gitter](https://badges.gitter.im/Cardioception/community.svg)](https://gitter.im/Cardioception/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge).
3031

3132
# Installation
33+
3234
**Using the Python Package Index**
35+
3336
* The most recent version can be installed uing:
3437
`pip install cardioception`
35-
* The current development branch can be installed using
38+
* The current development branch can be installed using
3639
`pip install git+https://github.com/embodied-computation-group/Cardioception.git`
3740

3841
**Downloading the ZIP file**
3942

40-
<img src="/images/downloadZIP.png" align="left" alt="metadPy" height="200" HSPACE=30>
43+
<img src="/images/downloadZIP.png" align="left" alt="download" height="200" HSPACE=30>
4144

4245
You can also download the most recent version by downloading the repository as a .zip file.
4346

@@ -47,7 +50,7 @@ After extracting the content of the file, the package can be installed via the c
4750

4851
## Dependencies
4952

50-
Cardioception has been tested with Python 3.7. We recommend to use the last install of Anaconda for Python 3.7 or latest (see https://www.anaconda.com/products/individual#download-section).
53+
Cardioception has been tested with Python 3.7. We recommend to use the last install of Anaconda for Python 3.7 or latest (see <https://www.anaconda.com/products/individual#download-section>).
5154

5255
Make sure that you have the following packages installed and up to date before running cardioception:
5356

@@ -68,18 +71,20 @@ In addition, some function for HTML reports will require:
6871
* [matplotlib](https://matplotlib.org/) (>=3.3.3)
6972
* [seaborn](https://seaborn.pydata.org/) (>=0.11.1)
7073
* [pingouin](https://pingouin-stats.org/) (>=0.3.10)
71-
* [metadPy](https://github.com/LegrandNico/metadPy) (>=0.01)
74+
* [metadpy](https://github.com/Embodi3dComputationGroup/metadpy) (>=0.01)
7275

7376
**NOTE**
74-
The version provided here are the ones used when testing and runing cardioception locally, and are often the last ones. For several packages however, older version might also be compatibles.
77+
The version provided here are the ones used when testing and runing cardioception locally, and are often the last ones. For several packages however, older version might also be compatibles.
7578

7679
Cardioception will automatically copy the images and sound files necessary to run the task correctly (~ 160 Mo). These files will be removed if you uninstall the package using `pip uninstall cardioception`.
7780

7881
# Package modularity
82+
7983
## Physiological recording
8084

8185
Both the Heartbeat counting task (HBC) and the heart rate discrimination task (HRD) require access to physiological recording device during the task to estimate the heart rate or count the number of heartbeats in a given time window. Cardioception natively supports:
82-
* The [Nonin 3012LP Xpod USB pulse oximeter](https://www.nonin.com/products/xpod/) together with [Nonin 8000SM 'soft-clip' fingertip sensors](https://www.nonin.com/products/8000s/)
86+
87+
* The [Nonin 3012LP Xpod USB pulse oximeter](https://www.nonin.com/products/xpod/) together with [Nonin 8000SM 'soft-clip' fingertip sensors](https://www.nonin.com/products/8000s/)
8388
* Remote Data Access (RDA) via BrainVision Recorder together with [Brain product ExG amplifier](https://www.brainproducts.com/>).
8489

8590
The package can easily be extended and integrate other recording devices by providing another recording class that will interface with your own devices (ECG, pulse oximeters, or any king of recording that will offer precise estimation of the cardiac frequency).
@@ -172,18 +177,21 @@ More advanced subject and group-level Bayesian modeling approaches are described
172177
| Fitting the psychometric function (single subject) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/embodied-computation-group/Cardioception/blob/master/docs/source/examples/1-psychophysics_subject_level.ipynb?flush_cache=true) | [![View the notebook](https://img.shields.io/badge/render-nbviewer-orange.svg)](https://nbviewer.jupyter.org/github/embodied-computation-group/Cardioception/blob/master/docs/source/examples/1-psychophysics_subject_level.ipynb?flush_cache=true)
173178
| Fitting the psychometric function (group level) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/embodied-computation-group/Cardioception/blob/master/docs/source/examples/2-psychophysics_group_level.ipynb?flush_cache=true) | [![View the notebook](https://img.shields.io/badge/render-nbviewer-orange.svg)](https://nbviewer.jupyter.org/github/embodied-computation-group/Cardioception/blob/master/docs/source/examples/2-psychophysics_group_level.ipynb?flush_cache=true)
174179
| Fitting the psychometric function (repeated measures) | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/embodied-computation-group/Cardioception/blob/master/docs/source/examples/3-repeated_measures.ipynb?flush_cache=true) | [![View the notebook](https://img.shields.io/badge/render-nbviewer-orange.svg)](https://nbviewer.jupyter.org/github/embodied-computation-group/Cardioception/blob/master/docs/source/examples/3-repeated_measures.ipynb?flush_cache=true)
180+
175181
# References
176182

177-
1. Dale, A., & Anderson, D. (1978). Information Variables in Voluntary Control and Classical Conditioning of Heart Rate: Field Dependence and Heart-Rate Perception. Perceptual and Motor Skills, 47(1), 79–85. https://doi.org/10.2466/pms.1978.47.1.79
178-
2. Schandry, R. (1981). Heart Beat Perception and Emotional Experience. Psychophysiology, 18(4), 483–488. https://doi.org/10.1111/j.1469-8986.1981.tb02486.x
179-
3. Legrand, N., Nikolova, N., Correa, C., Brændholt, M., Stuckert, A., Kildahl, N., Vejlø, M., Fardo, F., & Allen, M. (2022). The heart rate discrimination task: A psychophysical method to estimate the accuracy and precision of interoceptive beliefs. In Biological Psychology (Vol. 168, p. 108239). Elsevier BV. https://doi.org/10.1016/j.biopsycho.2021.108239
180-
4. Leganes-Fonteneau, M., Cheang, Y., Lam, Y., Garfinkel, S., & Duka, T. (2019). Interoceptive awareness is associated with acute alcohol-induced changes in subjective effects. Pharmacology Biochemistry and Behavior, 181, 69–76. https://doi.org/10.1016/j.pbb.2019.03.007
181-
5. Hart, N., McGowan, J., Minati, L., & Critchley, H. D. (2013). Emotional Regulation and Bodily Sensation: Interoceptive Awareness Is Intact in Borderline Personality Disorder. Journal of Personality Disorders, 27(4), 506–518. https://doi.org/10.1521/pedi_2012_26_049
183+
1. Dale, A., & Anderson, D. (1978). Information Variables in Voluntary Control and Classical Conditioning of Heart Rate: Field Dependence and Heart-Rate Perception. Perceptual and Motor Skills, 47(1), 79–85. <https://doi.org/10.2466/pms.1978.47.1.79>
184+
2. Schandry, R. (1981). Heart Beat Perception and Emotional Experience. Psychophysiology, 18(4), 483–488. <https://doi.org/10.1111/j.1469-8986.1981.tb02486.x>
185+
3. Legrand, N., Nikolova, N., Correa, C., Brændholt, M., Stuckert, A., Kildahl, N., Vejlø, M., Fardo, F., & Allen, M. (2022). The heart rate discrimination task: A psychophysical method to estimate the accuracy and precision of interoceptive beliefs. In Biological Psychology (Vol. 168, p. 108239). Elsevier BV. <https://doi.org/10.1016/j.biopsycho.2021.108239>
186+
4. Leganes-Fonteneau, M., Cheang, Y., Lam, Y., Garfinkel, S., & Duka, T. (2019). Interoceptive awareness is associated with acute alcohol-induced changes in subjective effects. Pharmacology Biochemistry and Behavior, 181, 69–76. <https://doi.org/10.1016/j.pbb.2019.03.007>
187+
5. Hart, N., McGowan, J., Minati, L., & Critchley, H. D. (2013). Emotional Regulation and Bodily Sensation: Interoceptive Awareness Is Intact in Borderline Personality Disorder. Journal of Personality Disorders, 27(4), 506–518. <https://doi.org/10.1521/pedi_2012_26_049>
182188

183189
# Development
190+
184191
This package was created and is maintained by [Nicolas Legrand](https://legrandnico.github.io/) and [Micah Allen](https://micahallen.org/) from the [ECG group](https://the-ecg.org/).
185192

186193
<img src = "images/LabLogo.png" height ="100"><img src = "images/AU.png" height ="100">
187194

188195
# Credit
196+
189197
Some icons used in the Figures or presented during the tasks were downloaded from **Flaticon** [www.flaticon.com](www.flaticon.com).

cardioception/notebooks/HeartRateDiscrimination.ipynb

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@
3131
"import sys\n",
3232
"\n",
3333
"if 'google.colab' in sys.modules:\n",
34-
" ! pip install git+https://github.com/embodied-computation-group/metadPy.git\n",
34+
" ! pip install git+https://github.com/embodied-computation-group/metadpy.git\n",
3535
" ! pip install systole\n",
3636
" ! pip install pingouin"
3737
]
@@ -50,9 +50,9 @@
5050
"import pandas as pd\n",
5151
"import pingouin as pg\n",
5252
"import seaborn as sns\n",
53-
"from metadPy import sdt\n",
54-
"from metadPy.plotting import plot_confidence\n",
55-
"from metadPy.utils import discreteRatings, trials2counts\n",
53+
"from metadpy import sdt\n",
54+
"from metadpy.plotting import plot_confidence\n",
55+
"from metadpy.utils import discreteRatings, trials2counts\n",
5656
"from scipy.stats import norm\n",
5757
"from systole.detection import ppg_peaks\n",
5858
"\n",

cardioception/reports.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ def preprocessing(results: Union[PathLike, pd.DataFrame]) -> pd.DataFrame:
7272
import arviz as az
7373
import pymc as pm
7474
from metadpy import bayesian, sdt
75-
from metadPy.utils import discreteRatings
75+
from metadpy.utils import discreteRatings
7676

7777
# read the input file if only the path was provided
7878
if not isinstance(results, pd.DataFrame):

docs/source/examples/templates/HeartRateDiscrimination.ipynb

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@
3131
"import sys\n",
3232
"\n",
3333
"if 'google.colab' in sys.modules:\n",
34-
" ! pip install git+https://github.com/embodied-computation-group/metadPy.git\n",
34+
" ! pip install git+https://github.com/embodied-computation-group/metadpy.git\n",
3535
" ! pip install systole\n",
3636
" ! pip install pingouin"
3737
]
@@ -50,9 +50,9 @@
5050
"import pandas as pd\n",
5151
"import pingouin as pg\n",
5252
"import seaborn as sns\n",
53-
"from metadPy import sdt\n",
54-
"from metadPy.plotting import plot_confidence\n",
55-
"from metadPy.utils import discreteRatings, trials2counts\n",
53+
"from metadpy import sdt\n",
54+
"from metadpy.plotting import plot_confidence\n",
55+
"from metadpy.utils import discreteRatings, trials2counts\n",
5656
"from scipy.stats import norm\n",
5757
"from systole.detection import ppg_peaks\n",
5858
"\n",

docs/source/user_guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ In addition, some function for HTML reports will require:
4545
* [matplotlib](https://matplotlib.org/) (>=3.3.3)
4646
* [seaborn](https://seaborn.pydata.org/) (>=0.11.1)
4747
* [pingouin](https://pingouin-stats.org/) (>=0.3.10)
48-
* [metadPy](https://github.com/LegrandNico/metadPy) (>=0.01)
48+
* [metadpy](https://github.com/EmbodiedComputationGroup/metadpy) (>=0.01)
4949

5050
```{note}
5151
The version provided here are the ones used when testing and runing cardioception locally, and are often the last ones. For several packages however, older version might also be compatibles.

0 commit comments

Comments
 (0)