Diagnostics Pane: Model Referencing

Model Referencing Diagnostics Overview

Specify the diagnostic actions that Simulink® software should take when it detects an incompatibility relating to a model reference hierarchy.

Configuration

Set the parameters displayed.

Tips

  • To open the Diagnostics: Model Referencing pane, in the Simulink Editor, select Simulation > Model Configuration Parameters > Diagnostics > Model Referencing.

  • The options are typically to do nothing or to display a warning or an error message.

  • A warning does not terminate a simulation, but an error does.

See Also

Model block version mismatch

Select the diagnostic action to take when loading or updating this model if Simulink software detects a mismatch between the version of the model used to create or refresh a Model block in this model and the referenced model's current version.

Settings

Default: none

none

Simulink software takes no action.

warning

Simulink software displays a warning and refreshes the Model block.

error

Simulink software displays an error message and does not refresh Model block.

Tip

If you have enabled display of referenced model version numbers on Model blocks for this model (see Displaying Referenced Model Version NumbersDisplaying Referenced Model Version Numbers), Simulink software displays a version mismatch on the Model block icon, for example: Rev:1.0 != 1.2.

Command-Line Information

Parameter: ModelReferenceVersionMismatchMessage
Type: string
Value: 'none' | 'warning' | 'error'
Default: 'none'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionnone

See Also

Port and parameter mismatch

Select the diagnostic action to take if Simulink software detects a port or parameter mismatch during model loading or updating.

Settings

Default: none

none

Simulink software takes no action.

warning

Simulink software displays a warning and refreshes the Model block.

error

Simulink software displays an error message and does not refresh the Model block.

Tips

  • Port mismatches occur when there is a mismatch between the I/O ports of a Model block and the root-level I/O ports of the model it references.

  • Parameter mismatches occur when there is a mismatch between the parameter arguments recognized by the Model block and the parameter arguments declared by the referenced model.

  • Model block icons can display a message indicating port or parameter mismatches. To enable this feature, from the parent model's Simulink Editor, select Display > Blocks > Block I/O Mismatch for Referenced Models.

Command-Line Information

Parameter: ModelReferenceIOMismatchMessage
Type: string
Value: 'none' | 'warning' | 'error'
Default: 'none'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionerror

See Also

Model configuration mismatch

Select the diagnostic action to take if the configuration parameters of a model referenced by this model do not match this model's configuration parameters or are inappropriate for a referenced model.

Settings

Default: none

none

Simulink software takes no action.

warning

Simulink software displays a warning.

error

Simulink software terminates the simulation and displays an error message.

Tip

Set this diagnostic to warning or error if you suspect that an inappropriate or mismatched configuration parameter may be causing your model to give the wrong result.

Command-Line Information

Parameter: ModelReferenceCSMismatchMessage
Type: string
Value: 'none' | 'warning' | 'error'
Default: 'none'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionwarning

See Also

Invalid root Inport/Outport block connection

Select the diagnostic action to take if Simulink software detects invalid internal connections to this model's root-level Output port blocks.

Settings

Default: none

none

Simulink software silently inserts hidden blocks to satisfy the constraints wherever possible.

warning

Simulink software warns you that a connection constraint has been violated and attempts to satisfy the constraint by inserting hidden blocks.

error

Simulink software terminates the simulation or code generation and displays an error message.

Tips

  • In some cases (such as function-call feedback loops), automatically inserted hidden blocks may introduce delays and thus may change simulation results.

  • Auto-inserting hidden blocks to eliminate root I/O problems stops at subsystem boundaries. Therefore, you may need to manually modify models with subsystems that violate any of the constraints below.

  • The types of invalid internal connections are:

    • A root Output port is connected directly or indirectly to more than one nonvirtual block port:

    • A root Output port is connected to a Ground block:

    • Two root Outport blocks are connected to the same block port:

    • An Outport block is connected to some elements of a block output and not others:

    • An Outport block is connected more than once to the same element:

    • The signal driving the root outport is a test point:

  • The output port has a constant sample time, but the driving block has a non-constant sample time:

  • The driving block has a constant sample time and multiple output ports, and one of the other output ports of the block is a test point.

  • The root output port is conditionally computed, you are using Function Prototype Control or a Encapsulated C++ target, and the Function Prototype specification or C++ target specification states that the output variable corresponding to that root outport is returned by value.

Command-Line Information

Parameter: ModelReferenceIOMsg
Type: string
Value: 'none' | 'warning' | 'error'
Default: 'none'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionerror

See Also

Unsupported data logging

Select the diagnostic action to take if this model contains To WorkspaceTo Workspace blocks or ScopeScope blocks with data logging enabled.

Settings

Default: warning

none

Simulink software takes no action.

warning

Simulink software displays a warning.

error

Simulink software terminates the simulation and displays an error message.

Tips

Command-Line Information

Parameter: ModelReferenceDataLoggingMessage
Type: string
Value: 'none' | 'warning' | 'error'
Default: 'warning'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionerror

See Also

Was this topic helpful?