Simulink.SimulationData.ModelLoggingInfo.createFromModel

R2026b

Create Simulink.SimulationData.ModelLoggingInfo object for top model with override settings for each logged signal in model

Syntax

mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl)

mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl,Name=Value)

Description

mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl) creates a model logging override object for the model mdl that includes logged signals for these kinds of systems:

• Libraries

• Masked subsystems

• Referenced models

• Active variants

mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl,Name=Value) specifies options using one or more name-value arguments in addition to the input arguments in the previous syntax.

Examples

Create Model Logging Override Object with Logged Signals

You can create a model logging override object for a model and automatically add each logged signal in the model to that object.

Open the IterativeCounter project. The project opens the CounterSystem model at startup. The CounterSystem model has four signals marked for logging.

openProject("IterativeCounter");
mdl = "CounterSystem";
mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl)

mdlInfo = 
  ModelLoggingInfo with properties:

                     Model: 'CounterSystem'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1×4 Simulink.SimulationData.SignalLoggingInfo]
            isLoadingModel: 0
             isSavingModel: 0

The LoggingMode property is set to "OverrideSignals", which configures the model logging override object to log only the signals specified in the Signals property.

Apply the model override object settings. The software saves the settings when you save the model.

set_param(mdl,DataLoggingOverride=mdlInfo);

Specify How to Handle Variants

To specify how a model logging override object handles components like variants or model references, use name-value argument options in the Simulink.SimulationData.ModelLoggingInfo.createFromModel function. For example, to create a model logging override object that includes logged signals in all variants of the sldemo_variant_subsystems model, use the Variants name-value argument.

Open the sldemo_variant_subsystem model. By default, the model does not log any signals.

mdl = "sldemo_variant_subsystems";
open_system(mdl)

Configure the output signals from the Linear Controller and Nonlinear Controller subsystems to log data.

phLin = get_param(mdl+"/Controller/Linear Controller","PortHandles");
set_param(phLin.Outport(1),DataLogging="on");
phNonlin = get_param(mdl+"/Controller/Nonlinear Controller","PortHandles");
set_param(phNonlin.Outport(1),DataLogging="on");

To create a model logging override object that includes the signals logged in all variant subsystems of the model, use Simulink.SimulationData.ModelLoggingInfo.createFromModel with the Variants name-value argument specified as "allVariants".

mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(...
    mdl,Variants="AllVariants")

mdlInfo = 
  ModelLoggingInfo with properties:

                     Model: 'sldemo_variant_subsystems'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1×2 Simulink.SimulationData.SignalLoggingInfo]
            isLoadingModel: 0
             isSavingModel: 0

Input Arguments

mdl — Name of top model

character vector

Name of top model for which to create a Simulink.SimulationData.ModelLoggingInfo object, specified as a character vector.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: mdlInfo = Simulink.SimulationData.ModelLoggingInfo.createFromModel(mdl, Variants="allVariants")

If you select more than one option, then the created Simulink.SimulationData.ModelLoggingInfo object includes signals that fit the combinations of the specified options. For example, if you set FollowLinks to "on" and ReferencedModels to "off", then the model signal logging override object does not include signals from library links that exist inside of referenced models.

FollowLinks — Option to follow links into library blocks

"on" (default) | "off"

Option to follow links into library blocks, specified as one of these options:

• "on" — Include logged signals from inside of libraries.

• "off" — Skip all libraries.

LookUnderMasks — Option to include logged signals from masked systems

"all" (default) | "none" | "graphical" | "functional"

Option to include logged signals from masked systems, specified as one of these options:

• "all" — Include logged signals from all masked subsystems.

• "none" — Skip all masked subsystems.

• "graphical" — Include logged signals from masked subsystems that do not have a workspace or dialog box.

• "functional" — Include logged signals from masked subsystems that do not have a dialog box.

Variants — Option to include subsystem and model variants

"ActiveVariants" (default) | "AllVariants"

Option to include subsystem and model variants, specified as one of these options:

• "ActiveVariants" — Include logged signals from only active subsystem and model variants.

• "AllVariants" — Include logged signals from all subsystem and model variants.

ReferencedModels — Option to include logged signals from referenced models

"on" (default) | "off"

Option to include logged signals from referenced models, specified as one of these options:

• "on" — Include logged signals from referenced models.

• "off" — Skip all referenced models.

Version History

Introduced in R2012b