plot_sim_data.m

function p = plot_sim_data(dmodel, model_data, sim_data, plot_params)
% function p = plot_sim_data(dmodel, model_data, sim_data, plot_params)
% plots the simulation data as returned by detailed_simulation()
%
% This method actually calls femdiscfunc.plot().
%
% Parameters:
%   sim_data:    simulation data structure as returned by detailed_simulation()
%   plot_params: structure which controls the plot output
%
% Required fields of sim_data:
%   uh:           discrete @ref fem function (c.f. femdiscfunc)
%
% Optional fields of plot_params:
%   subsampling_level: number of sampling steps for interpolation of discrete
%                      @ref fem functions. (default = 10)
%   title:             title of the plot
%
% Return values:
%   p:           GUI handle to the created MATLAB figure

% B. Haasdonk 22.2.2011

% plot result
if nargin < 4
  plot_params = [];
end;
if ~isfield(plot_params,'subsampling_level');
  plot_params.subsampling_level = 10;
end;
if ~isfield(plot_params,'title');
  plot_params.title = '';
end;
p = plot(sim_data.uh, plot_params);
title(plot_params.title);
% later: output as text label or as screen print, etc.