Main Content

Block Loop

Run child components for each block in the current system, model, or signal

Description

This component runs its child components for each block contained in the current system, model, or signal.

For conditional processing based of blocks, you can use the RptgenSL.getReportedBlock function. For more information, see Loop Context Functions.

Report On

This pane describes the type of object on which this component operates.

  • Automatic list from context: Report on all blocks in the current context. The parent component of the Block Loop determines its context. If this component does not have the Model Loop, System Loop, Signal Loop, or Block Loop as its parent, selecting this option causes this component to report on all blocks in all models.

    • Model Loop: Reports on all blocks in the current model.

    • System Loop: Reports on all blocks in the current system.

    • Signal Loop: Reports on all blocks connected to the current signal.

  • Custom - use block list: Enables you to specify a list of blocks on which to report. Enter the full path of each block.

Loop Options

Choose block sorting options and reporting options in this pane.

  • Sort blocks:

    Use this option to select how to sort blocks (applied to each level in a model):

    • Alphabetically by block name. Sorts blocks alphabetically by their names.

    • Alphabetically by system name. Sorts systems alphabetically. The report lists blocks in each system, but in no particular order.

    • Alphabetically by full Simulink path. Sorts blocks alphabetically by Simulink® path.

    • By block type. Sorts blocks alphabetically by block type.

    • By block depth. Sorts blocks by their depth in the model.

    • By layout (left to right): Sorts blocks by their location in the model layout, by rows. The block appearing the furthest toward the left top corner of the model is the anchor for the row. The row contains all other blocks that overlap the horizontal area defined by the top and bottom edges of the anchor block. The other rows use the same algorithm, using as the anchor the next unreported block nearest the left top of the model.

    • By layout (top to bottom): Sorts blocks by their location in the model layout, by columns. The block appearing the furthest toward the left top corner of the model is the anchor for the column. The column contains all other blocks that overlap the vertical area defined by the left and right edges of the anchor block. The other columns use the same algorithm, using as the anchor the next unreported block nearest the left top of the model.

    • By traversal order. Sorts blocks by traversal order.

    • By simulation order. Sorts blocks by execution order.

    • %<VariableName>: Inserts the value of a variable from the MATLAB® workspace. The %<> notation can denote a string or cell array. The following example reports on the theta dot integrator block and the theta integrator block in the model simppend, using the variable Z={ 'simppend/theta'}:

      simppend/theta dot
%<Z>
      The generated report includes information about the following blocks:

      • simppend/theta dot

      • simppend/theta

      For more information, see %<VariableName> Notation on the Text component reference page in the MATLAB Report Generator™ documentation.

  • Search for Simulink property name/property value pairs: Reports only on Simulink blocks with specified property name/property value pairs.

Section Options

  • Create section for each object in loop: Inserts a section in the generated report for each block found in the loop.

  • Display the object type in the section title: Automatically inserts the object type into the section title in the generated report.

  • Create link anchor for each object in loop: Create a link target for each block in the loop so that other parts of the report can link to it. For example, the image created by a System Snapshot component can link to the block information only if you select this check box.

Insert Anything into Report?

Yes, inserts a section if you select the Create section for each object in loop option and a link target if you select Create link anchor for each object in loop.

Class

rptgen_sl.csl_blk_loop