Main Content

Total number of instances allowed per top model

Number of references to this model that can occur in another model

Model Configuration Pane: Model Referencing

Description

The Total number of instances allowed per top model configuration parameter determines how many references to this model can occur in another model.

Set Configuration Parameter for Referenced Model

In a model reference hierarchy, how you open the Configuration Parameters dialog box determines whether you edit the configuration parameter for the top model in the current model hierarchy or the current referenced model.

  • 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

Multiple (default) | One | Zero
Zero

The model cannot be referenced. An error occurs if a reference to the model occurs in another model.

One

The model can be referenced once in a model reference hierarchy. An error occurs if more than one reference exists.

Multiple

The model can be referenced more than once in a hierarchy, provided that it contains no constructs that preclude multiple reference. An error occurs if the model cannot be referenced multiple times, even if only one reference exists.

To use multiple instances of a referenced model in normal mode, use the Multiple setting. For details, see Simulate Multiple Referenced Model Instances in Normal Mode.

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precaution

No recommendation

Programmatic Use

Parameter: ModelReferenceNumInstancesAllowed
Value: 'Zero' | 'Single' | 'Multi'
Default: 'Multi'

Version History

Introduced before R2006a