Skip to main content

NSD map data from various spaces

Project description

nsdcode

This repository contains nsd_mapdata.{m,py}, a light-weight utility that allows the user to map data between different reference spaces (e.g. anatomical, functional, volume-based, surface-based) in the NSD dataset. Both MATLAB and Python versions of the utility are provided.

For more information on the NSD dataset, please see http://naturalscenesdataset.org.

For examples of how to use nsd_mapdata, please take a look at examples_nsdmapdata.{m,py}.

Known issues:

  • Note that the MATLAB and Python implementations give extremely similar but not numerically identical results due to differences in interpolation implementation. Also, voxels near the edges of valid locations are also handled slightly differently in the Python version.
  • The Python version does not yet implement the anat-to-anat case.

MATLAB

The MATLAB implementation relies on a few external toolboxes that are provided in the matlab/external directory.

To install, unzip the matlab/external/*.zip files in place, and then

addpath(genpath('/path/to/nsdcode/matlab/'));

Because the utility relies on transformation files provided with the NSD dataset, the user must edit nsd_datalocation.m with the location of your local copy of the NSD dataset.

Python

To install:

cd python
python setup.py develop

Code dependencies:

There are some external dependencies which are listed in requirements.txt These are installed automatically when you run the setup above. These dependencies include:

  1. nibabel
  2. scipy
  3. numpy
  4. tqdm

Change history

  • Version 1.0 (Dec 20, 2020). This is the first official release of the software.

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

nsdcode-1.1.dev260054000.tar.gz (911.7 kB view hashes)

Uploaded Source

Built Distribution

nsdcode-1.1.dev260054000-py3-none-any.whl (19.0 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