## APMonitor FV, MV, SV, CV Classification

## Main.INFO History

Hide minor edits - Show changes to markup

- Parameters list in model
- Feedforward Variables (FV)
- Manipulated Variables (MV)

- Variables list in model
- State Variables (SV)
- Controlled Variables (CV)

- Parameters list in model
- Feedforward Variables (FV)
- Manipulated Variables (MV)

- Variables list in model
- State Variables (SV)
- Controlled Variables (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 APMonitor 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)

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 APMonitor 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)

## 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 APMonitor 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.

(: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 APMonitor 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 (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*

### 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}')*

*M, model.parameter*

*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}')*

*S, model.variable*

*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}')*

*C, model.variable*

*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}')*

*F, file.model.parameter*

*F, model.parameter*

*M, file.model.parameter*

*M, model.parameter*

*S, file.model.variable*

*S, model.variable*

*C, file.model.variable*

*C, model.variable*

## Example File - test.info

## 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.

## Example INFO File

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

FV(1), lags.u1 MV(1), lags.u2 SV(1), lags.x1 CV(1), lags.y1 CV(2), lags.y2

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.

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.

*S{#}, file.model.variable*

*S, file.model.variable*

*C{#}, file.model.variable*

*C, file.model.variable*

SV(1)#, test.lags.x1

SV(1), test.lags.x1 CV(1), test.lags.y1 CV(2), test.lags.y2

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.

*S, file.model.variable*

*S{#}, file.model.variable*

*C, file.model.variable*

*C{#}, file.model.variable*

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.

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:)

*C, file.model.parameter*

*C, file.model.variable*

### Parameters

#### Feedforward Variables

## Parameters

### Feedforward Variables (FVs)

#### Manipulated Variables

### Manipulated Variables (MVs)

### 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.

## 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.

### INFO File Refresh

## INFO File Refresh

## INFO Information File

## INFO - Information File

- Parameter-type

- Variable-type

### 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.

#### 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.

### Manipulated Variables

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

*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.

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 APMonitor simulations.

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 APMonitor 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)

- Feedforward Variables (FV)
- Manipulated Variables (MV)

- State Variables (SV)
- Controlled Variables (CV)

- State Variables (SV)
- Controlled Variables (CV)

## 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 APMonitor 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*