A common problem when simulating models in an equation-based language like Modelica is that the model may contain non-linear equation systems. These are solved in each time-step by extrapolating an initial guess and running a non-linear system solver. If the simulation takes too long to simulate, it is useful to run the performance analysis tool. The tool has around 5~25% overhead, which is very low compared to instruction-level profilers (30x-100x overhead). Due to being based on a single simulation run, the report may contain spikes in the charts.
When running a simulation for performance analysis, execution times of user-defined functions as well as linear, non-linear and mixed equation systems are recorded.
The generated report is in HTML format (with images in the SVG format), stored in a file modelname_prof.html, but the XML database and measured times that generated the report and graphs are also available if you want to customize the report for comparison with other tools.
Below we use the performance profiler on the simple model A:
model A
function f
input Real r;
output Real o := sin(r);
end f;
String s = "abc";
Real x = f(x) "This is x";
Real y(start=1);
Real z1 = cos(z2);
Real z2 = sin(z1);
equation
der(y) = time;
end A;
We simulate as usual, but set measureTime=true to activate the profiling:
simulate(A, measureTime = true) // // record SimulationResult
// resultFile = "A_res.mat",
// messages = "Time measurements are stored in A_prof.html (human-readable) and A_prof.xml (for XSL transforms or more details)"
All times are measured using a real-time wall clock. This means context switching produces bad worst-case execution times (max times) for blocks. If you want better results, use a CPU-time clock or run the command using real-time priviliges (avoiding context switches).
Note that for blocks where the individual execution time is close to the accuracy of the real-time clock, the maximum measured time may deviate a lot from the average.
For more details, see the generated file A_prof.xml, shown in Section 9.1.7 below.
9.1.2Settings
The settings for the simulation are summarized in the table below: