Main Content


Find stereotype in profile by name

Since R2019a



    stereotype = getStereotype(profile,name) finds a stereotype in a profile by name.


    collapse all

    Create a profile for latency characteristics.

    profile = systemcomposer.profile.Profile.createProfile("LatencyProfileB");
    connLatency = profile.addStereotype("ConnectorLatency",AppliesTo="Connector");
    nodeLatency = profile.addStereotype("NodeLatency",AppliesTo="Component");
    portLatency = profile.addStereotype("PortLatency",AppliesTo="Port");

    Get the stereotype ConnectorLatency in the profile.

    stereotype = getStereotype(profile,"ConnectorLatency")
    stereotype = 
      Stereotype with properties:
                        Name: 'ConnectorLatency'
                 Description: ''
                      Parent: [0x0 systemcomposer.profile.Stereotype]
                   AppliesTo: 'Connector'
                    Abstract: 0
                        Icon: ''
        ComponentHeaderColor: [210 210 210]
          ConnectorLineColor: [168 168 168]
          ConnectorLineStyle: 'Default'
          FullyQualifiedName: 'LatencyProfileB.ConnectorLatency'
                     Profile: [1x1 systemcomposer.profile.Profile]
             OwnedProperties: [1x2 systemcomposer.profile.Property]
                  Properties: [1x2 systemcomposer.profile.Property]

    Close the profile to rerun this example.


    Input Arguments

    collapse all

    Profile, specified as a systemcomposer.profile.Profile object.

    Stereotype name, specified as a character vector or string. The name of the stereotype must be unique within the profile.

    Data Types: char | string

    Output Arguments

    collapse all

    Stereotype found, returned as a systemcomposer.profile.Stereotype object.

    More About

    collapse all


    TermDefinitionApplicationMore Information

    A stereotype is a custom extension of the modeling language. Stereotypes provide a mechanism to extend the architecture language elements by adding domain-specific metadata.

    Apply stereotypes to model elements such as root-level architecture, component architecture, connectors, ports, data interfaces, value types, functions, requirements, and links. Functions only apply to software architectures. You must have a Requirements Toolbox™ license to apply stereotypes to requirements and links. A model element can have multiple stereotypes. Stereotypes provide model elements with a common set of property fields, such as mass, cost, and power.

    Extend Architectural Design Using Stereotypes

    A property is a field in a stereotype. You can specify property values for each element to which the stereotype is applied.

    Use properties to store quantitative characteristics, such as weight or speed, that are associated with a model element. Properties can also be descriptive or represent a status. You can view and edit the properties of each element in the architecture model using the Property Inspector.


    A profile is a package of stereotypes that you can use to create a self-consistent domain of element types.

    Author profiles and apply profiles to a model using the Profile Editor. You can store stereotypes for a project in one or several profiles. When you save profiles, they are stored in XML files.

    Version History

    Introduced in R2019a