One of the most important factors in efficient and reliable solution of dynamic systems is the model formulation. Changes in model formulation are not intended to change the equations, only to put them into a form that allows solvers to more easily find an accurate solution. In each section below are some of the key strategies related to model creation and formulation. The discussion begins with a basic introduction to the APMonitor Modeling Language.

Models consist of sections including constants, parameters, variables, intermediates, equations, objects, and connections. All expressions used in the equations section must be created in one of the prior sections. The initialization of individual parameters or variables is sequential in the order that they are listed in the model file. Equations, however, can be listed in any order because equations are solved simultaneously.

**Constants**are values that never change. Integer values may be defined to give sizes to arrays (See additional details on constants).**Parameters**are values that are nominally fixed at initial values but can be changed with input data, by the user, or can become calculated by the optimizer to minimize an objective function if they are indicated as decision variables (See additional details on parameters).**Variables**are always calculated values as determined by the set of equations. Some variables are either measured and/or controlled to a desired target value (See additional details on variables).**Intermediates**are explicit equations where the variable is set equal to an expression that may include constants, parameters, variables, or other intermediate values that are defined previously. Intermediates are not implicit equations but are explicitly calculated with each model function evaluation (See additional details on intermediates).**Equations**are either equality constraints as*f(dx/dt,x,p)=0*, inequality constraints as*g(dx/dt,x,p)>0*, or expression of the objective with statements that begin with keywords*maximize*or*minimize*(See additional details on equations).**Objects**are object-oriented extensions of APMonitor that are stand-alone models that are instantiated from parent objects. The children objects may include parameters, variables, equations, and objective terms (See additional details on objects).**Connections**are equality constraints that relate object variables to model parameter or variables from other models (See additional details on connections).

There is an additional optional designation of parameters as either fixed values (*FVs*) or manipulated variables (*MVs*). Variables can be optionally designated as state variables (SVs) or controlled variables (*CVs*). The terminology of *FV, MV, SV,* and *CV* is from the process systems engineering community. In this community the *MVs* are designated as the inputs that are potentially changed by the controller and *CVs* are model outputs that are driven to target conditions. The terms *FVs* refer to either measured or unmeasured disturbances to the system and *SVs* are simply designated for viewing purposes as variables of importance. These parameter and variable classifications are specified in MATLAB or Python scripts (See additional details on FV, MV, SV, and CV classification).

Collections of constants, parameters, variables, intermediates, equations, objects, and connections constitute a model. The model file is created and stored in a text file with extension *apm*. Several text editors are available that support syntax highlighting such as Notepad++ and gEdit (see installation instructions). Below is an example model that demonstrates the use of many of these sections to create a 5th order differential equation model.

! input (1) = u ! states (5) = x[1] to x[5] ! output (1) = y Constants n = 5 K = 4 Parameters u = 3, >=0, <=10 Variables x[1:n] = u, >=0 Intermediates y = x[n] Equations $x[1] + x[1] = K * u $x[2:n] + x[2:n] = x[1:n-1] minimize (y-5)^2

In the above model comments are designated with *!, %,* or *#*. Another symbol is the dollar sign *$* that indicates a differential variable or *dx _{i}/dt*. The definition of

There is an inherent trade-off between accuracy and computational speed for numerical solution. Additional time discretization points generally improve the accuracy of a solution but also create additional computational burden. Fewer discretization points are needed when the dynamics are slow or the system is near a steady state solution. As a compromise finer discretization points are often used in regions of fast dynamics and more coarse discretization is used in regions of slow dynamics. Often the fast dynamics are present after a step change in an input or near the beginning of a horizon. Fast dynamics naturally decay as the system exceeds two dominant time constants after a change. The dominant time constant is generally dictated by the slowest process in the system to reach steady state. A dominant time constant is often empirically obtained by introducing a step input and simulating the system until it reaches steady state. The dominant time constant is approximately the amount of time necessary to reach (1-e^{-1}) or 63% of the total response change from initial value to steady state.

There are also cases where dynamic data has been collected from a prior event. In these cases the model predictions are desired for comparison with the dynamic data. To compare model and data at each time point, the simulation step size of the simulation is adjusted to match the data frequency. These replay simulations can take excessive computational effort when large amounts of data are available. For these cases of dynamic data reconciliation, downsampling or less frequent time steps of the data may be used by collecting moving averages, infrequent points, or simply predicting at less frequent intervals than the data set.

Slack variables are defined to transform an inequality expression into an equality expression with an added slack variable. The general expression for inequality constraints in the DAE expression is *g(dx/dt,x,p)>0*. An equivalent mathematical expression of the general inequality is *g(dx/dt,x,p)=s* and *s>0*. This form is desirable with solvers such as interior point methods where the initial guess must satisfy all inequality constraints or be on the inside of the feasible region. In the slack variable form, an initial guess value greater than zero for the new slack variable *s* satisfies this requirement. The APMonitor Modeling Language automatically transforms all inequality constraints into equivalent equality constraints with added slack variables.

