APMonitor FV, MV, SV, CV Classification

Main.INFO History

Hide minor edits - Show changes to output

May 31, 2019, at 11:45 PM by 10.37.66.43 -
Changed line 18 from:
Fixed Values are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a fixed value or feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.
to:
Fixed Values or Feedforward Variables are model coefficients that change to fit process data or minimize an objective function.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a fixed value or feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.
Changed lines 7-12 from:
# Parameters list in model
## Feedforward Variables (FV)
## Manipulated Variables (MV)
# Variables list in model
## State Variables (SV)
## Controlled Variables (CV)
to:
* Parameters list in model
** Feedforward Variables (FV)
** Manipulated Variables (MV)
* Variables list in model
** State Variables (SV)
** Controlled Variables (CV)
Changed lines 5-12 from:
Parameters and variables can be specified as feedforward variables (FV), manipulated variables (MV), state variables (SV), and controlled variables (CV).  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.  The FV and MV types are specified from the available declared ''parameters''.  These are values that are fixed in steady-state calculations.  The SV and CV types are specified from the available declared ''variables''.  These are values that are calculated in steady-state calculations.

# Feedforward Variables (FV)
# Manipulated Variables
(MV)
# State Variables (SV)
# Controlled Variables (CV)

----
to:
Parameters and variables can be specified as feedforward variables (FV), manipulated variables (MV), state variables (SV), and controlled variables (CV).  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.  The FV and MV types are specified from the available declared ''parameters''.  These are values that are fixed in steady-state calculations.  The SV and CV types are specified from the available declared ''variables''.

# Parameters list in model
## Feedforward Variables (FV)
## Manipulated Variables (MV)
# Variables list in model
## State Variables
(SV)
## Controlled Variables (CV)
Changed lines 1-3 from:
!! INFO - Information File

The INFO file is used to specify special variables such
as feedforward variables (FV), manipulated variables (MV), state variables (SV), and controlled variables (CV).  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.  The FV and MV types are specified from the available declared ''parameters''.  These are values that are fixed in steady-state calculations.  The SV and CV types are specified from the available declared ''variables''.  These are values that are calculated in steady-state calculations.
to:
(:title APMonitor FV, MV, SV, CV Classification:)
(:keywords fixed value, manipulated variable, disturbance variable, state variable, controlled variable, model predictive control, configure:)
(:description Classify parameters and variables as a fixed value/disturbance (FV), manipulated variable (MV), state variable (SV), or controlled variable (CV):)

Parameters and variables can be specified
as feedforward variables (FV), manipulated variables (MV), state variables (SV), and controlled variables (CV).  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.  The FV and MV types are specified from the available declared ''parameters''.  These are values that are fixed in steady-state calculations.  The SV and CV types are specified from the available declared ''variables''.  These are values that are calculated in steady-state calculations.
January 16, 2013, at 05:27 PM by 128.187.97.21 -
Changed lines 14-19 from:
!!! Feedforward Variables (FVs)

Feedforward variables are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.

''F, model.parameter''
to:
!!! Fixed Values (FVs)

Fixed Values are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a fixed value or feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.

-> ''F, model.parameter''

If using either the MATLAB or Python interface, fixed values can also be declared with the apm_info function as:

-> ''apm_info(server,app,'FV','{parameter_name}')
''
Changed lines 32-33 from:
''M, model.parameter''
to:
-> ''M, model.parameter''

If using either the MATLAB or Python interface, manipulated variables can also be declared with the apm_info function as:

-> ''apm_info(server,app,'MV','{parameter_name}')
''
Changed lines 52-53 from:
''S, model.variable''
to:
-> ''S, model.variable''

If using either the MATLAB or Python interface, fixed values can also be declared with the apm_info function as:

-> ''apm_info(server,app,'SV','{variable_name}')
''
Changed lines 66-70 from:
''C, model.variable''
to:
-> ''C, model.variable''

If using either the MATLAB or Python interface, fixed values can also be declared with the apm_info function as:

-> ''apm_info(server,app,'CV','{variable_name}')
''
July 13, 2011, at 08:18 PM by 89.144.73.252 -
Added lines 22-23:
Attach:Info_FV.png
Added lines 32-33:
Attach:Info_MV.png
Added lines 48-49:
Attach:Info_SV.png
Added lines 57-58:

