KerMor  0.9
Model order reduction for nonlinear dynamical systems and nonlinear approximation
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
models.beam.DynLinTimoshenkoModel Class Reference

DynLinTimoshenkoModel: More...

Detailed Description

DynLinTimoshenkoModel:

Author
Daniel Wirtz
Date
2011-09-20
New in 0.5:
(Daniel Wirtz, 2011-09-20) Added this class.

This class is part of the framework

KerMor - Model Order Reduction using Kernels

Definition at line 19 of file DynLinTimoshenkoModel.m.

Public Member Functions

 DynLinTimoshenkoModel (char cfgfile,logical nonlinear)
 Creates a new timoshenko model. More...
 
function  exportGeometry (handle f,char folder,export.JaRMoSExport export)
 Exports the model geometry to JKerMor. More...
 
function  plot (rowvec t,matrix u)
 plot: Plots the current displacements and heat (u = 4 x numNodes x timesteps matrix) More...
 
function  plotSingle (double t,colvec u,handle h)
 plot_single: Plots a single beam configuration for given time and field data. More...
 
- Public Member Functions inherited from models.BaseFullModel
 BaseFullModel (char name)
 Creates a new instance of a full model. More...
 
function  delete ()
 
function  off1_createParamSamples ()
 Offline phase 1: Sample generation. More...
 
function  off2_genTrainingData ()
 Offline phase 2: Snapshot generation for subspace computation. More...
 
function  off3_computeReducedSpace ()
 Offline phase 3: Generate state space reduction. More...
 
function  off4_genApproximationTrainData ()
 Generates the training data \(x_i\) for the \(\hat{f}\)-approximation and precomputes \(f(x_i)\) values. More...
 
function  off5_computeApproximation ()
 Offline phase 5: Core function approximation. More...
 
function  off6_prepareErrorEstimator ()
 Prepares offline data for a possible error estimator. More...
 
function  offlineGenerations ()
 Performs all large offline computations for model reduction. More...
 
function [ models.ReducedModel
reduced , double time ] = 
buildReducedModel (varargin)
 Builds a reduced model from a full model. More...
 
function [ t ,
x ,
time ,
cache ] = 
computeTrajectory (colvec< double > mu, inputidx)
 Computes a solution/trajectory for the given mu and inputidx in the SCALED state space. More...
 
function [ double t , matrix< double > y ,
colvec
< double > mu ,
in ,
ct ] = 
getSimCacheTrajectory (nr)
 
function  plotTrajectoryNr (nr)
 
function [ V ,
W ] = 
assembleProjectionMatrices (target_dim)
 
function file = save (char directory,char filename)
 Saves this instance inside the data.ModelData.DataDirectory folder using the model's SaveTag if set or "model.mat". More...
 
- Public Member Functions inherited from models.BaseModel
 BaseModel ()
 
function  delete ()
 
function  initDefaultParameter ()
 Reads the default values of the System's ModelParam list and initializes the BaseModel.DefaultMu with it. More...
 
function [ rowvec< double > t ,
matrix
< double > y , double sec ,
x ] = 
simulate (colvec< double > mu,integer inputidx)
 Simulates the system and produces the system's output. More...
 
function [ handle f , handle ax ] = plot (rowvec< double > t,matrix< double > y, varargin)
 Plots the results of the simulation. Override in subclasses for a more specific plot if desired. More...
 
function [ handle f , handle ax ] = plotState (rowvec t,matrix< double > x, varargin)
 Plots the results of the simulation. Override in subclasses for a more specific plot if desired. More...
 
function [ f ,
ax ] = 
plotSingle (double t,colvec< double > y, varargin)
 Plots a single solution. Override in subclasses for specific plot behaviour. More...
 
function  plotInputs (pm)
 
function [ double t , colvec< double > x ,
double
ctime ] = 
solveStatic (colvec< double > mu,integer inputidx)
 Solves the linear system \(A(t,\mu)*x + f(t,\mu) + B(t,\mu)*u(t) = 0\). Spatial dependence of f is neglected in the current implementation (since this would require solving a nonlinear system). More...
 
function [ rowvec< double > t ,
matrix
< double > x , double ctime ] = 
computeTrajectory (colvec< double > mu,integer inputidx)
 Computes a solution/trajectory for the given mu and inputidx in the SCALED state space. More...
 
function matrix
< double > mu = 
getRandomParam (integer num,integer seed)
 Gets a random parameter sample from the system's parameter domain P. More...
 
- Public Member Functions inherited from KerMorObject
 KerMorObject ()
 Constructs a new KerMor object. More...
 
function  display ()
 disp(object2str(this)); More...
 
function bool = eq (B)
 Checks equality of two KerMor objects. More...
 
function bool = ne (B)
 Checks if two KerMorObjects are different. More...
 
function cn = getClassName ()
 Returns the simple class name of this object without packages. More...
 
- Public Member Functions inherited from DPCMObject
 DPCMObject ()
 Creates a new DPCM object. More...
 
 DPCMObject ()
 

Static Public Member Functions

static function  experiment1 ()
 
static function  test_TimoshenkoModel ()
 Linear. More...
 
- Static Public Member Functions inherited from models.BaseFullModel
static function  test_BaseModels ()
 
static function res = test_BareModel ()
 
static function  test_LinearModel ()
 
static function  test_LinearModelNoProj ()
 
static function  test_LinearModelNoApprox ()
 
static function  test_LinearModelParams ()
 
static function  test_LinearModelInputs ()
 
static function  test_LinearModelParamsInput ()
 
static function  test_NonlinearModel ()
 
static function  test_NonlinearModelParams ()
 
static function  test_NonlinearModelInputs ()
 
static function  test_NonlinearModelParamsInput ()
 
static function  test_TimeDependentOutput ()
 
static function res = test_FileSystemTidyness ()
 Plain small model. More...
 

Public Attributes

double PlotFactor = 20
 Plot enhancement factor. More...
 
double BeamLineWidth = 3
 The beam line width for plotting. More...
 
integer NumColors = 128
 Number of colors for plotting. More...
 
 BeamRefinementFactor
 
 CurvedBeamRefinementFactor
 
matrix Points
 3D coordinates of the beam end points More...
 
struct Elements
 Cell array of all model structure elements. More...
 
logical NonlinearModel = false
 Flag that indicates if the nonlinear model is used. More...
 
 Supports
 
 Loads
 
 Materials
 
char ConfigFile
 The configuration file used for this model. More...
 
 data
 
 f_neum
 Vector for neumann boundary conditions. More...
 
 dir_u
 
 dir_T
 
 free
 The indices in the global state space vector of all points including dirichlet points (dim=7: 3location, 3velocity & heat) More...
 
 u_dir
 Extracted Dirichlet values full u vector (using dir_u) More...
 
matrix ColorMap
 The color map to use. Value is hardcoded so far. More...
 
 maxTemp = 0
 Maximum temperature for plotting. More...
 
 minTemp = 0
 Maximum temperature for plotting. More...
 
 cbh
 ColorBar handle. More...
 
 RO_raw
 
 KR_raw
 
 FH_raw
 
 RO_factor_global = 1
 
 KR_factor_global = 1
 
- Public Attributes inherited from models.BaseFullModel
data.ModelData Data
 The full model's data container. Defaults to an empty container. More...
 
export.JKerMorExport JKerMorExport
 Export instance for possible export of this model to JKerMor. More...
 
sampling.BaseSampler Sampler
 The sampling strategy the Model uses. More...
 
spacereduction.BaseSpaceReducer SpaceReducer
 The reduction algorithm for subspaces. More...
 
approx.BaseApprox Approx = "[]"
 The approximation method for the CoreFunction. More...
 
function_handle preApproximationTrainingCallback
 Advanced property. Must be a function handle taking the current model instance. More...
 
function_handle postApproximationTrainingCallback
 Advanced property. Must be a function handle taking the current model instance. More...
 
logical EnableTrajectoryCaching = false
 Flag that enables caching of computed trajectories in a simulation cache stored in KerMor's TempDirectory folder. More...
 
error.BaseEstimator ErrorEstimator = "[]"
 The associated error estimator for this model. More...
 
logical ComputeTrajectoryFxiData = false
 Flag that determines whether fxi data should be computed along with the trajectories or not. More...
 
logical ProjectApproxTrainingData = false
 Flag to determine if the data collected by the approx.Approx.TrainDataSelector should be projected into the previously computed projection space V (see offline phase 3). If so, the \(f(x_i)\) values are also re-computed for the updated \(x_i\) samples. More...
 
logical AutoSave = false
 Flag to enable automatic saving of the model after each individual offline phase step and at other locations prone to data loss due to lengthy computations. More...
 
char SaveTag = ""
 A custom tag that can be used as a prefix to files for corresponding model identification. More...
 
integer TrainingInputs
 The indices of inputs to use for training data generation. Uses the DefaultInput if not set (and DefaultInput is not empty) More...
 
rowvec< integerTrainingParams
 The indices of the model parameters to use for training data generation. More...
 
integer TrainingInputCount
 Gets the number of inputs used for training. More...
 
rowvec< doubleOfflinePhaseTimes = "[]"
 The computation times for all phases of the last offline generation. More...
 
 TrajectoriesCompleted = "[]"
 Contains a flag for each input/parameter combination which has been successfully computed completely during the offline phase. More...
 
- Public Attributes inherited from models.BaseModel
models.BaseFirstOrderSystem System = "[]"
 The actual dynamical system used in the model. More...
 
char Name = ""
 The name of the Model. More...
 
matrix< doubleG = 1
 The custom scalar product matrix \(\vG\). More...
 
double RealTimePlottingMinPause = .1
 Minimum pause between successive steps when RealTimePlotting is enabled. More...
 
logical isStatic = false
 Determines if the model is time dependent or static. More...
 
integer DefaultInput = "[]"
 The default input to use if none is given. More...
 
 Times
 Evaluation points \(\{0=t_0,\ldots,t_n=T\}\) of the model. More...
 
rowvec< doublescaledTimes
 The time steps Times in scaled time units \(\tilde{t_i} = \frac{t_i}{\tau}\). More...
 
double Tscaled
 The scaled end time \(\tilde{T} = \frac{T}{\tau}\). More...
 
double tau
 Time scaling factor \(\tau\). More...
 
double T
 The final timestep \(T\) up to which to simulate. More...
 
double dt
 The desired time-stepsize \(\Delta t\) for simulations. More...
 
solvers.BaseSolver ODESolver
 The solver to use for the ODE. Must be an instance of any solvers.BaseSolver subclass. More...
 
logical RealTimePlotting
 Determines if the simulation should plot intermediate steps during computation. More...
 
colvec< doubleDefaultMu = "[]"
 The default parameter value if none is given. More...
 
 dtscaled = .1
 The scaled timestep \(\tilde{\Delta t} = \frac{\Delta t}{\tau}\). More...
 
char gitRefOnSave = ""
 Contains the GIT revision of this model when it was last saved. More...
 
- Public Attributes inherited from DPCMObject
 WorkspaceVariableName = ""
 The workspace variable name of this class. Optional. More...
 
 ID = "[]"
 An ID that allows to uniquely identify this DPCMObject (at least within the current MatLab session/context). More...
 
 PropertiesChanged = "[]"
 The Dictionary containing all the property settings as key/value pairs. More...
 
- Public Attributes inherited from handle
 addlistener
 Creates a listener for the specified event and assigns a callback function to execute when the event occurs. More...
 
 notify
 Broadcast a notice that a specific event is occurring on a specified handle object or array of handle objects. More...
 
 delete
 Handle object destructor method that is called when the object's lifecycle ends. More...
 
 disp
 Handle object disp method which is called by the display method. See the MATLAB disp function. More...
 
 display
 Handle object display method called when MATLAB software interprets an expression returning a handle object that is not terminated by a semicolon. See the MATLAB display function. More...
 
 findobj
 Finds objects matching the specified conditions from the input array of handle objects. More...
 
 findprop
 Returns a meta.property objects associated with the specified property name. More...
 
 fields
 Returns a cell array of string containing the names of public properties. More...
 
 fieldnames
 Returns a cell array of string containing the names of public properties. See the MATLAB fieldnames function. More...
 
 isvalid
 Returns a logical array in which elements are true if the corresponding elements in the input array are valid handles. This method is Sealed so you cannot override it in a handle subclass. More...
 
 eq
 Relational functions example. See details for more information. More...
 
 transpose
 Transposes the elements of the handle object array. More...
 
 permute
 Rearranges the dimensions of the handle object array. See the MATLAB permute function. More...
 
 reshape
 hanges the dimensions of the handle object array to the specified dimensions. See the MATLAB reshape function. More...
 
 sort
 ort the handle objects in any array in ascending or descending order. More...
 
- Public Attributes inherited from IParallelizable
 ComputeParallel = false
 Flag whether the code should be run in parallel or not. More...
 

Static Public Attributes

static const  withHeat = false
 No heat modeling at the current stage. More...
 

Additional Inherited Members

- Protected Member Functions inherited from models.BaseModel
function this = saveobj ()
 Store the current GIT branch in the object. More...
 
function  plotstep (src, ed)
 Callback for the ODE solvers StepPerformed event that enables during-simulation-plotting. More...
 
- Protected Member Functions inherited from KerMorObject
function  checkType (obj, type)
 Object typechecker. More...
 
- Protected Member Functions inherited from DPCMObject
function  registerProps (varargin)
 Call this method at any class that defines DPCM observed properties. More...
 
function  registerProps (varargin)
 
- Static Protected Member Functions inherited from models.BaseFullModel
static function this = loadobj (this, sobj)
 
- Static Protected Member Functions inherited from models.BaseModel
static function this = loadobj (this, s)
 
- Static Protected Member Functions inherited from DPCMObject
static function obj = loadobj (obj, from)
 Re-register any registered change listeners! More...
 
static function obj = loadobj (obj, from)
 

Constructor & Destructor Documentation

models.beam.DynLinTimoshenkoModel.DynLinTimoshenkoModel ( char  cfgfile,
logical  nonlinear 
)

Creates a new timoshenko model.

Parameters
cfgfileThe configuration file for the beams. Default: Simpel1.txt
nonlinearFlag to indicate if the linear or nonlinear model should be used. Default: false

Definition at line 287 of file DynLinTimoshenkoModel.m.

References models.BaseFullModel.Approx, ConfigFile, models.BaseFullModel.Data, models.BaseModel.dt, exportGeometry(), FH_raw, models.BaseFirstOrderSystem.InputCount, models.BaseFullModel.JKerMorExport, KR_raw, Loads, Materials, models.BaseModel.Name, NonlinearModel, models.BaseModel.ODESolver, Points, RO_raw, models.BaseFullModel.Sampler, models.BaseFullModel.SpaceReducer, Supports, models.BaseModel.System, models.BaseModel.T, models.BaseFullModel.TrainingInputs, and data.ModelData.useFileTrajectoryData().

Here is the call graph for this function:

Member Function Documentation

static function models.beam.DynLinTimoshenkoModel.experiment1 ( )
static

Definition at line 509 of file DynLinTimoshenkoModel.m.

References models.BaseFullModel.save().

Here is the call graph for this function:

function models.beam.DynLinTimoshenkoModel.exportGeometry ( handle  f,
char  folder,
export.JaRMoSExport  export 
)

Exports the model geometry to JKerMor.

To be done

Parameters
fA file handle to write the model xml
folderThe target folder
exportThe exporter instance.
Required fields of export:

Definition at line 384 of file DynLinTimoshenkoModel.m.

References dir_u, Elements, Points, handle.reshape, t, and u_dir.

Referenced by DynLinTimoshenkoModel().

Here is the caller graph for this function:

function models.beam.DynLinTimoshenkoModel.plot ( rowvec  t,
matrix  u 
)

plot: Plots the current displacements and heat (u = 4 x numNodes x timesteps matrix)

Author
Daniel Wirtz
Date
2011-09-28
New in 0.5:
(Daniel Wirtz, 2011-09-28) Added this function.

This class is part of the framework

KerMor - Model Order Reduction using Kernels
Parameters
tThe times \(t_i\)
uThe displacement and heat value matrix, with entry \(u_i\) in column \(i\) of \(u\).

Definition at line 20 of file plot.m.

References t.

function models.beam.DynLinTimoshenkoModel.plotSingle ( double  t,
colvec  u,
handle  h 
)