Certain functions such as *abs*, *if..then*, *min*, *max*, *signum*, and discontinuous functions can be included in models but need to be posed in a way to allow efficient solution by solvers that perform better with continuous first and second derivatives. There are alternative methods to reformulate the problems. Two popular approaches are as MPECs (Mathematical Programs with Equilibrium Constraints) or with binary variables that switch on or off certain elements of the equations.

Model complexity can range from detailed finite element analysis to simple reduced order models. An important aspect of modeling is the overall goal of capturing the input to output relationships for a particular target application. In the case of real-time embedded systems, the complexity of the model may need to be limited to meet simulation or optimization speed requirements. Other times there is no computational time target for a solution and more sophisticated models can be solved. In each case, the correct level of sophistication should be carefully considered. One strategy for finding the appropriate level of complexity is to start with simple models and add complexity only as needed.

**Objective:** Formulate a dynamic model with model quantities such as constants, parameters, and variables and model expressions such as intermediates and equations. Use time-varying inputs, initial conditions, and mass balance equations to specify the problem inputs and dynamics. Create a MATLAB or Python script to simulate and display the results. *Estimated Time: 2 hours*

In Utah, water flows into the (1) Jordanelle reservoir, to the (2) Deer Creek reservoir, to (3) Utah Lake, and finally to the (4) Great Salt Lake.

Suppose that there is a spillway from each upstream body of water to the lower body of water with a flow that is proportional to the square root of the reservoir height. There is no outflow from the Great Salt Lake except due to evaporation. Develop a simplified dynamic model of the height change in each reservoir from water mass balances. Below are constants such as area (km^{2}) and usage requirements (km^{3}/yr), inlet and outlet flow correlations (km^{3}/yr), evaporation correlations, and initial conditions for the volumes (km^{3}).

Outflow River Rates (km^{3}/yr) with height in meters V_{flow_out1}= 0.030 sqrt(h_{1}) V_{flow_out2}= 0.015 sqrt(h_{2}) V_{flow_out3}= 0.060 sqrt(h_{3}) V_{flow_out4}= 0 Evaporation Rates (km^{3}/yr) V_{evap}= 0.5e-5 * Area, for salt water (Great Salt Lake) V_{evap}= 1e-5 * Area, for fresh water (all others) Inflow Rates (km^{3}/yr) V_{flow_in1}= 0.13 (June-Feb), 0.21 (Mar-May) V_{flow_in2}= V_{flow_out1}V_{flow_in3}= V_{flow_out2}V_{flow_in4}= V_{flow_out3}Usage Requirements (km^{3}/yr) V_{use1}= 0.03 V_{use2}= 0.05 V_{use3}= 0.02 V_{use4}= 0.00 Area of Reservoir / Lake (km^{2}) A_{1}= 13.4 A_{2}= 12.0 A_{3}= 384.5 A_{4}= 4400 Initial Volume of Reservoir / Lake (km^{3}) V_{1}= 0.26 V_{2}= 0.18 V_{3}= 0.68 V_{4}= 22.0

Simulate the height of the reservoirs (in meters) over the course of a year, starting in January, with higher inlet flowrates in the spring due to melting snow. Use a mass balance to describe the change in volume and height of each body of water. This is a simple simulation model that assumes no active control. In actual practice, water outlet flows are actively managed to maintain reservoir levels for recreation, provide sufficient river flow rates, limit river flow rates to avoid flooding, and serve agricultural and community needs. Utah Lake and the Great Salt Lake also have additional inlet sources such as the Payson River (Utah Lake) and the Weber River and Bear River (Great Salt Lake) that are not considered in this simulation.

from __future__ import division

from gekko import GEKKO

import numpy as np

#Initial conditions

c = np.array([0.03,0.015,0.06,0])

areas = np.array([13.4, 12, 384.5, 4400])

V0 = np.array([0.26, 0.18, 0.68, 22])

h0 = 1000 * V0 / areas

Vout0 = c * np.sqrt(h0)

vin = [0.13,0.13,0.13,0.21,0.21,0.21,0.13,\

0.13,0.13,0.13,0.13,0.13,0.13]

Vin = [0,0,0,0]

#Initialize model

m = GEKKO()

#time array

m.time = np.linspace(0,1,13)

#define constants

c = m.Array(m.Const,4,value=0)

c[0].value = 0.03

c[1].value = c[0] / 2

c[2].value = c[0] * 2

c[3].value = 0

Vuse = [0.03,0.05,0.02,0.00]

#Parameters

evap_c = m.Array(m.Param,4,value=1e-5)

evap_c[-1].value = 0.5e-5

A = [m.Param(value=i) for i in areas]

