Detailed Description

Detailed model for a linear evolution problem with a Finite volume discretization.

This is a detailed model for a problem of the type

\begin{align} \partial_t u(x;t,\mu) - {\cal L}(t,\mu)[u(x,t;\mu)] &= 0 \qquad &\text{in }& \Omega \times [0, T], \\\ u(x;0,\mu) &= u_0(x;\mu) \qquad &\text{in }& \Omega \times \{0\} \end{align}

with suitable boundary conditions and linear operators \({\cal L}(t,\mu) : {\cal W} \to {\cal W}\) parametrized over the time-parameter domain \([0,T] \times {\cal M}\).

The numerical scheme for the numerical solution of this problem is assumed to be of the following type:

\begin{align*} u_h(\cdot;t^0,\mu) &= {\cal M}_h[u_0] \\\ \left(\text{Id} - \Delta t^k {\cal L}_{h, I}(t^{k+1},\mu)\right)[u_h(\cdot;t^{k+1},\mu)] &= \left(\text{Id} + \Delta t^k {\cal L}_{h, E}(t^{k},\mu)\right)[u_h(\cdot;t^{k},\mu)] \end{align*}

with the following ingredients:

a time discretization \(0 = t^0 \leq t^1 = t^0 + \Delta t^0 \leq \ldots \leq t^{K+1} = t^{K} + \Delta t^{K} = T\),
solution snapshots \(u_h(\cdot;t,\mu) \in { cal W }_h \) for all parameters and time instances \((t,\mu) \in [0,T] \times { \cal M }\)
separable operators for the discretization \({\cal L}_{h, I}(t,\mu):{\cal W}_h \to {\cal W}_h\), \({\cal L}_{h, E}(t,\mu):{\cal W}_h \to {\cal W}_h\) and separable initial data \(u_0\) in the parameter argument. That is these must be decomposable like
\begin{align*} {\cal L}_{h, *}(t,\mu) &= \sum_{q=1}^{q_*} \sigma_*^q(\mu) {\cal L}^q_{h, *}(t) \\\ u_0(x;\mu) &= \sum_{q=1}^{u_0} \sigma_{u_0}^q(\mu) u_0(x) \end{align*}
and
a projection operator \({\cal M}_h : {\cal W} \to {\cal W}_h\)

Definition at line 18 of file DetailedModel.m.

Inheritance diagram for LinEvolDune.DetailedModel:

[legend]

Collaboration diagram for LinEvolDune.DetailedModel:

[legend]

Public Member Functions
	DetailedModel (descr)
	constructor based on problem description More...

function IDetailedModel this =	set_mu (mu)
	sets the active parameter vector \(\mu \in {\cal M}\) More...

function mu =	get_mu ()
	returns the active parameter vector \(\boldsymbol\mu \in {\cal M}\) More...

function sim_data =	detailed_simulation (ModelData model_data)

function ModelData model_data =	gen_model_data ()
	generates large model data. More...

function p =	plot_sim_data (ModelData model_data, sim_data, plot_params)

Public Member Functions inherited from Greedy.User.FVDetailedModelDefault
	FVDetailedModelDefault (ModelDescr descr)
	Constructor for this class. More...

function UON =	orthonormalize (ModelData model_data, U)
	orthonormalizes a set of discrete functions \(\{ v_h^l \}_{l=1}^L\) More...

function U0 =	init_values_algorithm (ModelData model_data)
	computes the Dof vectors for the initial value function \(u_h^0(\cdot;t\mu) = {\cal P}_h[u_0(\mu)]\) More...

function UV =	inner_product (ModelData model_data, U, V)
	computes the inner project between the Dof vectors of two discrete functions More...

Public Member Functions inherited from Greedy.User.IDetailedModel
	IDetailedModel (descr)
	constructor More...

Public Member Functions inherited from IDetailedModel
	IDetailedModel (descr)
	constructor More...

function isequal =	eq (IDetailedModel other)
	overloaded equality (`==`) operator, by default comparing the descr variables More...

function IDetailedModel this =	set_mu (mu)
	sets the active parameter vector \(\mu \in {\cal M}\) More...

function mu =	get_mu ()
	returns the active parameter vector \(\boldsymbol\mu \in {\cal M}\) More...

virtual function sim_data =	detailed_simulation (model_data)
	executes a detailed simulation for a given parameter More...

virtual function p =	plot_sim_data (model_data, sim_data, plot_params)
	plots the simulation data as returned by detailed_simulation() More...

Static Public Member Functions
static function U =	get_dofs_from_sim_data (sim_data)
	extracts the \(H\) dimensional Dof vector from the `sim_data` structure More...

static function U =	get_dofs_at_time (sim_data, time)

static function	issue_plot_command (plot_dir, command)

static function	close_figure_and_vtk_plot (src, event)

