function [cfg] = ft_movieplotER(cfg, data)

% FT_MOVIEPLOTER makes a movie of the the event-related potentials, event-related

% fields or oscillatory activity (power or coherence) versus frequency.

%

% Use as

% ft_movieplotER(cfg, timelock)

% where the input data is from FT_TIMELOCKANALYSIS and the configuration

% can contain

% cfg.parameter = string, parameter that is color coded (default = 'avg')

% cfg.xlim = 'maxmin' or [xmin xmax] (default = 'maxmin')

% cfg.zlim = plotting limits for color dimension, 'maxmin',

% 'maxabs', 'zeromax', 'minzero', or [zmin zmax] (default = 'maxmin')

% cfg.speed = number, initial speed for interactive mode (default = 1)

% cfg.samperframe = number, samples per frame for non-interactive mode (default = 1)

% cfg.framespersec = number, frames per second for non-interactive mode (default = 5)% cfg.framesfile = 'string' or empty, filename of saved frames.mat (default = [])

% cfg.layout = specification of the layout, see below

% cfg.interpolatenan = string 'yes', 'no' interpolate over channels containing NaNs (default = 'yes')

% cfg.colormap = string, or Nx3 matrix, see FT_COLORMAP

% cfg.baseline = 'yes','no' or [time1 time2] (default = 'no'), see FT_TIMELOCKBASELINE

% cfg.baselinetype = 'absolute' or 'relative' (default = 'absolute')

% cfg.colorbar = 'yes', 'no' (default = 'no')

% cfg.colorbartext = string indicating the text next to colorbar

% cfg.renderer = string, 'opengl', 'zbuffer', 'painters', see RENDERERINFO (default is automatic, try 'painters' when it crashes)

%

% The layout defines how the channels are arranged. You can specify the

% layout in a variety of ways:

% - you can provide a pre-computed layout structure (see prepare_layout)

% - you can give the name of an ascii layout file with extension *.lay

% - you can give the name of an electrode file

% - you can give an electrode definition, i.e. "elec" structure

% - you can give a gradiometer definition, i.e. "grad" structure

% If you do not specify any of these and the data structure contains an

% electrode or gradiometer structure, that will be used for creating a

% layout. If you want to have more fine-grained control over the layout

% of the subplots, you should create your own layout file.

%

% To facilitate data-handling and distributed computing you can use

% cfg.inputfile = ...

% If you specify this option the input data will be read from a *.mat

% file on disk. This mat files should contain only a single variable named 'data',

% corresponding to the input structure.

%

% See also FT_MULTIPLOTER, FT_TOPOPLOTER, FT_SINGLEPLOTER, FT_MOVIEPLOTTFR, FT_SOURCEMOVIE

% Copyright (C) 2009-2023, Ingrid Nieuwenhuis, Jan-Mathijs Schoffelen, Robert Oostenveld, Cristiano Micheli

%

% This file is part of FieldTrip, see http://www.fieldtriptoolbox.org

% for the documentation and details.

%

% FieldTrip is free software: you can redistribute it and/or modify

% it under the terms of the GNU General Public License as published by

% the Free Software Foundation, either version 3 of the License, or

% (at your option) any later version.

%

% FieldTrip is distributed in the hope that it will be useful,

% but WITHOUT ANY WARRANTY; without even the implied warranty of

% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

% GNU General Public License for more details.

%

% You should have received a copy of the GNU General Public License

% along with FieldTrip. If not, see <http://www.gnu.org/licenses/>.

%

% $Id$

% these are used by the ft_preamble/ft_postamble function and scripts

ft_revision = '$Id$';

ft_nargin = nargin;

ft_nargout = nargout;

% do the general setup of the function

ft_defaults

ft_preamble init

ft_preamble debug

ft_preamble loadvar data

ft_preamble provenance data

% the ft_abort variable is set to true or false in ft_preamble_init

if ft_abort

return

end

% check if the input data is valid for this function

data = ft_checkdata(data, 'datatype', 'timelock');

% set the defaults

cfg.parameter = ft_getopt(cfg, 'parameter', 'avg');

cfg.interactive = ft_getopt(cfg, 'interactive', 'yes');

cfg.baseline = ft_getopt(cfg, 'baseline', 'no');

cfg.visible = ft_getopt(cfg, 'visible', 'on');

cfg.renderer = ft_getopt(cfg, 'renderer'); % let MATLAB decide on the default

% apply optional baseline correction

if ~strcmp(cfg.baseline, 'no')

tmpcfg = keepfields(cfg, {'baseline', 'baselinetype', 'parameter', 'showcallinfo', 'trackcallinfo', 'trackusage', 'trackdatainfo', 'trackmeminfo', 'tracktimeinfo', 'checksize'});

data = ft_timelockbaseline(tmpcfg, data);

[cfg, data] = rollback_provenance(cfg, data);

end

% prevent any further baseline correction from happening in ft_movieplotTFR

tmpcfg = removefields(cfg, {'baseline', 'baselinetype'});

tmpcfg = ft_movieplotTFR(tmpcfg, data);

% this is needed for the figure title

if isfield(cfg, 'dataname') && ~isempty(cfg.dataname)

dataname = cfg.dataname;

elseif isfield(cfg, 'inputfile') && ~isempty(cfg.inputfile)

dataname = cfg.inputfile;

elseif nargin>1

dataname = arrayfun(@inputname, 2:nargin, 'UniformOutput', false);

else

dataname = {};

end

% set the figure window title

if ~isempty(dataname)

set(gcf, 'Name', sprintf('%d: %s: %s', double(gcf), mfilename, join_str(', ', dataname)));

else

set(gcf, 'Name', sprintf('%d: %s', double(gcf), mfilename));

end

set(gcf, 'NumberTitle', 'off');

% do the general cleanup and bookkeeping at the end of the function

ft_postamble debug

ft_postamble previous data

ft_postamble provenance

ft_postamble savefig

% add a menu to the figure, but only if the current figure does not have subplots

menu_fieldtrip(gcf, cfg, false);

if ~ft_nargout

% don't return anything

clear cfg

end