# Authors: The MNE-Python contributors.
# License: BSD-3-Clause
# Copyright the MNE-Python contributors.
import os
import time
import numpy as np
from ...utils import verbose
from ..utils import _log_time_size
from ._utils import TEMAZEPAM_SLEEP_RECORDS, _check_subjects, _data_path, _fetch_one
data_path = _data_path # expose _data_path(..) as data_path(..)
BASE_URL = "https://physionet.org/physiobank/database/sleep-edfx/sleep-telemetry/" # noqa: E501
@verbose
def fetch_data(
subjects, path=None, force_update=False, base_url=BASE_URL, *, verbose=None
):
"""Get paths to local copies of PhysioNet Polysomnography dataset files.
This will fetch data from the publicly available subjects from PhysioNet's
study of Temazepam effects on sleep :footcite:`KempEtAl2000`. This
corresponds to a set of 22 subjects. Subjects had mild difficulty falling
asleep but were otherwise healthy.
See more details in the `physionet website
`_
:footcite:`GoldbergerEtAl2000`.
Parameters
----------
subjects : list of int
The subjects to use. Can be in the range of 0-21 (inclusive).
path : None | str
Location of where to look for the PhysioNet data storing location.
If None, the environment variable or config parameter
``PHYSIONET_SLEEP_PATH`` is used. If it doesn't exist, the "~/mne_data"
directory is used. If the Polysomnography dataset is not found under
the given path, the data will be automatically downloaded to the
specified folder.
force_update : bool
Force update of the dataset even if a local copy exists.
base_url : str
The base URL to download from.
%(verbose)s
Returns
-------
paths : list
List of local data paths of the given type.
See Also
--------
mne.datasets.sleep_physionet.age.fetch_data
Notes
-----
For example, one could do:
>>> from mne.datasets import sleep_physionet
>>> sleep_physionet.temazepam.fetch_data(subjects=[1]) # doctest: +SKIP
This would download data for subject 0 if it isn't there already.
References
----------
.. footbibliography::
"""
t0 = time.time()
records = np.loadtxt(
TEMAZEPAM_SLEEP_RECORDS,
skiprows=1,
delimiter=",",
usecols=(0, 3, 6, 7, 8, 9),
dtype={
"names": (
"subject",
"record",
"hyp sha",
"psg sha",
"hyp fname",
"psg fname",
),
"formats": (" 0:
_log_time_size(t0, sz)
return fnames