Enable parallel model reference builds

Option to build a model reference hierarchy in parallel whenever possible

Model Configuration Pane: Model Referencing

Description

The Enable parallel model reference builds configuration parameter determines whether to build a model reference hierarchy in parallel whenever possible. Use this parameter to reduce:

• Diagram update times for a hierarchy that contains referenced models that simulate in accelerator mode.

• Referenced model build (code generation and compilation) times. Requires Simulink^® Coder™.

Parallel builds require Parallel Computing Toolbox™.

To enable parallel builds for a model reference hierarchy, select Enable parallel model reference builds for the top model of the hierarchy.

Set Configuration Parameter for Referenced Models

In a model reference hierarchy, whether you edit the parameter in the top model or the current referenced model depends on how you access the Configuration Parameters dialog box.

• Top model in the current model hierarchy — In the Simulink Toolstrip, on the Modeling tab, click Model Settings.

• Current referenced model — In the Simulink Toolstrip, on the Modeling tab, click the Model Settings button arrow. Then, in the Referenced Model section, select Model Settings.

Alternatively, open the referenced model as a top model. Then, in the Simulink Toolstrip, on the Modeling tab, click Model Settings.

Settings

off (default) | on

on

The software builds the model reference hierarchy in parallel whenever possible, based on computing resources and the structure of the model reference hierarchy.

To specify how to initialize MATLAB^® workers for parallel builds, see MATLAB worker initialization for builds.

off

The software never builds the model reference hierarchy in parallel.

Recommended Settings

Application	Setting
Debugging	No impact
Traceability	No impact
Efficiency	No impact
Safety precaution	No impact

Programmatic Use

Parameter: EnableParallelModelReferenceBuilds

Value: 'on' | 'off'

Default: 'off'

Version History

Introduced in R2010a

R2026a: Dependencies removed

The Enable parallel model reference builds configuration parameter no longer depends on the Rebuild and Never rebuild diagnostic configuration parameters. When Rebuild is set to Never, the software does not rebuild model reference targets, and the Enable parallel model reference builds configuration parameter does not start a parallel pool of workers.

Previously, the Enable parallel model reference builds configuration parameter was disabled when Rebuild was set to Never and Never rebuild diagnostic was set to None.