massMatrixForm

R2026b

Extract mass matrix and right side of semilinear system of differential algebraic equations

Syntax

[M,F] = massMatrixForm(eqs,vars)

Description

[M,F] = massMatrixForm(eqs,vars) returns the mass matrix M and the right side of equations F of a semilinear system of first-order differential algebraic equations (DAEs). Algebraic equations in eqs that do not contain any derivatives of the variables in vars correspond to empty rows of the mass matrix M.

The mass matrix M and the right side of equations F refer to this form.

$$M\left(t,x\left(t\right)\right)\dot{x}\left(t\right)=F\left(t,x\left(t\right)\right).$$

Examples

Convert DAE System to Mass Matrix Form

Convert a semilinear system of differential algebraic equations to mass matrix form.

Create the following system of differential algebraic equations. Here, the functions x(t) and y(t) represent state variables of the system. The system also contains symbolic parameters alpha and beta, and the function f(t,x,y). Specify the equations and variables as two symbolic vectors: equations as a vector of symbolic equations, and variables as a vector of symbolic function calls.

syms x(t) y(t) f(t,x,y) alpha beta
eqs = [x(t) - diff(x(t),t) == alpha*f(t,x(t),y(t)); ...
       y(t) + diff(y(t),t) == beta*f(t,x(t),y(t))]

eqs = 
$$\left(\begin{array}{c}x\left(t\right)-\frac{\partial }{\partial t}\mathrm{ }x\left(t\right)=\alpha \hspace{0.17em}f\left(t,x\left(t\right),y\left(t\right)\right)\\ \frac{\partial }{\partial t}\mathrm{ }y\left(t\right)+y\left(t\right)=\beta \hspace{0.17em}f\left(t,x\left(t\right),y\left(t\right)\right)\end{array}\right)$$

vars = [x(t),y(t)];

Find the mass matrix form of this system.

[M,F] = massMatrixForm(eqs,vars)

M = 
$$\left(\begin{array}{cc}-1& 0\\ 0& 1\end{array}\right)$$

F = 
$$\left(\begin{array}{c}\alpha \hspace{0.17em}f\left(t,x\left(t\right),y\left(t\right)\right)-x\left(t\right)\\ \beta \hspace{0.17em}f\left(t,x\left(t\right),y\left(t\right)\right)-y\left(t\right)\end{array}\right)$$

Solve this system using the numerical solver ode15s. Before you use ode15s, assign the following values to symbolic parameters of the system: alpha = 0.01, beta = 0.02, f(t,x,y) = x*y. Also, replace the state variables x(t) and y(t) by variables Y1 and Y2, that are acceptable by matlabFunction.

syms Y1 Y2
M = subs(M,[vars,alpha,beta,f],[Y1,Y2,0.01,0.02,@(t,x,y) x*y]);
F = subs(F,[vars,alpha,beta,f],[Y1,Y2,0.01,0.02,@(t,x,y) x*y]);

Create the following function handles MM and FF. You can use these function handles as input arguments for odeset and ode15s. These functions require state variables to be specified as column vectors.

MM = matlabFunction(M,Vars={t,[Y1; Y2]});
FF = matlabFunction(F,Vars={t,[Y1; Y2]});

Solve the system using ode15s. Specify the initial values for the variables Y1 and Y2 as 20 and 10. Plot the solutions over the time interval [0 10].

opt = odeset(Mass=MM);
ode15s(FF,[0 15],[50; 20],opt)

Determine and Generate State Variables Programmatically

Create the following system of differential algebraic equations. Here, the symbolic functions x1(t), x2(t), and x3(t) represent state variables of the system. The system also contains symbolic parameters a and b.

syms x1(t) x2(t) x3(t) a b
eqs = [a*diff(x1,t) == x1*x3- x2;
       diff(x2,t) == b*x1 - 1;
       0 == x1 + x2 + x3]

eqs(t) = 
$$\left(\begin{array}{c}a\hspace{0.17em}\frac{\partial }{\partial t}\mathrm{ }{x}_1\left(t\right)=x_1\left(t\right)\hspace{0.17em}{x}_3\left(t\right)-x_2\left(t\right)\\ \frac{\partial }{\partial t}\mathrm{ }{x}_2\left(t\right)=b\hspace{0.17em}{x}_1\left(t\right)-1\\ 0=x_1\left(t\right)+x_2\left(t\right)+x_3\left(t\right)\end{array}\right)$$

Find the state variables of the system of equations. Often, these variables are functions of time only. To programmatically determine the state variables, use findSymType by specifying symfunOf as t.

vars = findSymType(eqs,"symfunOf",t)

vars = $$\left(\begin{array}{ccc}{x}_1\left(t\right)& x_2\left(t\right)& x_3\left(t\right)\end{array}\right)$$

Find the mass matrix form of this system.

[M,F] = massMatrixForm(eqs,vars)

M = 
$$\left(\begin{array}{ccc}a& 0& 0\\ 0& 1& 0\\ 0& 0& 0\end{array}\right)$$

F = 
$$\left(\begin{array}{c}{x}_1\left(t\right)\hspace{0.17em}{x}_3\left(t\right)-x_2\left(t\right)\\ b\hspace{0.17em}{x}_1\left(t\right)-1\\ x_1\left(t\right)+x_2\left(t\right)+x_3\left(t\right)\end{array}\right)$$

Next, assign the values of a and b as 2 and 1, respectively. Also, replace the state variables by variables Y1, Y2, and so on, that are acceptable by matlabFunction. You can use sym to programmatically generate the variables Y1, Y2, and so on.

numVars = numel(vars);
vecY = sym("Y",[1,numVars]);
M = subs(M,[a b vars],[2 1 vecY]);
F = subs(F,[a b vars],[2 1 vecY]);

Create the following function handles MM and FF. You use these function handles as input arguments for odeset and ode15s. These functions require state variables to be specified as column vectors. Because the symbolic variables in vecY are complex, use the nonconjugate transpose to convert vecY to a column vector.

MM = matlabFunction(M,Vars={t,vecY.'});
FF = matlabFunction(F,Vars={t,vecY.'});

Solve the system using ode15s. Specify the initial values for the variables Y1, Y2, and Y3 as 1, 1, and -2, respectively. Plot the solutions over the time interval [0 15].

opt = odeset(Mass=MM);
ode15s(FF,[0 15],[1; 1; -2],opt)

Input Arguments

eqs — System of semilinear first-order DAEs

vector of symbolic equations | vector of symbolic expressions

System of semilinear first-order DAEs, specified as a vector of symbolic equations or expressions.

vars — State variables

vector of symbolic functions | vector of symbolic function calls

State variables, specified as a vector of symbolic functions or function calls, such as x(t).

Example: [x(t),y(t)] or [x(t);y(t)]

Output Arguments

M — Mass matrix

symbolic matrix

Mass matrix of the system, returned as a symbolic matrix. The number of rows is the number of equations in eqs, and the number of columns is the number of variables in vars.

F — Right sides of equations

symbolic column vector of symbolic expressions

Right sides of equations, returned as a column vector of symbolic expressions. The number of elements in this vector is equal to the number of equations in eqs.

Version History

Introduced in R2014b