Eelbrain

-----------

* New function for plotting a legend for annot-files:
:func:`plot.brain.annot_legend` (automatically used in reports).
* Epoch definitions in :attr:`pipeline.MneExperiment.epochs` can now include a ``'base'``
parameter, which will copy the given "base" epoch and modify it with the
current definition.
* :meth:`pipeline.MneExperiment.make_mov_ttest` and
:meth:`pipeline.MneExperiment.make_mov_ga_dspm` are fixed but require PySurfer 0.6.
* New function: :func:`table.melt_ndvar`.
* API: :mod:`plot.brain` function signatures changed slightly to accommodate
more layout-related arguments.
* API: use :meth:`Brain.image` instead of :func:`plot.brain.image`.

-----------

* The Eelbrain package on the PYPI is now compiled with Anaconda. This means
that the package can now be installed into an Anaconda distribution with
``pip``, whereas ``easy_install`` has to be used for the Canopy distribution.
* GUI :func:`gui.select_epochs`: Set marked channels through menu (View > Mark
Channels)
* Datasets can be saved as tables in RTF format (:meth:`Dataset.save_rtf`).
* API :class:`plot.Timeplot`: the default spread indicator changed to SEM, and
there is a new argument for `timelabels`.
* API: ``test.anova`` is now a function with a slightly changed signature.
The old class has been renamed to :class:`test.ANOVA`.
* API: ``test.oneway`` was removed. Use :class:`test.ANOVA`.
* API: the default value of the :class:`plot.Timeplot` parameter `bottom`
changed from `0` to `None` (determined by the data).
* API: :meth:`Factor.relabel` renamed to :meth:`Factor.update_labels`.
* Plotting: New option for the figure legend ``'draggable'`` (drag the legend
with the mouse pointer).

-----------

* API: the :class:`plot.Topomap` argument `sensors` changed to `sensorlabels`.
* GUI: The *python/Quit Eelbrain* menu command now closes all windows to ensure
that unsaved documents are handled properly. In order to yield to the terminal
without closing windows, use the *Go/Yield to Terminal* command
(Command-Alt-Q).
* :class:`testnd.TContrastRelated`: support for unary operation `abs`.

-----------

* The :func:`gui.select_epochs` GUI can now also be used to set bad channels.
:class:`pipeline.MneExperiment` subclasses will combine bad channel information from
rejection files with bad channel information from bad channel files. Note
that while bad channel files set bad channels for a given raw file
globally, rejection files set bad channels only for the given epoch.
* :class:`Factor` objects can now remember a custom cell order which determines
the order in tables and plots.
* The :meth:`Var.as_factor` method can now assign all unmentioned codes to a
default value.
* :class:`MneExperiment`:

- API: Subclasses should remove the ``subject`` and ``experiment`` parameters
from :meth:`pipeline.MneExperiment.label_events`.
- API: :class:`pipeline.MneExperiment` can now be imported directly from
:mod:`eelbrain`.
- API: The :attr:`pipeline.MneExperiment._defaults` attribute should be renamed to
:attr:`pipeline.MneExperiment.defaults`.
- A draft for a guide at :ref:`experiment-class-guide`.
- Cached files are now saved in a separate folder at ``root/eelbrain-cache``.
The cache can be cleared using :meth:`pipeline.MneExperiment.clear_cache`. To
preserve cached test results, move the ``root/test`` folder into the
``root/eelbrain-cache`` folder.

-----------

* API: :class:`Dataset` construction changed, allows setting the number of
cases in the Dataset.
* API: :class:`plot.SensorMap2d` was renamed to :class:`plot.SensorMap`.
* :class:`MneExperiment`:

- API: The default number of samples for reports is now 10'000.
- New epoch parameter ``'n_cases'``: raise an error if an epoch definition
does not yield expected number of trials.
- A custom baseline period for epochs can now be specified as a parameter in
the epoch definition (e.g., ``'baseline': (-0.2, -0.1)``). When loading
data, specifying ``baseline=True`` uses the epoch's custom baseline.

-----------

* :class:`MneExperiment`:

- Change in the way the covariance matrix
is defined: The epoch for the covariance matrix should be specified in
``MneExperiment.epochs['cov']``. The regularization is no longer part of
:meth:`pipeline.MneExperiment.set_inv`, but is instead set with
``MneExperiment.set(cov='reg')`` or ``MneExperiment.set(cov='noreg')``.
- New option ``cov='bestreg'`` automatically selects the regularization
parameter for each subejct.

* :meth:`Var.as_factor` allows more efficient labeling when multiple values
share the same label.
* API: Previously :func:`plot.configure_backend` is now :func:`plot.configure`