 # State Space¶

## ABCD Form¶

Recall from our previous discussion on Ordinary Differential Equations that we can express differential equations in the following form:

In this form, represents the states in the system, represents any externally specified inputs to the system and represents the outputs of the system (i.e., variables that may not be states, but can ultimately be computed from the values of the states and inputs).

There is a particularly interesting special case of these equations when the functions and depend linearly on and . In this case, the equations can be rewritten as:

The matrices in this problem are the so-called “ABCD” matrices. This ABCD form is useful because there are several interesting calculations that can be performed once a system is in this form. For example, using the matrix, we can compute the natural frequencies of the system. Using various combinations of these matrices, we can determine several very important properties related to control of the underlying system (e.g., observability and controllability).

Note that this ABCD form allows these matrices to vary with time. There is a slightly more specialized form that, in addition to being linear, is also time-invariant:

This form is often called the “LTI” form. The LTI form is important because, in addition to having the same special properties as the ABCD form, the LTI form can be used as a very simple form of “model exchange”. Historically, when someone derived the behavior equations for a given system (either by hand or using some modeling tool), one way they could import those equations into other tools was to put them in the LTI form. This means that the model could be exchanged, shared or published as a series of matrices with either numbers or expressions in them. Today, technologies like Modelica and FMI provide much better options for model exchange.

## LTI Models¶

If someone gave us a model in LTI form, how would we express that in Modelica? Here is one way we might choose to do it:

model LTI
"Equations written in ABCD form where matrices are also time-invariant"
parameter Integer nx=0 "Number of states";
parameter Integer nu=0 "Number of inputs";
parameter Integer ny=0 "Number of outputs";
parameter Real A[nx,nx]=fill(0,nx,nx);
parameter Real B[nx,nu]=fill(0,nx,nu);
parameter Real C[ny,nx]=fill(0,ny,nx);
parameter Real D[ny,nu]=fill(0,ny,nu);
parameter Real x0[nx]=fill(0,nx) "Initial conditions";
Real x[nx] "State vector";
Real u[nu] "Input vector";
Real y[ny] "Output vector";
initial equation
x = x0 "Specify initial conditions";
equation
der(x) = A*x+B*u;
y = C*x+D*u;
end LTI;


The first step in this model is to declare the parameters nx, nu and ny. These represent the number of states, inputs and outputs, respectively. Next, we define the matrices A, B, C and D. Because we are creating a model for a linear, time-invariant representation all of these matrices can be parameters. We know that A, B, C and D are arrays because their declarations followed by [ and ]. We know they are matrices because within the []s there are two dimensions given. Finally, we see declarations for x0, x, u and y. These are also arrays. But in this case, they are vectors, since they each have only a single dimension.

Another thing to note about this model is that all parameters have been given default values. For nx, nu and ny, the assumption is that the number of states, inputs and outputs is zero by default. For the matrices, we assume that they are filled with zeros by default. Similarly, for initial conditions we assume that all states start the simulation with a value of zero unless otherwise specified. We shall see shortly how these assumptions make it possible for us to write very simple models by simply overriding the values for these parameters.

## Vector Equations¶

The rest of the model should look pretty familiar by now. One thing that is important to point out is the fact that the equations in this model are all vector equations. An equation in Modelica can involve scalars or arrays. The only requirement is that both side of the equation have the same number of dimensions and the same size for each dimension. So in the case of the LTI model, we have the following initial equation:

initial equation
x = x0 "Specify initial conditions";


This equation is a vector equation that expresses the fact that each element in x has the corresponding value in x0 at the start of a simulation. In practice, what happens is that each element in these vectors is automatically expanded into a series of scalar equations.

Another thing that helps keep these equations readable is that Modelica has some special rules regarding Vectorization of functions. In a nutshell, these rules say that if you have a function that works with scalars, you can automatically use it with vectors as well. If you do, Modelica will automatically apply the function to each element in the vector. So, for example, the expression der(x) in the LTI model is a vector where each element in the vector represents the derivative of the respective element of x.

Finally, many of the typical algebraic operators like +, - and * have special meanings when applied to vectors and matrices. These definitions are designed so that they correspond with conventional mathematical notation. So in the LTI model, the expression A*x corresponds to a matrix-vector product.

## LTI Examples¶

With all this in mind, let’s revisit several of our previous examples to see how they can be represented in LTI form using our LTI model. Note that we will again use inheritance (via the extends keyword) to reuse the code in the LTI model.

Let’s start with the Simple First Order System we presented earlier. Using the LTI model, we can write this model as:

model FirstOrder "Represent der(x) = 1-x"
extends LTI(nx=1,nu=1,A=[-1], B=);
equation
u = {1};
end FirstOrder;


When we extend from LTI, we only need to specify the parameter values that are different from the default values. In this case, we specify that there is one state and one input. Then we specify A and B as 1x1 matrices. Finally, since we have an input, we need to provide an equation for it. The input can, in general, be time-varying so we don’t represent it as a parameter, but rather with an equation. Note that in the equation:

u = {1};


the expression {1} is a vector literal. This means that we are building a vector as a list of its components. In this case, the vector has only one component, 1. But we can build longer vectors using a comma separated list of expressions, e.g.,

v = {1, 2, 3*4, 5*sin(time)};


It is worth noting that, in addition to setting parameter values, we also can include equations in the extends statement. So, we could have avoided the equation section altogether and written the model more compactly as:

model FirstOrder_Compact "Represent der(x) = 1-x"
extends LTI(nx=1,nu=1,A=[-1], B=, u={1});
end FirstOrder_Compact;


In general, including the equation section makes the code a bit more readable for others. But there are some circumstances where it is more convenient to include the equation as a modification in the extends statement.

Now let’s turn our attention to the cooling we also discussed earlier. In LTI form, we could have written the model as:

model NewtonCooling "NewtonCooling model in state space form"
parameter Real T_inf=27.5 "Ambient temperature";
parameter Real T0=20 "Initial temperature";
parameter Real hA=0.7 "Convective cooling coefficient * area";
parameter Real m=0.1 "Mass of thermal capacitance";
parameter Real c_p=1.2 "Specific heat";
extends LTI(nx=1,nu=1,A=[-hA/(m*c_p)],B=[hA/(m*c_p)],x0={20});
equation
u = {T_inf};
end NewtonCooling;


This model is very similar to the previous one. However, in this case, instead of putting numbers into our matrices, we’ve put expressions involving other parameters like m, c_p and so on. In this way, if those physical parameters are changed, the values for A and B will change accordingly.

We can take a similar approach in reformulating our previous mechanical example into LTI form:

model RotationalSMD
"State space version of a rotational spring-mass-damper system"
parameter Real J1=0.4;
parameter Real J2=1.0;
parameter Real c1=11;
parameter Real c2=5;
parameter Real d1=0.2;
parameter Real d2=1.0;
extends LTI(nx=4, nu=0, ny=0, x0={0, 1, 0, 0},
A=[0, 0, 1, 0;
0, 0, 0, 1;
-c1/J1, c1/J1, -d1/J1, d1/J1;
c1/J2, -c1/J2-c2/J2, d1/J2, -d1/J2-d2/J2]);
equation
u = fill(0, 0);
end RotationalSMD;


Again, we compute A from physical parameters. One thing to note about this example is the construction of A. Mathematically, the matrix is defined as:

One thing we can note about this construction of is that the first two rows might be easier to express as a matrix of zeros and an identity matrix. In other words, it might be simpler to construct the matrix as a set of sub-matrices, i.e.,

In Modelica, we can construct our A matrix from sub-matrices in this way:

model RotationalSMD_Concat
"State space version of a rotationals spring-mass-damper system using concatenation"
parameter Real J1=0.4;
parameter Real J2=1.0;
parameter Real c1=11;
parameter Real c2=5;
parameter Real d1=0.2;
parameter Real d2=1.0;
parameter Real S[2,2] = [-1/J1, 1/J1; 1/J2, -1/J2];
extends LTI(nx=4, nu=0, ny=0, x0={0, 1, 0, 0},
A=[zeros(2, 2), identity(2);
c1*S+[0,0;0,-c2/J2], d1*S+[0,0;0,-d2/J2]],
B=fill(0, 4, 0), C=fill(0, 0, 4),
D=fill(0, 0, 0));
equation
u = fill(0, 0);
end RotationalSMD_Concat;


In the section above we do not include a representation of the Lotka-Volterra equations in LTI form. This is because the Lotka-Volterra equations, while being time-invariant, are not linear. It is worth pointing out that Modelica does not directly enforce either of these properties when using the LTI model. So it is possible to represent non-linear or time-variant models using this approach. But it would be confusing since the term LTI implies that the equations are both linear and time-invariant.

## Using Components¶

In all of these examples so far, we’ve used inheritance (via extends) to reuse the equations from the LTI model. In general, there is a much better way to reuse these equations which is to treat them as sub-components. To see how this is done, we will recast our previous electrical examples in LTI form. But this time, we’ll create a named instance of the LTI model:

model RLC "State space version of an RLC circuit"
parameter Real Vb=24;
parameter Real L=1;
parameter Real R=100;
parameter Real C=1e-3;
LTI rlc_comp(nx=2, nu=1, ny=2, x0={0,0},
A=[-1/(R*C), 1/C; -1/L, 0],
B=[0; 1/L],
C=[1/R, 0; -1/R, 1],
D=[0; 0]);
equation
rlc_comp.u = {Vb};
end RLC;


Note that this time we do not use extends or inheritance of any kind. Instead, we actually declare a variable called rlc_comp that is of type LTI. Once we have finished covering all the basics of how to describe different kinds of behavior in Modelica, we’ll turn our attention to how to organize all these equations into reusable Components. But for now, this is just a “sneak peek” of (big) things to come.

What we see in this RLC example is that we now have a variable called rlc_comp and this component, in turn, has all the parameters and variables of the LTI model inside it. So, for example, we see that our equation to specify the input, u, is written as:

rlc_comp.u = {Vb};


Note that this equation means that we are providing an equation for the variable u that is inside the variable rlc_comp. As we will see later, we can use hierarchy to manage a considerable amount of complexity that arises from complex system descriptions. The use of the . operation here is how we can reference variables that are organized in this hierarchical manner. Again, this will be discussed thoroughly when we introduce Components.