Static Public Member Functions inherited from Greedy.User.FVDetailedModelDefault
static function errs =	l2_error_sequence_algorithm (U, Uapprox,ModelData model_data)
	computes the \(L^2(\Omega)\) error for each "snapshot" of a trajectories and returns the sequence of these errors. More...

static function errs =	linfty_error_sequence_algorithm (U, Uapprox,ModelData model_data)
	computes the \(L^{\infty}(\Omega)\) error for each "snapshot" of a trajectories and returns the sequence of these errors. More...

static function W =	get_inner_product_matrix (ModelData model_data)
	returns the inner product matrix for efficient computation of inner products on \({\cal W}_h\) More...

Static Public Member Functions inherited from IModel
static function ok =	struct_check (descr, checks)
	executes checks on the fields of a structure object More...

Static Public Attributes
static const	ddescr_checks
	This constant is used for a consistency check of the model descr with help of Greedy.Remove.IDetailedModelBase.struct_check() More...

Static Public Attributes inherited from IDetailedModel
static const	base_checks
	this structure holds variable names that need to be defined by the descr structure. More...

Static Public Attributes inherited from IModel
static const	time_checks
	This constant can be used for a consistency check of time evolution members in the ModelDescr with help of IModel.struct_check() More...

Additional Inherited Members
Public Attributes inherited from IDetailedModel
	descr
	The description structure holding information about the analytical parametrized problem and its discretization. More...

	decomp_mode

	mu_names
	cell array of strings describing the parameters of the model More...

	mu_ranges
	cell array of vectors of size two defining the allowed interval range for the parameter components More...

	verbose
	an integer defining the verbosity level of information output during basis generation More...

	debug
	an integer defining the debugging level controlling error output and extra tests during basis generation More...

Public Attributes inherited from IModel
	num_cpus = 4
	The number of CPUs used for parallel sessions. More...

	decomp_mode
	Decomposition operation mode. More...

	mu_names
	cell array of strings describing the parameters of the model More...

	mu_ranges
	cell array of vectors of size two defining the allowed interval range for the parameter components More...

	verbose
	an integer defining the verbosity level of information output during basis generation More...

	debug
	an integer defining the debugging level controlling error output and extra tests during basis generation More...

Constructor & Destructor Documentation

LinEvolDune.DetailedModel.DetailedModel ( descr )

constructor based on problem description

Parameters

descr structure describing the problem and the descretization

Definition at line 79 of file DetailedModel.m.

Here is the call graph for this function:

Member Function Documentation

function ModelDatamodel_data = LinEvolDune.DetailedModel.gen_model_data ( )

virtual

generates large model data.

This function generates e.g. a grid, which is not to be stored in the model, but required for numerics.

Return values

model_data Matlab structure storing high dimensional data needed by detailed_simulation().

Implements IDetailedModel.

Definition at line 138 of file DetailedModel.m.

static function U = LinEvolDune.DetailedModel.get_dofs_from_sim_data ( sim_data )

staticvirtual

extracts the \(H\) dimensional Dof vector from the sim_data structure

Parameters

sim_data matlab struct with simulation data generated e.g. by detailed_simulation() or rb_reconstruction() methods.

Return values

U	\(H\) dimensional Dof vector

Implements Greedy.User.IDetailedModel.

Definition at line 184 of file DetailedModel.m.

function mu = LinEvolDune.DetailedModel.get_mu ( )

virtual

returns the active parameter vector \(\boldsymbol\mu \in {\cal M}\)

The default implementation returns a vector of the values of the fields of the descr structure with names descr.mu_names.

Return values

mu	The parameter vector \(\boldsymbol\mu\)

Implements IModel.

Definition at line 117 of file DetailedModel.m.

function IDetailedModel this = LinEvolDune.DetailedModel.set_mu ( mu )

virtual

sets the active parameter vector \(\mu \in {\cal M}\)

The parameter set here, is used by the detailed_simulation() function.

The default implementation sets all fieldnames descr.mu_names in the descr struct.

Parameters

mu	The parameter vector \(\boldsymbol\mu\).

Return values

this	handle to the changed DetailedModel

Implements IModel.

Definition at line 94 of file DetailedModel.m.

Member Data Documentation

LinEvolDune.DetailedModel.ddescr_checks

static

Initial value:

= struct("   \
      'mass_matrix',           {{\@(x) isequal(class(x), 'function_handle')}}   \
      ")

This constant is used for a consistency check of the model descr with help of Greedy.Remove.IDetailedModelBase.struct_check()

Default: struct(" \ 'mass_matrix', {{@(x) isequal(class(x), 'function_handle')}} \ ")

Definition at line 63 of file DetailedModel.m.

The documentation for this class was generated from the following file:

rbasis/problem_types/+LinEvolDune/DetailedModel.m

Detailed Description

Public Member Functions

Static Public Member Functions

Static Public Attributes

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation