Main

!! Model Form

%blue%A%red%P%black%Monitor allows empirical or first-principles modeling. In most cases a seamless integration of the two types of modeling approaches is most effective.

!!! Empirical Modeling

Empirical models have a generic and flexible model form that can fit many physical phenomena without a fundamental understanding of the process. This allows a non-process expert to derive a predictive model for simulation, estimation, or control. Empirical models are often numerically less expensive to solve and train. While increasing the number of model parameters leads to a better fit of the data, there is often poor extrapolation outside of the training region.

!!! Fundamental Modeling

Fundamental modeling of many physical systems can be described with differential and algebraic equations (DAEs). When used in predictive analytics, these models can have a much wider range of accuracy than empirical models. Although sometimes difficult to construct, parts of a fundamental model can be reused in similar applications. The ability to re-use fundamental models is because the underlying model structure is based on fundamentals that do not change from application to application.
~~When there are more variables than equations, there is an opportunity to minimize an objective. This is often posed in economic terms to minimize cost or maximize profits. The objective function is composed of specially designated variables known as objective variables.~~

## Model Structure

## Main.ModelStructure History

Hide minor edits - Show changes to output

Added lines 21-22:

----

Added lines 35-36:

----

Added line 58:

----

Added lines 20-31:

!! Model Form

%blue%A%red%P%black%Monitor allows empirical or first-principles modeling. In most cases a seamless integration of the two types of modeling approaches is most effective.

!!! Empirical Modeling

Empirical models have a generic and flexible model form that can fit many physical phenomena without a fundamental understanding of the process. This allows a non-process expert to derive a predictive model for simulation, estimation, or control. Empirical models are often numerically less expensive to solve and train. While increasing the number of model parameters leads to a better fit of the data, there is often poor extrapolation outside of the training region.

!!! Fundamental Modeling

Fundamental modeling of many physical systems can be described with differential and algebraic equations (DAEs). When used in predictive analytics, these models can have a much wider range of accuracy than empirical models. Although sometimes difficult to construct, parts of a fundamental model can be reused in similar applications. The ability to re-use fundamental models is because the underlying model structure is based on fundamentals that do not change from application to application.

Changed lines 25-28 from:

(:table ~~class~~=~~'markup horiz' align~~=~~'~~left~~':)~~

(:cellnr class=~~'markup1'~~:)

~~>>blue<<~~

[@Model example

(:cellnr class

[@

to:

(:table border=1 width=50% align=left bgcolor=#EEEEEE cellspacing=0:)

(:cellnr:)

Model example

(:cellnr:)

Model example

Changed lines 39-40 from:

End ~~Model@]~~

>><<

>><<

to:

End Model

Added line 41:

Changed lines 23-25 from:

The model is stored in a text file with an extension ''.apm''. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required. In this case the model name ''example'' is chosen. In the following documentation, anything that begins with a capital letter is a system keyword while lower case ~~letters~~ can be modified by the user.

(:table class='markup horiz' align='~~center~~':)

(:table class='markup horiz' align='

to:

The model is stored in a text file with an extension ''.apm''. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required. In this case the model name ''example'' is chosen. In the following documentation, anything that begins with a capital letter is a system keyword while lower case words can be modified by the user.

(:table class='markup horiz' align='left':)

(:table class='markup horiz' align='left':)

Changed lines 23-24 from:

The model is stored in a text file with an extension ''.apm'. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required. In this case the model name ''example'' is chosen. In the following documentation, anything that begins with a capital letter is a system keyword while lower case letters can be modified by the user.

to:

The model is stored in a text file with an extension ''.apm''. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required. In this case the model name ''example'' is chosen. In the following documentation, anything that begins with a capital letter is a system keyword while lower case letters can be modified by the user.

Changed line 28 from:

Model example

to:

[@Model example

Changed line 40 from:

End ~~Model~~

to:

End Model@]

Added lines 25-26:

(:table class='markup horiz' align='center':)

(:cellnr class='markup1':)

(:cellnr class='markup1':)

Added lines 44-46:

(:tableend:)

Added line 24:

Changed lines 26-27 from:

[@Model example

to:

[@

Model example

Model example

Changed lines 39-40 from:

End Model@]

to:

End Model

@]

@]

Changed lines 23-26 from:

The model is stored in a text file with an extension ''.apm'. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required.

!!!

!!!

to:

The model is stored in a text file with an extension ''.apm'. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required. In this case the model name ''example'' is chosen. In the following documentation, anything that begins with a capital letter is a system keyword while lower case letters can be modified by the user.

Changed lines 25-26 from:

[@

Model~~''example''~~

Model

to:

[@Model example

Changed lines 37-38 from:

End Model

@]

to:

End Model@]

>><<

>><<

Changed lines 1-2 from:

!! ~~The %blue%A%red%P%black%Monitor Model File~~

to:

!! Parameters, Variables, and Equations

Changed lines 19-41 from:

to:

When there are more variables than equations, there is an opportunity to minimize an objective. This is often posed in economic terms to minimize cost or maximize profits. The objective function is composed of specially designated variables known as objective variables.

!! Basic Model Structure

The model is stored in a text file with an extension ''.apm'. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required.

!!!

>>blue<<

[@

Model ''example''

Parameters

! include parameters here

End Parameters

Variables

! include variables here

End Variables

Equations

! include equations here

End Equations

End Model

!! Basic Model Structure

The model is stored in a text file with an extension ''.apm'. Comments characters include exclamation mark (!), percent sign (%), and pound sign (#). Comments can be placed at any location in the file and will be ignored during run time. Model indentation is encouraged to improve readability of the file, but is not required.

!!!

>>blue<<

[@

Model ''example''

Parameters

! include parameters here

End Parameters

Variables

! include variables here

End Variables

Equations

! include equations here

End Equations

End Model

Added lines 3-19:

A basic model consists of parameters, variables, and equations. Equations consist of a collection of parameters and variables that are related by operands (+,-,*,/,exp(),d()/dt, etc.). Parameters are fixed values that represent model inputs, fixed constants, or any other value that does not change. Variables, on the other hand, are adjusted to satisfy equation expressions.

The degrees of freedom is defined by the number of variables minus the number of equations.

DOF = n'_var_' - n'_eqn_'

!!! Square problems (DOF = 0)

When a problem has the same number of variables and equations, it is referred to as a square problem. Square problems are often easier to solve because the solver only has to achieve feasibility to terminate successfully.

!!! Over-specified problems (DOF < 0)

When there are more equations than variables, the problem is termed as an over-specified problem. An error indicates that there are too few degrees of freedom.

!!! Under-specified problems (DOF > 0)

When there are more variables than equations, there is an opportunity to minimize an objective. This is often posed in economic terms to minimize cost or maximize profits. The objective function is composed of specially designated variables known as objective variables.

The degrees of freedom is defined by the number of variables minus the number of equations.

DOF = n'_var_' - n'_eqn_'

!!! Square problems (DOF = 0)

When a problem has the same number of variables and equations, it is referred to as a square problem. Square problems are often easier to solve because the solver only has to achieve feasibility to terminate successfully.

!!! Over-specified problems (DOF < 0)

When there are more equations than variables, the problem is termed as an over-specified problem. An error indicates that there are too few degrees of freedom.

!!! Under-specified problems (DOF > 0)

When there are more variables than equations, there is an opportunity to minimize an objective. This is often posed in economic terms to minimize cost or maximize profits. The objective function is composed of specially designated variables known as objective variables.