.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "_auto_examples/shortclips/00_download_shortclips.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download__auto_examples_shortclips_00_download_shortclips.py>`
        to download the full example code

.. rst-class:: sphx-glr-example-title

.. _sphx_glr__auto_examples_shortclips_00_download_shortclips.py:


=====================
Download the data set
=====================

In this script, we download the data set from Wasabi or GIN. No account is
required.

Cite this data set
------------------

This tutorial is based on publicly available data `published on GIN
<https://gin.g-node.org/gallantlab/shortclips>`_. If you publish any work using
this data set, please cite the original publication [1]_, and the data set
[2]_.

.. GENERATED FROM PYTHON SOURCE LINES 17-17

.. code-block:: Python
   :dedent: 1


.. GENERATED FROM PYTHON SOURCE LINES 19-21

Download
--------

.. GENERATED FROM PYTHON SOURCE LINES 21-27

.. code-block:: Python


    # path of the data directory
    from voxelwise_tutorials.io import get_data_home
    directory = get_data_home(dataset="shortclips")
    print(directory)


.. GENERATED FROM PYTHON SOURCE LINES 28-35

We will only use the first subject in this tutorial, but you can run the same
analysis on the four other subjects. Uncomment the lines in ``DATAFILES`` to
download more subjects.

We also skip the stimuli files, since the dataset provides two preprocessed
feature spaces to perform voxelwise modeling without requiring the original
stimuli.

.. GENERATED FROM PYTHON SOURCE LINES 35-72

.. code-block:: Python


    from voxelwise_tutorials.io import download_datalad

    DATAFILES = [
        "features/motion_energy.hdf",
        "features/wordnet.hdf",
        "mappers/S01_mappers.hdf",
        # "mappers/S02_mappers.hdf",
        # "mappers/S03_mappers.hdf",
        # "mappers/S04_mappers.hdf",
        # "mappers/S05_mappers.hdf",
        "responses/S01_responses.hdf",
        # "responses/S02_responses.hdf",
        # "responses/S03_responses.hdf",
        # "responses/S04_responses.hdf",
        # "responses/S05_responses.hdf",
        # "stimuli/test.hdf",
        # "stimuli/train_00.hdf",
        # "stimuli/train_01.hdf",
        # "stimuli/train_02.hdf",
        # "stimuli/train_03.hdf",
        # "stimuli/train_04.hdf",
        # "stimuli/train_05.hdf",
        # "stimuli/train_06.hdf",
        # "stimuli/train_07.hdf",
        # "stimuli/train_08.hdf",
        # "stimuli/train_09.hdf",
        # "stimuli/train_10.hdf",
        # "stimuli/train_11.hdf",
    ]

    source = "https://gin.g-node.org/gallantlab/shortclips"

    for datafile in DATAFILES:
        local_filename = download_datalad(datafile, destination=directory,
                                          source=source)


.. GENERATED FROM PYTHON SOURCE LINES 73-83

References
----------

.. [1] Huth, A. G., Nishimoto, S., Vu, A. T., & Gallant, J. L. (2012). A
    continuous semantic space describes the representation of thousands of
    object and action categories across the human brain. Neuron, 76(6),
    1210-1224.

.. [2] Huth, A. G., Nishimoto, S., Vu, A. T., Dupré la Tour, T., & Gallant, J. L. (2022).
    Gallant Lab Natural Short Clips 3T fMRI Data. http://dx.doi.org/10.12751/g-node.vy1zjd


.. _sphx_glr_download__auto_examples_shortclips_00_download_shortclips.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: 00_download_shortclips.ipynb <00_download_shortclips.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: 00_download_shortclips.py <00_download_shortclips.py>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_