Dipole class for fixed-position dipole fits.
Note
This class should usually not be instantiated directly,
instead mne.read_dipole()
should be used.
mne.Info
The mne.Info
object with information about the sensors and methods of measurement.
array
, shape (n_channels, n_times)The dipole data.
array
, shape (n_times,)The time points.
int
Number of averages.
int
The kind of data.
str
The dipole comment.
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 class is for fixed-position dipole fits, where the position
(and maybe orientation) is static over time. For sequential dipole fits,
where the position can change a function of time, use mne.Dipole
.
New in version 0.12.
Methods
|
Copy the DipoleFixed object. |
|
Crop data to a given time interval. |
|
Decimate the time-series data. |
|
Plot dipole data. |
|
Save dipole in a .fif file. |
|
Shift time scale in epoched or evoked data. |
|
Convert time to indices. |
Channel names.
Copy the DipoleFixed object.
DipoleFixed
The copy.
Notes
New in version 0.16.
Crop data to a given time interval.
float
| None
Start time of selection in seconds.
float
| None
End time of selection in seconds.
If True (default), include tmax. If False, exclude tmax (similar to how Python indexing typically works).
New in version 0.19.
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.
Raw
, Epochs
, Evoked
, AverageTFR
, or SourceEstimate
The cropped time-series object, modified in-place.
Notes
Unlike Python slices, MNE time intervals by default include both
their end points; crop(tmin, tmax)
returns the interval
tmin <= t <= tmax
. Pass include_tmax=False
to specify the half-open
interval tmin <= t < tmax
instead.
Decimate the time-series data.
int
Factor by which to subsample the data.
Warning
Low-pass filtering is not performed, this simply selects
every Nth sample (where N is the value passed to
decim
), i.e., it compresses the signal (see Notes).
If the data are not properly filtered, aliasing artifacts
may occur.
int
Apply an offset to where the decimation starts relative to the sample corresponding to t=0. The offset is in samples at the current sampling rate.
New in version 0.12.
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.
The decimated object.
See also
Notes
For historical reasons, decim
/ “decimation” refers to simply subselecting
samples from a given signal. This contrasts with the broader signal processing
literature, where decimation is defined as (quoting
[1], p. 172; which cites
[2]):
“… a general system for downsampling by a factor of M is the one shown in Figure 4.23. Such a system is called a decimator, and downsampling by lowpass filtering followed by compression [i.e, subselecting samples] has been termed decimation (Crochiere and Rabiner, 1983).”
Hence “decimation” in MNE is what is considered “compression” in the signal processing community.
Decimation can be done multiple times. For example,
inst.decimate(2).decimate(2)
will be the same as
inst.decimate(4)
.
If decim
is 1, this method does not copy the underlying data.
New in version 0.10.0.
References
Plot dipole data.
matplotlib.figure.Figure
The figure containing the time courses.
Examples using plot
:
Source localization with equivalent current dipole (ECD) fit
Save dipole in a .fif file.
str
The name of the .fif file. Must end with '.fif'
or
'.fif.gz'
to make it explicit that the file contains
dipole information in FIF format.
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.
Shift time scale in epoched or evoked data.
float
The (absolute or relative) time shift in seconds. If relative
is True, positive tshift increases the time value associated with
each sample, while negative tshift decreases it.
If True, increase or decrease time values by tshift
seconds.
Otherwise, shift the time values such that the time of the first
sample equals tshift
.
The modified instance.
Notes
This method allows you to shift the time values associated with each data sample by an arbitrary amount. It does not resample the signal or change the data values in any way.
Time vector in seconds.
Last time point.
First time point.
mne.DipoleFixed
#Source localization with equivalent current dipole (ECD) fit