:py:mod:`sovabids.datasets`
===========================

.. py:module:: sovabids.datasets

.. autoapi-nested-parse::

   Module with dataset utilities.



Module Contents
---------------


Functions
~~~~~~~~~

.. autoapisummary::

   sovabids.datasets.lemon_prepare
   sovabids.datasets.lemon_bidscoin_prepare
   sovabids.datasets.make_dummy_dataset



.. py:function:: lemon_prepare()

   Download and prepare a few files of the LEMON dataset.

   .. rubric:: Notes

   See the `LEMON dataset <http://fcon_1000.projects.nitrc.org/indi/retro/MPI_LEMON.html>`_ .


.. py:function:: lemon_bidscoin_prepare(src_path)

   Download and prepare a few files of the LEMON dataset to be used with BIDSCOIN.

   :param src_path: The path where the BIDSCOIN-ready LEMON files will be
   :type src_path: str

   .. seealso:: :obj:`datasets.lemon_prepare`


.. py:function:: make_dummy_dataset(PATTERN='T%task%/S%session%/sub%subject%_%acquisition%_%run%', DATASET='DUMMY', NSUBS=2, NSESSIONS=2, NTASKS=2, NACQS=2, NRUNS=2, NCHANNELS=2, SFREQ=200, STOP=10, NUMEVENTS=10, PREFIXES={'subject': 'SU', 'session': 'SE', 'task': 'TA', 'acquisition': 'AC', 'run': 'RU'}, ROOT=None)

   Create a dummy dataset given some parameters.

   :param PATTERN: The pattern in placeholder notation using the following fields:
                   %dataset%, %task%, %session%, %subject%, %run%, %acquisition%
   :type PATTERN: str, optional
   :param DATASET: Name of the dataset.
   :type DATASET: str, optional
   :param NSUBS: Number of subjects.
   :type NSUBS: int, optional
   :param NSESSIONS: Number of sessions.
   :type NSESSIONS: int, optional
   :param NTASKS: Number of tasks.
   :type NTASKS: int, optional
   :param NACQS: Number of acquisitions.
   :type NACQS: int, optional
   :param NRUNS: Number of runs.
   :type NRUNS: int, optional
   :param NCHANNELS: Number of channels.
   :type NCHANNELS: int, optional
   :param SFREQ: Samplinf frequency of the data.
   :type SFREQ: float, optional
   :param STOP: Time duration of the data in seconds.
   :type STOP: float, optional
   :param NUMEVENTS: Number of events along the duration.
   :type NUMEVENTS: int, optional
   :param PREFIXES: Dictionary with the following keys:'subject', 'session', 'task' and 'acquisition'.
                    The values are the corresponding prefix. RUN is not present because it has to be a number.
   :type PREFIXES: dict, optional
   :param ROOT: Path where the files will be generated.
                If None, the _data subdir will be used.
   :type ROOT: str, optional