Parser for Elekta data acquisition settings.
This class parses parameters (e.g. events and averaging categories) that
are defined in the Elekta TRIUX/VectorView data acquisition software (DACQ)
and stored in info['acq_pars']
. It can be used to reaverage raw data
according to DACQ settings and modify original averaging settings if
necessary.
See also
mne.io.Raw.acqparser
Access the parser through a Raw attribute.
Notes
Any averaging category (also non-active ones) can be accessed by indexing
as acqparserfif['category_name']
.
categories
list
Return list of averaging categories ordered by DACQ index.
events
list
Return events ordered by DACQ index.
dict
Rejection criteria from DACQ that can be used with mne.Epochs. Note that mne does not support all DACQ rejection criteria (e.g. spike, slope).
dict
Flatness rejection criteria from DACQ that can be used with mne.Epochs.
dict
All DACQ parameters.
Methods
|
Return an averaging category, or list of categories. |
|
Return number of averaging categories marked active in DACQ. |
|
Get averaging parameters for a condition (averaging category). |
Return an averaging category, or list of categories.
dict
| list
of dict
Each dict should have the following keys:
The comment field in DACQ.
Whether the category was marked enabled in DACQ.
The index of the category in DACQ. Indices start from 1.
DACQ index of the reference event (trigger event, zero time for the corresponding epochs). Note that the event indices start from 1.
Start time of epoch relative to the reference event.
End time of epoch relative to the reference event.
Index of the required (conditional) event.
Whether the required event is required before (1) or after (2) the reference event.
The time range within which the required event must occur, before or after the reference event.
Whether the category was displayed online in DACQ.
Desired number of averages. DACQ stops collecting averages once this number is reached.
Whether to compute normal and alternating subaverages, and how many epochs to include. See the Elekta data acquisition manual for details. Currently the class does not offer any facility for computing subaverages, but it can be done manually by the user after collecting the epochs.
Return number of averaging categories marked active in DACQ.
int
The number of categories.
Return list of averaging categories ordered by DACQ index.
Only returns categories marked active in DACQ.
Return events ordered by DACQ index.
Only returns events that are in use (referred to by a category).
Get averaging parameters for a condition (averaging category).
Output is designed to be used with the Epochs class to extract the corresponding epochs.
Raw
objectAn instance of Raw.
None
| str
| dict
| list
of dict
Condition or a list of conditions. Conditions can be strings (DACQ comment field, e.g. ‘Auditory left’) or category dicts (e.g. acqp[‘Auditory left’], where acqp is an instance of AcqParserFIF). If None, get all conditions marked active in DACQ.
None
| str
| list
of str
Name of the stim channel or all the stim channels affected by the trigger. If None, the config variables ‘MNE_STIM_CHANNEL’, ‘MNE_STIM_CHANNEL_1’, ‘MNE_STIM_CHANNEL_2’, etc. are read. If these are not found, it will fall back to ‘STI101’ or ‘STI 014’ if present, then fall back to the first channel of type ‘stim’, if present.
int
| None
The value of the digital mask to apply to the stim channel values. If None (default), no masking is performed.
If True (default False), do a cast to uint16
on the channel
data. This can be used to fix a bug with STI101 and STI014 in
Neuromag acquisition setups that use channel STI016 (channel 16
turns data into e.g. -32768), similar to mne_fix_stim14 --32
in MNE-C.
The type of operation between the mask and the trigger. Choose ‘and’ for MNE-C masking behavior.
If True, use the ‘delayed lookup’ procedure implemented in Elekta software. When a trigger transition occurs, the lookup of the new trigger value will not happen immediately at the following sample, but with a 1-sample delay. This allows a slight asynchrony between trigger onsets, when they are intended to be synchronous. If you have accurate hardware and want to detect transitions with a resolution of one sample, use delayed_lookup=False.
dict
or list
of dict
Each dict has the following keys:
List of zero time points (t0) for the epochs matching the
condition. Use as the events
parameter to Epochs. Note
that these are not (necessarily) actual events.
Name of condition and index compatible with events
.
Should be passed as the event_id
parameter to Epochs.
Epoch starting time relative to t0. Use as the tmin
parameter to Epochs.
Epoch ending time relative to t0. Use as the tmax
parameter to Epochs.