mne.io.read_raw_hitachi#

mne.io.read_raw_hitachi(fname, preload=False, verbose=None) → RawHitachi[source]#

Reader for a Hitachi fNIRS recording.

Parameters:

fnamelist | str: Path(s) to the Hitachi CSV file(s). This should only be a list for multiple probes that were acquired simultaneously.

Changed in version 1.2: Added support for list-of-str.
preloadbool or str (default False): Preload data into memory for data manipulation and faster indexing. If True, the data will be preloaded into memory (fast, requires large amount of memory). If preload is a string, preload is the file name of a memory-mapped file which is used to store the data on the hard drive (slower, requires less memory).
verbosebool | str | int | None: Control verbosity of the logging output. If None, use the default verbosity level. See the logging documentation and mne.verbose() for details. Should only be passed as a keyword argument.

Returns:

rawinstance of RawHitachi: A Raw object containing Hitachi data. See mne.io.Raw for documentation of attributes and methods.

See also

mne.io.Raw: Documentation of attributes and methods of RawHitachi.

Notes

Hitachi does not encode their channel positions, so you will need to create a suitable mapping using mne.channels.make_standard_montage() or mne.channels.make_dig_montage() like (for a 3x5/ETG-7000 example):

>>> mon = mne.channels.make_standard_montage('standard_1020')
>>> need = 'S1 D1 S2 D2 S3 D3 S4 D4 S5 D5 S6 D6 S7 D7 S8'.split()
>>> have = 'F3 FC3 C3 CP3 P3 F5 FC5 C5 CP5 P5 F7 FT7 T7 TP7 P7'.split()
>>> mon.rename_channels(dict(zip(have, need)))
>>> raw.set_montage(mon)  

The 3x3 (ETG-100) is laid out as two separate layouts:

S1--D1--S2    S6--D6--S7
|   |   |     |   |   |
D2--S3--D3    D7--S8--D8
|   |   |     |   |   |
S4--D4--S5    S9--D9--S10

The 3x5 (ETG-7000) is laid out as:

S1--D1--S2--D2--S3
|   |   |   |   |
D3--S4--D4--S5--D5
|   |   |   |   |
S6--D6--S7--D7--S8

The 4x4 (ETG-7000) is laid out as:

S1--D1--S2--D2
|   |   |   |
D3--S3--D4--S4
|   |   |   |
S5--D5--S6--D6
|   |   |   |
D7--S7--D8--S8

The 3x11 (ETG-4000) is laid out as:

S1--D1--S2--D2--S3--D3--S4--D4--S5--D5--S6
|   |   |   |   |   |   |   |   |   |   |
D6--S7--D7--S8--D8--S9--D9--S10-D10-S11-D11
|   |   |   |   |   |   |   |   |   |   |
S12-D12-S13-D13-S14-D14-S16-D16-S17-D17-S18

For each layout, the channels come from the (left-to-right) neighboring source-detector pairs in the first row, then between the first and second row, then the second row, etc.

Added in version 0.24.