Open Model

Open a model. This example uses a single-tasking model, that is, all blocks except constant blocks execute during the same task.

model ="slreportgen_ExecutionOrder_example"; open_system(model);

Report Setup

Import the Report Generator API packages so you do not have to use long, fully qualified class names.

importmlreportgen.report.*importslreportgen.report.*importslreportgen.finder.*

Create and open a Simulink report object. To create a Microsoft® Word, HTML, or single-file HTML report, change "pdf"to "docx", "html", or "html-file", respectively.

rpt = slreportgen.report.Report(model +"_Report","pdf"); open(rpt);

Add a title page and table of contents.

titlepage = TitlePage("Title",model +": Execution Order Report","Author","Jane Doe"); add(rpt,titlepage); toc = TableOfContents(); add(rpt, toc);

Report on Task and Block Execution Order

Find and loop through all systems in the model.

finder = SystemDiagramFinder(model);whilehasNext(finder) system = next(finder);

Create a new chapter and add the diagram result.

ch = Chapter("Title",sprintf("System %s",system.Name)); add(ch,system);

Report the execution order of the system only if it is a block diagram or a nonvirtual subsystem. Blocks within virtual subsystems are reported in the parent's block execution order.

isNonvirtualSubsystem = strcmp(system.Type,"Simulink.SubSystem")...&& strcmp(get_param(system.Object,"IsSubsystemVirtual"),"off");ifstrcmp(system.Type,"Simulink.BlockDiagram") || isNonvirtualSubsystem

Create anExecution Ordersection and anExecutionOrderreporter.

eoSect = Section("Execution Order"); eoRptr = ExecutionOrder(system);

For subsystems, set theExecutionOrderoptions so that task details are not reported, because this information is already reported by the parent block diagram execution order.

ifisNonvirtualSubsystem eoRptr.ShowTaskDetails = false;end

Add theExecutionOrderreporter to theExecution Orderchapter, and add the chapter to the report.

add (eoSect eoRptr);添加(ch, eoSect);end

Create a section to include details about each block in the system. Blocks included inExecutionOrderblock execution order lists link to the corresponding block details in this section.

blkSect = Section("Blocks"); blkFinder = BlockFinder(system); results = find(blkFinder); add(blkSect,results); add(ch,blkSect);

Add the chapter to the report.

add(rpt,ch);end

Close and View the Report

close(rpt); rptview(rpt);

View Sample Reports

To see how execution order is reported for other types of models, view the sample reports available with this example.

Multitasking Models

The sample modelslreportgen_demo_Multitaskingis configured to treat each discrete sample time as a separate task. The sample time for blocksIn1_1s,SS1, andSS2is 1 second, and the sample time for blockIn2_2sis 2 seconds.

The model is also configured to display blocks color-coded by sample time. Blocks that execute at a 1 second sample time are red, and blocks that execute at a 2 second sample time are green. Multirate blocks, such as the rate-transition block between theIntegratorblock and the two subsystems, are yellow. To programmatically configure a model in this way, execute this command:

set_param(model,"SampleTimeColors","on");

The execution order for this model reports two tasks. TheTriggercolumn of the task details table reports the sample time, in seconds, for each task.

The model blocks are separated by task. The rate-transition block executes during both tasks, so it is included in both lists. However, only its output port executes during taskD1, and only its input port executes during taskD2.

To view the full sample report, execute this command:

rptview("slreportgen_demo_Multitasking_Report.pdf")

Nonperiodic Tasks

Some tasks, such as those created by asynchronous interrupts or event listeners, do not execute based on sample time. For example, the sample modelslreportgen_demo_InitResetTermuses three subsystems with the execution controlled by event listeners. Each event listener is configured to execute a subsystem when it receives an initialize, reset, or terminate function-call event.

The initialize, reset, and terminate events are reported as separate tasks in the execution order. Their execution does not directly depend on the sample time of the model, so they are not given an order number in the task table. TheSourceBlockcolumn denotes which block defines the task.

To view the full sample report, execute this command:

rptview("slreportgen_demo_InitResetTerm_Report.pdf")

Conditional Execution

The sample modelslreportgen_demo_ConditionalExecution包含If块和一个函数调用生成器block that control when certain subsystems within the model execute.

The conditionally executed subsystems are not reported in the block execution order list because they do not necessarily execute at every time step. Instead, they are included in aConditional Executiontable that is reported after the block execution order list.

To view the full sample report, execute this command:

rptview("slreportgen_demo_ConditionalExecution_Report.pdf")