isConfigActive

R2026b

Check if variant configuration is active

Since R2025a

collapse all in page

    Syntax

    tf = isConfigActive(varConfigs,nameOfConfig)

    Description

    The function isConfigActive checks if the specified variant configuration is the active configuration for a model. You can use this function when defining variant constraints from Variant Manager. A constraint is a user defined check that you can use to prevent invalid variant combinations in a model. The constraint must be satisfied by all variant configurations created for the model. You specify constraints as condition expressions that must evaluate to true. The expression can contain variant control variables used by the model hierarchy as well as names of referenced configurations, which are variant configurations for referenced components present in the hierarchy. You can use the isConfigActive function to specify a referenced configuration name in the condition expression of a constraint, either from the Variant Manager user interface or by using the addConstraint function.

    For more information on referenced configurations, see Compose Variant Configurations and Constraints for Top Model Using Referenced Configurations.

    tf = isConfigActive(varConfigs,nameOfConfig) checks if the variant configuration nameOfConfig is the active configuration for the model with which the Simulink.VariantConfigurations object varConfigs is associated. The function compares the values of variant control variables used in nameOfConfig with their values in the data source where they are originally defined and returns a logical value 1 if the values match. nameOfConfig must be defined in the object varConfigs.

    example

    Examples

    collapse all

    Open Live Script

    Check whether a specified configuration is the active configuration for a model.

    Get the variant configurations object for the model.

    open_system("slexVariantManagementExternalPlantMdlRef");
refvco = Simulink.VariantManager.getVariantConfigurations("slexVariantManagementExternalPlantMdlRef");

    Use the isConfigActive function to check if any of the named configurations in refvco is active for the model.

    tf = isConfigActive(refvco,"LowFid");
tf = isConfigActive(refvco,"HighFid");

    You can use the isConfigActive function to set up model-wide variant constraints using referenced component configurations.

    Add a constraint to the variant configurations object vco of the top-level model slexVariantManagement. Use the configurations in refvco to define the condition for the constraint. Use the isConfigActive function call to specify the configuration names in the condition. The constraint defined here checks that configurations in vco must have the control variable FidType defined in refvco set to either Fidelity.Low or Fidelity.High.

    open_system("slexVariantManagement");
vco = Simulink.VariantManager.getVariantConfigurations("slexVariantManagement");
addConstraint(vco,"ExternalPantFidelityConstraint", ...
 "(isConfigActive(refvco,""LowFid"") || isConfigActive(refvco,""HighFid""))");

    Input Arguments

    collapse all

    Variant configurations object in which nameOfConfig is defined, specified as a Simulink.VariantConfigurations object.

    Name of the variant configuration to check, specified as a character vector or string scalar.

    Example: "LinInterExpNoNoise"

    Data Types: char | string

    Output Arguments

    collapse all

    True or false result, returned as a 1 or 0 of data type logical.

    Version History

    Introduced in R2025a

    expand all

    See Also

    Objects

    Functions

    Topics