This document is intended for beginner users of BlockImporter. It gives an overview and through an example explains how to work with BlockImporter. The example illustrates how to import a system, simplify the equations, and simulate them in Maple. For details, see the help page on BlockImporter.

BlockImporter requires that the following components be set up correctly.

For details, see the BlockImporter,setup help page.

$\mathrm{with}\left(\mathrm{BlockImporter}\right)$

We would like to import a simple Simulink model.  This model is located in the BlockImporter data directory. The following command will return the location of this data directory.

$\mathrm{datadir}≔\mathrm{BlockImporter}:-\mathrm{DataDirectory}\left(\right)$

This directory contains the model file (example.mdl) and an initialization script (example_init.m).  The initialization script contains the definition of two parameters, a1 and a2, that must be defined before the model can be executed.

To import the model, we call the Import function, and give it the name of the model that we want to import.  In our case the model is called example.  Optionally, we also pass in the name of the initialization script, and the directory where the model is located.  The function will return a data structure with the imported equations, and we will assign it to the variable sys.

$\mathrm{sys}≔\mathrm{Import}\left(''example''\, \mathrm{path}\=\mathrm{datadir}\, \mathrm{init}\=''example\_init''\,\mathrm{inplace}\=\mathrm{true}\right)\:$

The import command makes a copy of the model and calls it temp_example, and adds numerical IDs to all the blocks in the model.  These IDs correspond to the variable names in the extracted equations.

The variable sys contains the representation of the model, and is represented as a record data structure, which contains the following fields.

A convenient procedure, PrintSummary, displays all the fields of this data structure.

$\mathrm{PrintSummary}\left(\mathrm{sys}\right)$

The structure that has been imported from the model contains over 20 equations; however, many of these equations are of the trivial form $a\=b$. We can simplify the total number of equations with the SimplifyModel command, and store the result in the sys2 data structure, using the same internal format.

$\mathrm{sys2} ≔ \mathrm{SimplifyModel}\left(\mathrm{sys}\right)$

The summary of this model reveals that the simplified model contains significantly fewer equations.

$\mathrm{PrintSummary}\left(\mathrm{sys2}\right)$

The equations that are contained in the data structure imported from Simulink are not differential equations, and therefore are not suitable to simulate the system using the dsolve command. To convert the structure to a suitable form, we use the BuildDE command, and assign the result to the variable deq.

$\mathrm{deq} ≔ \mathrm{BuildDE}\left(\mathrm{sys2}\right)$

The result is a list of objects.

To simulate the model, we substitute the source equations into the differential equations, add the initial conditions, and pass the equations to the dsolve procedure, which returns a simulation procedure.

$\mathrm{sol}≔\mathrm{dsolve}\left(\left[\mathrm{eval}\left(\mathrm{eval}\left(\mathrm{deq}:-\mathrm{equations}\, \mathrm{deq}:-\mathrm{parameters}\right)\,\mathrm{deq}:-\mathrm{sourceeqs}\right)\left[\right]\, \mathrm{deq}:-\mathrm{initialeqs}\left[\right]\right]\, \mathrm{numeric}\right)$

The time domain solution can be plotted.

$\mathrm{plots}\left[\mathrm{odeplot}\right]\left(\mathrm{sol}\,\left[t\,\mathrm{deq}:-\mathrm{outputvars}\left[1\right]\right]\, 0..10\,\mathrm{gridlines}\=\mathrm{true}\right)\;$

The following resources are available.