pyprf_feature
A free & open source package for finding best-fitting population receptive field (PRF) models and feature weights for fMRI data.
If you are only interested in the spatial properties of the population receptive fields, not preferred features, check out the pyprf package.
Installation
For installation, follow these steps:
(Optional) Create conda environment
conda create -n env_pyprf_feature python=2.7
source activate env_pyprf_feature
conda install pip
Clone repository
git clone https://github.com/MSchnei/pyprf_feature.git
Install numpy, e.g. by running:
pip install numpy
Install pyprf_feature with pip
pip install /path/to/cloned/pyprf_feature
Dependencies
Package |
Tested version |
|---|---|
1.11.1 |
|
0.18.0 |
|
2.0.2 |
How to use
1. Present stimuli and record fMRI data
The PsychoPy scripts in the Stimulation folder can be used for presenting appropriate visual stimuli.
2. Prepare spatial and temporal information for experiment as arrays
Run prepro_get_spat_info.py in the prepro folder to obtain an array with the spatial information of the experiment. This should result in a 3d numpy array with shape [pixel x pixel x nr of spatial aperture conditions] that represents images of the spatial apertures stacked on top of each other.
Run prepro_get_temp_info.py in the prepro folder to obtain an array with the temporal information of the experiment. This should result in a 2d numpy array with shape [nr of volumes across all runs x 4]. The first column represents unique identifiers of spatial aperture conditions. The second column represents onset times and the third durations (both in s).The fourth column represents unique feature identifiers.
3. Prepare the input data
The input data should be motion-corrected, high-pass filtered and (optionally) distortion-corrected. If desired, spatial as well as temporal smoothing can be applied. The PrePro folder contains some auxiliary scripts to perform some of these functions.
4. Adjust the csv file
Adjust the information in the config_default.csv file in the Analysis folder, such that the provided information is correct. It is recommended to make a specific copy of the csv file for every subject.
5. Run pyprf_feature
Open a terminal and run
pyprf_feature -config path/to/custom_config.csv
References
This application is based on the following work:
Dumoulin, S. O., & Wandell, B. A. (2008). Population receptive field estimates in human visual cortex. NeuroImage, 39(2), 647–660. https://doi.org/10.1016/j.neuroimage.2007.09.034
Nishimoto, S., Vu, A. T., Naselaris, T., Benjamini, Y., Yu, B., & Gallant, J. L. (2011). Report Reconstructing Visual Experiences from Brain Activity Evoked by Natural Movies, 1641–1646. https://doi.org/10.1016/j.cub.2011.08.031
St-Yves, G., & Naselaris, T. (2017). The feature-weighted receptive field: An interpretable encoding model for complex feature spaces. NeuroImage, (June), 1–15. https://doi.org/10.1016/j.neuroimage.2017.06.035
License
The project is licensed under GNU General Public License Version 3.
Metadata
Release files for pyprf_feature 1.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pyprf_feature-1.1.3.tar.gz | 56.8 kB | Without provenance | Details for pyprf_feature-1.1.3.tar.gz |
Release files / pyprf_feature-1.1.3.tar.gz
| Download URL | pyprf_feature-1.1.3.tar.gz |
|---|---|
| Size | 56.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e14adcd90c081ca3d024a402a69262cdce42ed2d73395995088528d3c59836bf
|
|
BLAKE2b-256 checksum How to use checksums |
7cf4718da4e68b350f81e5b918b201f23219f55e45977c2315027c7c30d92923
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Python-urllib/2.7
|
Security for pyprf_feature 1.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.