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.