Estimator to filter RtEpochs.
Applies a zero-phase low-pass, high-pass, band-pass, or band-stop filter to the channels selected by “picks”.
l_freq and h_freq are the frequencies below which and above which, respectively, to filter out of the data. Thus the uses are:
l_freq < h_freq: band-pass filter
l_freq > h_freq: band-stop filter
l_freq is not None, h_freq is None: low-pass filter
l_freq is None, h_freq is not None: high-pass filter
If n_jobs > 1, more memory is required as “len(picks) * n_times” additional time points need to be temporarily stored in memory.
mne.Info
The mne.Info
object with information about the sensors and methods of measurement.
float
| None
For FIR filters, the lower pass-band edge; for IIR filters, the lower cutoff frequency. If None the data are only low-passed.
float
| None
For FIR filters, the upper pass-band edge; for IIR filters, the upper cutoff frequency. If None the data are only high-passed.
str
| list
| slice
| None
Channels to include. Slices and lists of integers will be interpreted as
channel indices. In lists, channel type strings (e.g., ['meg',
'eeg']
) will pick channels of those types, channel name strings (e.g.,
['MEG0111', 'MEG2623']
will pick the given channels. Can also be the
string values “all” to pick all channels, or “data” to pick data
channels. None (default) will pick good data channels. Note that channels
in info['bads']
will be included if their names or indices are
explicitly provided.
str
| int
Length of the FIR filter to use (if applicable):
‘auto’ (default): The filter length is chosen based on the size of the transition regions (6.6 times the reciprocal of the shortest transition band for fir_window=’hamming’ and fir_design=”firwin2”, and half that for “firwin”).
str: A human-readable time in
units of “s” or “ms” (e.g., “10s” or “5500ms”) will be
converted to that number of samples if phase="zero"
, or
the shortest power-of-two length at least that duration for
phase="zero-double"
.
int: Specified length in samples. For fir_design=”firwin”, this should not be used.
float
| str
Width of the transition band at the low cut-off frequency in Hz
(high pass or cutoff 1 in bandpass). Can be “auto”
(default) to use a multiple of l_freq
:
min(max(l_freq * 0.25, 2), l_freq)
Only used for method='fir'
.
float
| str
Width of the transition band at the high cut-off frequency in Hz
(low pass or cutoff 2 in bandpass). Can be “auto”
(default in 0.14) to use a multiple of h_freq
:
min(max(h_freq * 0.25, 2.), info['sfreq'] / 2. - h_freq)
Only used for method='fir'
.
int
| str
Number of jobs to run in parallel.
Can be ‘cuda’ if cupy
is installed properly and method=’fir’.
str
‘fir’ will use overlap-add FIR filtering, ‘iir’ will use IIR forward-backward filtering (via filtfilt).
dict
| None
Dictionary of parameters to use for IIR filtering. See mne.filter.construct_iir_filter for details. If iir_params is None and method=”iir”, 4th order Butterworth will be used.
str
Can be “firwin” (default) to use scipy.signal.firwin()
,
or “firwin2” to use scipy.signal.firwin2()
. “firwin” uses
a time-domain design technique that generally gives improved
attenuation using fewer samples than “firwin2”.
New in version 0.15.
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.
See also
Notes
This is primarily meant for use in conjunction with
mne_realtime.RtEpochs
. In general it is not recommended in a
normal processing pipeline as it may result in edge artifacts. Use with
caution.
Methods
|
Filter data. |
|
Fit to data, then transform it. |
|
Filter data. |
Filter data.
FilterEstimator
The modified instance.
mne.decoding.FilterEstimator
#