rbmatlab  1.16.09
 All Classes Namespaces Files Functions Variables Modules Pages
List of all members | Public Member Functions | Public Attributes
ParameterSampling.IRefineable Class Referenceabstract

Detailed Description

Interface class for parameter sample classes that allow the adaptive refinement of the sampling.

Definition at line 18 of file IRefineable.m.

Inheritance diagram for ParameterSampling.IRefineable:
Inheritance graph
[legend]
Collaboration diagram for ParameterSampling.IRefineable:
Collaboration graph
[legend]

Public Member Functions

virtual function cogs = cogs ()
 returns the center of gravity of sample cells (in case the sample can be viewed as a grid) More...
 
virtual function
max_vertex = 
elementwise_maximum_of_vertex_values (values)
 returns \(\max_{v \in V(e)} \text{val}_v\) for each sample cell \(e\) (in case the sample can be viewed as a grid with vertices as sample vectors) More...
 
virtual function IRefineable this = refine (elems)
 refines the object at the the given elements More...
 
virtual function level = get_refinement_levels ()
 returns the number of refinement steps for each sample element More...
 
virtual function skips = skipped_refinements ()
 determines for every sample element how often it was skipped during the last refinement steps. More...
 
function sampleget_sample_at_ref_level (ref_level)
 helper function returning the sample at a given refinement level More...
 
- Public Member Functions inherited from ParameterSampling.Interface
virtual function  init_sample (IDetailedModel dmodel)
 initializes the parameter sampling object More...
 
virtual function size = size ()
 returns the number of parameter vectors in this sampling More...
 
function
please_init = 
init_required ()
 returns a boolean indicating whether the object is fully functional, or must be initialized by a call to init_sample(). More...
 

Public Attributes

 sample_history = {""}
 cell array of samples that are generated during refinement cycle More...
 
 refined_elements = {""}
 cell array of elements which are refined at each refinement step More...
 
- Public Attributes inherited from ParameterSampling.Interface
 sample
 matrix storing the parameter vectors in the parameter samples as row vectors. More...
 

Additional Inherited Members

- Protected Attributes inherited from ParameterSampling.Interface
 init_done = false
 boolean indicating whether the object has already been initialized by a call of init_sample(). More...
 

Member Function Documentation

function cogs = ParameterSampling.IRefineable.cogs ( )
pure virtual

returns the center of gravity of sample cells (in case the sample can be viewed as a grid)

Usually the center of gravity of grid cells is a new sample vector in case the element is refined.

Todo:
Maybe this should be renamed to refinement_candidates, because otherwise it is restricted to grids.
Return values
cogsa matrix with sample vectors as row vectors

Implemented in ParameterSampling.Uniform.

function max_vertex = ParameterSampling.IRefineable.elementwise_maximum_of_vertex_values (   values)
pure virtual

returns \(\max_{v \in V(e)} \text{val}_v\) for each sample cell \(e\) (in case the sample can be viewed as a grid with vertices as sample vectors)

Parameters
valuesvalues
Return values
max_vertexvector of maxima as described above

Implemented in ParameterSampling.Uniform.

function level = ParameterSampling.IRefineable.get_refinement_levels ( )
pure virtual

returns the number of refinement steps for each sample element

Return values
levela vector with number of refinement steps for each sample element

Implemented in ParameterSampling.Uniform.

function sample = ParameterSampling.IRefineable.get_sample_at_ref_level (   ref_level)

helper function returning the sample at a given refinement level

Parameters
ref_levelthe refinement level
Return values
samplethe parameter sample how it looked like before refinement step ref_level

Definition at line 120 of file IRefineable.m.

function IRefineable this = ParameterSampling.IRefineable.refine (   elems)
pure virtual

refines the object at the the given elements

At each refinement, the refined elements and the previous sample is added to the cell arrays sample_history and refined_elements

Parameters
elemsA vector of element indices to be refined
Return values
thisthe updated object

Implemented in ParameterSampling.Uniform.

function skips = ParameterSampling.IRefineable.skipped_refinements ( )
pure virtual

determines for every sample element how often it was skipped during the last refinement steps.

Return values
skipsa vector of the number of skips for each sample element.

Implemented in ParameterSampling.Uniform.

Member Data Documentation

ParameterSampling.IRefineable.refined_elements = {""}

cell array of elements which are refined at each refinement step


Default: {""}

Definition at line 38 of file IRefineable.m.

ParameterSampling.IRefineable.sample_history = {""}

cell array of samples that are generated during refinement cycle


Default: {""}

Definition at line 29 of file IRefineable.m.


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