Detailed Description

reduced model for linear evolution problems as given by a LinEvol.DetailedModel.

This is compatible with Greedy.User.IReducedModel and can therefore make use of detailed data objects created by Greedy algorithms.

Definition at line 18 of file ReducedModel.m.

Inheritance diagram for LinEvolDune.ReducedModel:

[legend]

Collaboration diagram for LinEvolDune.ReducedModel:

[legend]

Public Member Functions
	ReducedModel (LinEvol.DetailedModel dmodel,BasisGenDescr bg_descr)
	Constructor for the reduced model.

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

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

function a0 =	rb_init_values (Greedy.DataTree.Detailed.RBLeafNode detailed_data, decomp_mode)
	function computing initial values for a reduced simulation.

function rb_sim_data =	rb_reconstruction (LinEvol.DetailedData detailed_data, rb_sim_data)
	(trivial) function computing a detailed reconstruction by linear combination of the coefficients in the simulation data with the orthonormal reduced basis RB

function LinEvol.ReducedModel c =	copy ()
	function that deep copies this handle class

Public Member Functions inherited from LinEvol.ReducedModel
	ReducedModel (LinEvol.DetailedModel dmodel,BasisGenDescr bg_descr)
	Constructor for the reduced model.

function a0 =	rb_init_values (Greedy.DataTree.Detailed.RBLeafNode detailed_data, decomp_mode)
	function computing initial values for a reduced simulation.

function rb_sim_data =	rb_simulation_impl (LinEvol.ReducedData reduced_data)
	function, which performs a reduced basis online simulation for the parameter vector \(\mu \in {\cal P} \subset \mathbb{R}^p\), which is assumed to be set by IDetailedModel.set_mu()

function rb_sim_data =	rb_reconstruction (LinEvol.DetailedData detailed_data, rb_sim_data)
	(trivial) function computing a detailed reconstruction by linear combination of the coefficients in the simulation data with the orthonormal reduced basis RB

Public Member Functions inherited from Greedy.User.IReducedModel
	IReducedModel (IDetailedModel dmodel,BasisGenDescr bg_descr)
	constructor for this reduced model interface

function Greedy.User.ReducedData reduced_data =	gen_reduced_data (Greedy.User.IDetailedData detailed_data)
	Constructs the `reduced_data` object holding low dimensional data needed for efficient reduced simulations with rb_simulation().

function rb_sim_data =	rb_simulation (Greedy.User.ReducedData reduced_data)
	forwards the reduced simulation to the method rb_simulation_impl() after getting a suitable reduced data leaf element.

virtual function rb_sim_data =	rb_simulation_impl (Greedy.User.IReducedDataNode reduced_data)
	implementation of the reduced simulation

Public Member Functions inherited from IReducedModel
	IReducedModel (IDetailedModel dmodel, bg_descr)
	Constructor of a reduced model.

function iseq =	eq (IReducedModel other)
	Comparison operator checking whether the underlying detailed_model members of `this` and `other` are equal.

function IReducedData reduced_data =	gen_reduced_data (detailed_data)
	Constructs the `reduced_data` object holding low dimensional data needed for efficient reduced simulations with rb_simulation().

function reduced_data_subset =	extract_reduced_data_subset (IReducedData reduced_data)
	Extracts a subset of the `reduced_data` generated by gen_reduced_data().

virtual function rb_sim_data =	rb_simulation (reduced_data)
	Executes a reduced simulation and optionally an error estimation.

virtual function rb_sim_data =	rb_reconstruction (detailed_data, rb_sim_data)
	reconstructs the reduced simulation snapshots generated by rb_simulation() in the reduced space \({\cal W}_{\text{red}}\).

function U =	get_dofs_from_sim_data (sim_data)
	extracts the \(H\) dimensional Dof vector from the `sim_data` structure

function IDetailedData detailed_data =	gen_detailed_data (model_data)
	initiates the reduced basis generation process

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

function model_data =	gen_model_data ()
	generates large model data.

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

function this =	set_mu (mu)
	Sets the active parameter vector \(\mu \in {\cal M}\) used for simulations on this model.

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

function rb_size =	get_rb_size (detailed_data)
	returns the size of the generated reduced basis by the IDetailedData class.

function	couple_N_and_M (detailed_data, ratio, factor)
	sets all the basis sizes for reduced simulations by a ratio with respect to the maximum possible basis size and a factor between RB and EI basis sizes.

function this =	set_Mratio (detailed_data, ratio)
	in case of multiple operators subject to empirical interpolation, this sets number of reduced basis functions used for reduced simulations by specifying a ratio.

function Mratio =	get_Mratio (detailed_data)
	in case of multiple operators subject to empirical interpolation, this gets the mean of ratio between the number of reduced basis functions used for reduced simulations and the maximum possible.

function ret =	subsref (S)
	forwarding of fieldnames access to the underlying detailed_model description

Static Public Member Functions
static function Delta =	get_estimators_from_sim_data (rb_sim_data)
	Static helper method returning the vectors of error estimators for each reduced simulation snapshot \(u_{\text{red}}(\cdot, t^k)\) generated by rb_simulation().

static function Delta =	get_estimator_from_sim_data (rb_sim_data)
	Static helper method returning an error estimator for the whole reduced trajectory \(\{u_{\text{red}}(\cdot, t^k)\}_{k=0}^{K}\) generated by rb_simulation().

Public Attributes
	mu = "[]"

Public Attributes inherited from LinEvol.ReducedModel
	enable_error_estimator = true

Additional Inherited Members
Static Public Attributes inherited from LinEvol.ReducedModel
static const	ddescr_checks
	This constant is used for a consistency check of the model descr with help of IModel.struct_check()

Constructor & Destructor Documentation

LinEvolDune.ReducedModel.ReducedModel	(	LinEvol.DetailedModel	dmodel,
		BasisGenDescr	bg_descr
	)

Constructor for the reduced model.

Parameters

dmodel	object specifying how the high dimensional data can be computed.
bg_descr	structure specifying how the reduced basis shall be generated.

Definition at line 38 of file ReducedModel.m.

Member Function Documentation

function LinEvol.ReducedModel c = LinEvolDune.ReducedModel.copy ( )

virtual

function that deep copies this handle class

Return values

c	an object which is a deep copy of this object.

Reimplemented from LinEvol.ReducedModel.

Definition at line 171 of file ReducedModel.m.

function Delta = LinEvolDune.ReducedModel.get_estimator_from_sim_data ( rb_sim_data )

staticvirtual

Static helper method returning an error estimator for the whole reduced trajectory \(\{u_{\text{red}}(\cdot, t^k)\}_{k=0}^{K}\) generated by rb_simulation().

Parameters

rb_sim_data struct holding reduced simulation data returned by IReducedModel.rb_simulation() .

Return values

Delta This is a scalar computed from the estimates \(\eta^k(\mu)\). Usually the maximum over \(k=0,\ldots,K\) is returned.

Reimplemented from LinEvol.ReducedModel.

Definition at line 195 of file ReducedModel.m.

function Delta = LinEvolDune.ReducedModel.get_estimators_from_sim_data ( rb_sim_data )

staticvirtual

Static helper method returning the vectors of error estimators for each reduced simulation snapshot \(u_{\text{red}}(\cdot, t^k)\) generated by rb_simulation().

Parameters

rb_sim_data struct holding reduced simulation data returned by IReducedModel.rb_simulation() .

Return values

Delta This is a (K+1) x 1 vector of estimates \(\eta^k(\mu)\)

Reimplemented from LinEvol.ReducedModel.

Definition at line 184 of file ReducedModel.m.

function mu = LinEvolDune.ReducedModel.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 85 of file ReducedModel.m.

function a0 = LinEvolDune.ReducedModel.rb_init_values	(	Greedy.DataTree.Detailed.RBLeafNode	detailed_data,
			decomp_mode
	)

function computing initial values for a reduced simulation.

This calls rb_init_values_separable().

Parameters

detailed_data detailed data tree leaf object

decomp_mode

flag indicating the operation mode of the function:

0 (complete) : no affine parameter dependence or decomposition is performed.
1 (components) : for each output argument a cell array of output matrices is returned representing the \(q\)-th component independent of the parameters given in mu_names.
2 (coefficients) : returns a vector where each coordinate represents the \(q\)-the coefficient \(\sigma_{\cdot}^{q}(\mu)\) dependent on the parameters given in mu_names.

Return values

a0	coefficient vector of size `N x 1` for the initial values.

Definition at line 107 of file ReducedModel.m.

function rb_sim_data = LinEvolDune.ReducedModel.rb_reconstruction	(	LinEvol.DetailedData	detailed_data,
			rb_sim_data
	)

(trivial) function computing a detailed reconstruction by linear combination of the coefficients in the simulation data with the orthonormal reduced basis RB

This calls rb_reconstruction_default().

Parameters

detailed_data	object defining the basis generation algorithm and storage for storing high dimensional data, i.e. dependent on dimension \(H\). This data is necessary for detailed simulations, construction of online matrices, `reduced_data` and reconstruction of reduced simulations.
rb_sim_data	struct holding reduced simulation data returned by IReducedModel.rb_simulation() .

Return values

rb_sim_data struct holding the reduced simulation results and their reconstructions.

Definition at line 142 of file ReducedModel.m.

function IDetailedModel this = LinEvolDune.ReducedModel.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

Generated fields of this:

mu — mu

Implements IModel.

Definition at line 58 of file ReducedModel.m.

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

rbasis/problem_types/oop/+LinEvolDune/ReducedModel.m

Detailed Description

Public Member Functions

Static Public Member Functions

Public Attributes

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation