plot_sim_data.m

function p = plot_sim_data(dmodel, model_data, sim_data, plot_params)
%function plot_sim_data(descr, model_data, sim_data, plot_params)
% plots the simulation data as returned by detailed_simulation()
%
% Parameters:
%   sim_data:    simulation data structure as returned by detailed_simulation()
%   plot_params: structure which controls the plot output
%
% Optional fields of plot_params:
%   bind_to_model:  Sometimes the plot can adapted according to the parameters.
%                   For example if the domain of the simulation changes with
%                   the parameter. In this case this boolean flag can be set,
%                   and the copy_model_descr_to_plot_params() function is
%                   called to copy important parameters to the 'plot_params'
%                   (default = 'false')
%  plot:            function pointer to a function plotting a single snapshot
%                   for a specific time instant. (default = 'descr.plot')
%
% Required fields of sim_data:
%   U:               DOF vector of solution snapshots
%
% Return values:
%   p         : Matlab GUI handle to figure window
%
% function plotting simulation results

% Martin Drohmann 15.12.2009

  descr = dmodel.descr;
  if isfield(plot_params, 'bind_to_model') ...
      && plot_params.bind_to_model
    plot_params = copy_model_descr_to_plot_params(descr, ...
                                                  plot_params);
  end
  %     plot_params.plot = descr.plot;
  if ~isfield(plot_params,'plot')
    plot_params.plot = descr.plot;
  end;
  p = plot_sequence(sim_data.U, model_data.grid, plot_params);