Vin[0] = m.Param(value=vin)

#Variables

V = [m.Var(value=i) for i in V0]

h = [m.Var(value=i) for i in h0]

Vout = [m.Var(value=i) for i in Vout0]

#Intermediates

Vin[1:4] = [m.Intermediate(Vout[i]) for i in range(3)]

Vevap = [m.Intermediate(evap_c[i] * A[i]) for i in range(4)]

#Equations

m.Equations([V[i].dt() == \

Vin[i] - Vout[i] - Vevap[i] - Vuse[i] \

for i in range(4)])

m.Equations([1000*V[i] == h[i]*A[i] for i in range(4)])

m.Equations([Vout[i]**2 == c[i]**2 * h[i] for i in range(4)])

#Set to simulation mode

m.options.imode = 4

#Solve

m.solve()

#%% Plot results

time = [x * 12 for x in m.time]

# plot results

import matplotlib.pyplot as plt

plt.figure(1)

plt.subplot(311)

plt.plot(time,h[0].value,'r-')

plt.plot(time,h[1].value,'b--')

plt.ylabel('Level (m)')

plt.legend(['Jordanelle Reservoir','Deer Creek Reservoir'])

plt.subplot(312)

plt.plot(time,h[3].value,'g-')

plt.plot(time,h[2].value,'k:')

plt.ylabel('Level (m)')

plt.legend(['Great Salt Lake','Utah Lake'])

plt.subplot(313)

plt.plot(time,Vin[0].value,'k-')

plt.plot(time,Vout[0].value,'r-')

plt.plot(time,Vout[1].value,'b--')

plt.plot(time,Vout[2].value,'g-')

plt.xlabel('Time (month)')

plt.ylabel('Flow (km3/yr)')

plt.legend(['Supply Flow','Upper Provo River', \

'Lower Provo River','Jordan River'])

plt.show()

from gekko import GEKKO

import numpy as np

#Initial conditions

c = np.array([0.03,0.015,0.06,0])

areas = np.array([13.4, 12, 384.5, 4400])

V0 = np.array([0.26, 0.18, 0.68, 22])

h0 = 1000 * V0 / areas

Vout0 = c * np.sqrt(h0)

vin = [0.13,0.13,0.13,0.21,0.21,0.21,0.13,\

0.13,0.13,0.13,0.13,0.13,0.13]

Vin = [0,0,0,0]

#Initialize model

m = GEKKO()

#time array

m.time = np.linspace(0,1,13)

#define constants

c = m.Array(m.Const,4,value=0)

c[0].value = 0.03

c[1].value = c[0] / 2

c[2].value = c[0] * 2

c[3].value = 0

Vuse = [0.03,0.05,0.02,0.00]

#Parameters

evap_c = m.Array(m.Param,4,value=1e-5)

evap_c[-1].value = 0.5e-5

A = [m.Param(value=i) for i in areas]

Vin[0] = m.Param(value=vin)

#Variables

V = [m.Var(value=i) for i in V0]

h = [m.Var(value=i) for i in h0]

Vout = [m.Var(value=i) for i in Vout0]

#Intermediates

Vin[1:4] = [m.Intermediate(Vout[i]) for i in range(3)]

Vevap = [m.Intermediate(evap_c[i] * A[i]) for i in range(4)]

#Equations

m.Equations([V[i].dt() == \

Vin[i] - Vout[i] - Vevap[i] - Vuse[i] \

for i in range(4)])

m.Equations([1000*V[i] == h[i]*A[i] for i in range(4)])

m.Equations([Vout[i]**2 == c[i]**2 * h[i] for i in range(4)])

#Set to simulation mode

m.options.imode = 4

#Solve

m.solve()

#%% Plot results

time = [x * 12 for x in m.time]

# plot results

import matplotlib.pyplot as plt

plt.figure(1)

plt.subplot(311)

plt.plot(time,h[0].value,'r-')

plt.plot(time,h[1].value,'b--')

plt.ylabel('Level (m)')

plt.legend(['Jordanelle Reservoir','Deer Creek Reservoir'])

plt.subplot(312)

plt.plot(time,h[3].value,'g-')

plt.plot(time,h[2].value,'k:')

plt.ylabel('Level (m)')

plt.legend(['Great Salt Lake','Utah Lake'])

plt.subplot(313)

plt.plot(time,Vin[0].value,'k-')

plt.plot(time,Vout[0].value,'r-')

plt.plot(time,Vout[1].value,'b--')

plt.plot(time,Vout[2].value,'g-')

plt.xlabel('Time (month)')

plt.ylabel('Flow (km3/yr)')

plt.legend(['Supply Flow','Upper Provo River', \

'Lower Provo River','Jordan River'])

plt.show()

Retrieved from http://apmonitor.com/do/index.php/Main/ModelFormulation

Page last modified on January 12, 2018, at 08:12 PM