mne.io.read_raw_kit#
- mne.io.read_raw_kit(input_fname, mrk=None, elp=None, hsp=None, stim='>', slope='-', stimthresh=1, preload=False, stim_code='binary', allow_unknown_format=False, standardize_names=False, verbose=None)[source]#
Reader function for Ricoh/KIT conversion to FIF.
- Parameters
- input_fname
str Path to the sqd file.
- mrk
None|str| array_like, shape (5, 3) |listofstror array_like Marker points representing the location of the marker coils with respect to the MEG Sensors, or path to a marker file. If list, all of the markers will be averaged together.
- elp
None|str| array_like, shape (8, 3) Digitizer points representing the location of the fiducials and the marker coils with respect to the digitized head shape, or path to a file containing these points.
- hsp
None|str|array, shape (n_points, 3) Digitizer head shape points, or path to head shape file. If more than 10,000 points are in the head shape, they are automatically decimated.
- stim
listofint| ‘<’ | ‘>’ Channel-value correspondence when converting KIT trigger channels to a Neuromag-style stim channel. For ‘<’, the largest values are assigned to the first channel (default). For ‘>’, the largest values are assigned to the last channel. Can also be specified as a list of trigger channel indexes.
- slope‘+’ | ‘-’
How to interpret values on KIT trigger channels when synthesizing a Neuromag-style stim channel. With ‘+’, a positive slope (low-to-high) is interpreted as an event. With ‘-’, a negative slope (high-to-low) is interpreted as an event.
- stimthresh
float The threshold level for accepting voltage changes in KIT trigger channels as a trigger event.
- preloadbool or
str(defaultFalse) 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).
- stim_code‘binary’ | ‘channel’
How to decode trigger values from stim channels. ‘binary’ read stim channel events as binary code, ‘channel’ encodes channel number.
- allow_unknown_formatbool
Force reading old data that is not officially supported. Alternatively, read and re-save the data with the KIT MEG Laboratory application.
- standardize_namesbool
If True, standardize MEG and EEG channel names to be
"MEG ###"and"EEG ###". If False (default), native channel names in the file will be used when possible.- verbosebool |
str|int|None Control verbosity of the logging output. If
None, use the default verbosity level. See the logging documentation andmne.verbose()for details. Should only be passed as a keyword argument.
- input_fname
- Returns
- rawinstance of RawKIT
A Raw object containing KIT data.
See also
mne.io.RawDocumentation of attribute and methods.
Notes
If mrk, hsp or elp are array_like inputs, then the numbers in xyz coordinates should be in units of meters.