1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
# -*- coding: utf-8 -*-
# Authors: Eric Larson <larson.eric.d@gmail.com>
# License: BSD Style.
import os
import os.path as op
from ..utils import _manifest_check_download
from ...utils import verbose, get_subjects_dir, _check_option, _validate_type
PHANTOM_MANIFEST_PATH = op.dirname(__file__)
@verbose
def fetch_phantom(kind, subjects_dir=None, *, verbose=None):
"""Fetch and update a phantom subject.
Parameters
----------
kind : str
The kind of phantom to fetch. Can only be ``'otaniemi'`` (default).
%(subjects_dir)s
%(verbose)s
Returns
-------
subject_dir : str
The resulting phantom subject directory.
See Also
--------
mne.dipole.get_phantom_dipoles
Notes
-----
This function is designed to provide a head surface and T1.mgz for
the 32-dipole Otaniemi phantom. The VectorView/TRIUX phantom has the same
basic outside geometry, but different internal dipole positions.
Unlike most FreeSurfer subjects, the Otaniemi phantom scan was aligned
to the "head" coordinate frame, so an identity head<->MRI :term:`trans`
is appropriate.
.. versionadded:: 0.24
"""
phantoms = dict(
otaniemi=dict(url='https://osf.io/j5czy/download?version=1',
hash='42d17db5b1db3e30327ffb4cf2649de8'),
)
_validate_type(kind, str, 'kind')
_check_option('kind', kind, list(phantoms))
subjects_dir = get_subjects_dir(subjects_dir, raise_error=True)
subject = f'phantom_{kind}'
subject_dir = op.join(subjects_dir, subject)
os.makedirs(subject_dir, exist_ok=True)
_manifest_check_download(
manifest_path=op.join(PHANTOM_MANIFEST_PATH, f'{subject}.txt'),
destination=subjects_dir,
url=phantoms[kind]['url'],
hash_=phantoms[kind]['hash'],
)
return subject_dir
|