Attach:Info_CV.png
July 13, 2011, at 07:49 PM by 89.144.73.252 -
Changed lines 18-19 from:
''F, file.model.parameter''
to:
''F, model.parameter''
Changed lines 26-27 from:
''M, file.model.parameter''
to:
''M, model.parameter''
Changed lines 40-41 from:
''S, file.model.variable''
to:
''S, model.variable''
Changed lines 48-49 from:
''C, file.model.variable''
to:
''C, model.variable''
Changed lines 60-61 from:
!! Example File - test.info
to:
!! Methods for Creating the Info File

# Create new INFO file (text document) and populate manually with variable names
# Link variables to Info_FV, Info_MV, Info_SV, or Info_CV objects in the APM model file
.
# Select variable classifications from the web interface.

Attach:create_
info.png

!! Example INFO File

Changed lines 72-76 from:
 FV(1),      test.lags.u1
 MV(1),      test.lags.u2
 SV(1),      test.lags.x1
 CV(1),      test.lags.y1
 CV(2),      test.lags.y2
to:
 FV(1),      lags.u1
 MV(1),      lags.u2
 SV(1),      lags.x1
 CV(1),      lags.y1
 CV(2),      lags.y2
August 11, 2010, at 03:00 AM by 206.180.155.75 -
Changed lines 34-35 from:
Additional equations are added to the model for variables that have a measurement.  To avoid adding these extra equations for all SVs and CVs, the measurement equations are only added for those specially designated.  The designation for a measurement is the pound sign (#).  The pound sign appears after the variable classification letter.
to:
Additional equations are added to the model for variables that have a measurement.  To avoid adding these extra equations, the measurement equations are only added for those designated as Controlled Variables (CVs).  State Variables (SVs) are those variables which may be monitored but are not measured.
Changed lines 40-41 from:
''S{#}, file.model.variable''
to:
''S, file.model.variable''
Changed lines 48-49 from:
''C{#}, file.model.variable''
to:
''C, file.model.variable''
Changed lines 66-68 from:
 SV(1)#,      test.lags.x1
to:
 SV(1),       test.lags.x1
 CV(1),      test.lags.y1
 CV(2),      test.lags.y2
October 03, 2008, at 03:56 PM by 158.35.225.231 -
Added lines 34-35:
Additional equations are added to the model for variables that have a measurement.  To avoid adding these extra equations for all SVs and CVs, the measurement equations are only added for those specially designated.  The designation for a measurement is the pound sign (#).  The pound sign appears after the variable classification letter.
Changed lines 40-41 from:
''S, file.model.variable''
to:
''S{#}, file.model.variable''
Changed line 48 from:
''C, file.model.variable''
to:
''C{#}, file.model.variable''
October 03, 2008, at 03:16 PM by 158.35.225.231 -
Changed lines 54-65 from:
Every time a model simulation is executed, the INFO file is re-written.  The parameters and variables are rearranged into the order that they appear in the model file.  They are also given a number and non-existent parameters or variables are eliminated from the list.
to:
Every time a model simulation is executed, the INFO file is re-written.  The parameters and variables are rearranged into the order that they appear in the model file.  They are also given a number and non-existent parameters or variables are eliminated from the list.

----

!! Example File - test.info

(:table border=1 width=50% align=left bgcolor=#EEEEEE cellspacing=0:)
(:cellnr:)
 FV(1),      test.lags.u1
 MV(1),      test.lags.u2
 SV(1)#,      test.lags.x1
(:tableend:)
October 01, 2008, at 03:31 PM by 158.35.225.229 -
Changed line 46 from:
''C, file.model.parameter''
to:
''C, file.model.variable''
October 01, 2008, at 03:31 PM by 158.35.225.229 -
Changed lines 12-15 from:
!!! Parameters

!!!! Feedforward Variables
to:
!! Parameters

!!! Feedforward Variables (FVs)
Changed lines 22-23 from:
!!!! Manipulated Variables
to:
!!! Manipulated Variables (MVs)
Changed lines 32-49 from:
!!! Variables

!!!! Feedforward Variables

Feedforward variables
are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.

''F, file.model.parameter''

For time-varying simulations, the FVs
are constant over the time horizon.

!!!! Manipulated Variables

Manipulated variables are decision variables for an estimator or controller.  These decision variables are adjusted by the optimizer to minimize an objective function.  A parameter is indicated as a manipulated variable by including a line in the INFO file with an ''M'' and
the parameter name, separated by a comma.

''M, file.model.parameter''

For time-varying simulations, the MVs
change over the time horizon.
to:
!! Variables

!!! State Variables (SVs)

States
are model variables that may be measured or are of special interest for observation.  A variable is indicated as a state by including a line in the INFO file with an ''S'' and the variable name, separated by a comma.

''S, file.model.variable''

For time-varying simulations
, the SVs change over the time horizon.

!!! Controlled Variables (CVs)

Controlled variables
are model variables that are included in the objective of a controller or optimizer.  These variables are controlled to a range, maximized, or minimized.  Controlled variables may also be measured values that are included for data reconciliation.  A variable is indicated as controlled by including a line in the INFO file with a ''C'' and the variable name, separated by a comma.

''C, file.model.parameter''

For time-varying simulations, the CVs
change over the time horizon.
Changed line 52 from:
!!! INFO File Refresh
to:
!! INFO File Refresh
October 01, 2008, at 03:23 PM by 158.35.225.229 -
Changed lines 1-2 from:
!! INFO Information File
to:
!! INFO - Information File
Deleted line 4:
* Parameter-type
Deleted line 6:
* Variable-type
Added lines 10-11:
----
Changed lines 14-17 from:
!!! Feedforward Variables

Feedforward variables are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A variable is indicated as a feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.
to:
!!!! Feedforward Variables

Feedforward variables are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.
Changed lines 20-21 from:
!!! Manipulated Variables
to:
For time-varying simulations, the FVs are constant over the time horizon.

!!!! Manipulated Variables

Manipulated variables are decision variables for an estimator or controller.  These decision variables are adjusted by the optimizer to minimize an objective function.  A parameter is indicated as a manipulated variable by including a line in the INFO file with an ''M'' and the parameter name, separated by a comma.

''M, file.model.parameter''

For time-varying simulations, the MVs change over the time horizon.

----

!!! Variables

!!!! Feedforward Variables

Feedforward variables are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A parameter is indicated as a feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.

''F, file.model.parameter''

For time-varying simulations, the FVs are constant over the time horizon.

!!!! Manipulated Variables

Manipulated variables are decision variables for an estimator or controller.  These decision variables are adjusted by the optimizer to minimize an objective function.  A parameter is indicated as a manipulated variable by including a line in the INFO file with an ''M'' and the parameter name, separated by a comma.

''M, file.model.parameter''

For time-varying simulations, the MVs change over the time horizon.

----

!!! INFO File Refresh

Every time a model simulation is executed, the INFO file is re-written.  The parameters and variables are rearranged into the order that they appear in the model file.  They are also given a number and non-existent parameters or variables are eliminated from the list.
October 01, 2008, at 03:13 PM by 158.35.225.229 -
Changed lines 3-4 from:
The INFO file is used to specify special variables such as feedforward variables, manipulated variables, state variables, and controlled variables.  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.
to:
The INFO file is used to specify special variables such as feedforward variables (FV), manipulated variables (MV), state variables (SV), and controlled variables (CV).  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.  The FV and MV types are specified from the available declared ''parameters''.  These are values that are fixed in steady-state calculations.  The SV and CV types are specified from the available declared ''variables''.  These are values that are calculated in steady-state calculations.
Changed lines 6-7 from:
## Feedforward Variables (FV)
## Manipulated Variables (MV)
to:
# Feedforward Variables (FV)
# Manipulated Variables (MV)
Changed lines 9-10 from:
## State Variables (SV)
## Controlled Variables (CV)
to:
# State Variables (SV)
# Controlled Variables (CV)
October 01, 2008, at 03:10 PM by 158.35.225.229 -
Added lines 1-21:
!! INFO Information File

The INFO file is used to specify special variables such as feedforward variables, manipulated variables, state variables, and controlled variables.  These are 4 basic types of variables that are used in the %blue%A%red%P%black%Monitor simulations.

* Parameter-type
## Feedforward Variables (FV)
## Manipulated Variables (MV)
* Variable-type
## State Variables (SV)
## Controlled Variables (CV)

!!! Parameters

!!! Feedforward Variables

Feedforward variables are model coefficients that change to fit process data.  These parameters can change the behavior and structure of the model.  A variable is indicated as a feedforward variable by including a line in the INFO file with an ''F'' and the variable name, separated by a comma.

''F, file.model.parameter''

!!! Manipulated Variables