plot_single: Plots a single beam configuration for given time and field data.

Author
Daniel Wirtz
Date
2011-09-28
New in 0.5:
(Daniel Wirtz, 2011-09-28) Added this function.

This class is part of the framework

KerMor - Model Order Reduction using Kernels
Parameters
tThe times \(t\)
uThe displacement and heat values at \(t\)
hThe axes handle to plot to.

Definition at line 20 of file plotSingle.m.

References t.

function models.beam.DynLinTimoshenkoModel.test_TimoshenkoModel ( )
static

Linear.

Definition at line 527 of file DynLinTimoshenkoModel.m.

References t.

Member Data Documentation

models.beam.DynLinTimoshenkoModel.BeamLineWidth = 3

The beam line width for plotting.

Property class optional:
Visualization setting

Default: 3

Note
This property has the MATLAB attribute SetObservable set to true.
Matlab documentation of property attributes.

Definition at line 68 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.BeamRefinementFactor

Definition at line 102 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.cbh

ColorBar handle.

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 259 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.ColorMap

The color map to use. Value is hardcoded so far.

col = colormap(hot); Eigene Colormap erstellen (num_col Farben) blau -> gr�n -> rot num_col = 128; dc = [0:2/num_col:1]'; col = [0*dc dc 1-dc; dc 1-dc 0*dc]; blau -> gr�n -> gelb -> rot

Note
This property has the MATLAB attribute Dependent set to true.
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.
[readonly]

Definition at line 219 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.ConfigFile

The configuration file used for this model.

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 162 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.CurvedBeamRefinementFactor

Definition at line 105 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.data

Definition at line 175 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.dir_T

Definition at line 191 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.dir_u

Definition at line 189 of file DynLinTimoshenkoModel.m.

Referenced by exportGeometry().

models.beam.DynLinTimoshenkoModel.Elements

Cell array of all model structure elements.

Fields
p: The index of the start and end point of the beam, defined in property Points.
Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 123 of file DynLinTimoshenkoModel.m.

Referenced by exportGeometry().

models.beam.DynLinTimoshenkoModel.f_neum

Vector for neumann boundary conditions.

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 178 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.FH_raw

Definition at line 276 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.free

The indices in the global state space vector of all points including dirichlet points (dim=7: 3location, 3velocity & heat)

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 194 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.KR_factor_global = 1

Definition at line 282 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.KR_raw

Definition at line 273 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.Loads

Definition at line 156 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.Materials

Definition at line 159 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.maxTemp = 0

Maximum temperature for plotting.

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.
Default: 0

Definition at line 235 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.minTemp = 0

Maximum temperature for plotting.

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.
Default: 0

Definition at line 247 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.NonlinearModel = false

Flag that indicates if the nonlinear model is used.

Default: false

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 140 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.NumColors = 128

Number of colors for plotting.

Property class optional:

Default: 128

See Also
ColorMap
Note
This property has the MATLAB attribute SetObservable set to true.
Matlab documentation of property attributes.

Definition at line 83 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.PlotFactor = 20

Plot enhancement factor.

Property class optional:
Scales the displacement

Default: 1

Note
This property has the MATLAB attribute SetObservable set to true.
Matlab documentation of property attributes.

Definition at line 53 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.Points

3D coordinates of the beam end points

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 110 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel(), and exportGeometry().

models.beam.DynLinTimoshenkoModel.RO_factor_global = 1

Definition at line 279 of file DynLinTimoshenkoModel.m.

models.beam.DynLinTimoshenkoModel.RO_raw

Definition at line 270 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.Supports

Definition at line 153 of file DynLinTimoshenkoModel.m.

Referenced by DynLinTimoshenkoModel().

models.beam.DynLinTimoshenkoModel.u_dir

Extracted Dirichlet values full u vector (using dir_u)

Note
This property has non-standard access specifiers: SetAccess = Private, GetAccess = Public
Matlab documentation of property attributes.

Definition at line 206 of file DynLinTimoshenkoModel.m.

Referenced by exportGeometry().

models.beam.DynLinTimoshenkoModel.withHeat = false
static

No heat modeling at the current stage.


Default: false

Definition at line 42 of file DynLinTimoshenkoModel.m.


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