addStereotype

Add stereotype to profile

Syntax

stereotype = addStereotype(profile,name)

stereotype = addStereotype(___,Name=Value)

Description

stereotype = addStereotype(profile,name) adds a new stereotype with a specified name name to a profile profile.

stereotype = addStereotype(___,Name=Value) adds a new stereotype with the previous input arguments and specifies properties for the stereotype.

Examples

Add Component Stereotype

Add a component stereotype to a profile.

profile = systemcomposer.profile.Profile.createProfile("LatencyProfile");
stereotype = addStereotype(profile,"electricalComponent",AppliesTo="Component")

stereotype = 
  Stereotype with properties:

                    Name: 'electricalComponent'
             Description: ''
                  Parent: [0x0 systemcomposer.profile.Stereotype]
               AppliesTo: 'Component'
                Abstract: 0
                    Icon: ''
    ComponentHeaderColor: [210 210 210]
      ConnectorLineColor: [168 168 168]
      ConnectorLineStyle: 'Default'
      FullyQualifiedName: 'LatencyProfile.electricalComponent'
                 Profile: [1x1 systemcomposer.profile.Profile]
         OwnedProperties: [0x0 systemcomposer.profile.Property]
              Properties: [0x0 systemcomposer.profile.Property]

close(profile,true)

Input Arguments

profile — Profile

profile object

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

name — Stereotype name

character vector | string

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

Example: "electricalComponent"

Data Types: char | string

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.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: addStereotype(profile,'electricalComponent',AppliesTo="Component")

Description — Description text for stereotype

character vector | string

Description text for stereotype, specified as a character vector or string.

Example: addStereotype(profile,'electricalComponent',Description="These components are electrical")

Data Types: char | string

Icon — Icon name for stereotype

character vector | string

Icon name for stereotype, specified as a character vector or string. Built in options include:

• "default"

• "application"

• "channel"

• "controller"

• "database"

• "devicedriver"

• "memory"

• "network"

• "plant"

• "sensor"

• "subsystem"

• "transmitter"

This name-value argument is only valid for component stereotypes. The element a stereotype applies to is set with the AppliesTo name-value argument.

Example: addStereotype(profile,"electricalComponent",Icon="default")

Data Types: char | string

Parent — Stereotype from which stereotype inherits properties

stereotype object

Stereotype from which stereotype inherits properties, specified as a systemcomposer.profile.Stereotype object.

Example: addStereotype(profile,"electricalComponent",Parent=baseStereotype)

AppliesTo — Element type to which stereotype can be applied

"" (default) | "Component" | "Port" | "Connector" | "Interface" | "Allocation" | "Function" | "Requirement" | "Link"

Element type to which stereotype can be applied, specified as one of these options:

• "" to apply stereotype to all element types.

• "Component".

• "Port".

• "Connector".

• "Interface".

• "Allocation". For more information, see Create and Manage Allocations Interactively.

• "Function", which is only available for software architectures. For more information, see Apply Stereotypes to Functions of Software Architectures.

• "Requirement", to be used with a Requirements Toolbox™ license. For more information, see Customize Requirements and Links by Using Stereotypes (Requirements Toolbox).

• "Link", to be used with a Requirements Toolbox license.

Example: addStereotype(profile,"electricalComponent",AppliesTo="Port")

Data Types: char | string

Abstract — Whether stereotype is abstract

falseor 0 (default) | true or 1

Whether stereotype is abstract, specified as a logical. If true, then the stereotype cannot be directly applied on model elements, but instead serves as a parent for other stereotypes.

Example: addStereotype(profile,'electricalComponent','Abstract',true)

Data Types: logical

ComponentHeaderColor — Component header color

1x3 uint32 row vector

Component header color, specified as a 1x3 uint32 row vector in the form [Red Green Blue].

This name-value argument is only valid for component stereotypes. The element a stereotype applies to is set with the AppliesTo name-value argument.

Example: addStereotype(profile,'electricalComponent','ComponentHeaderColor',[206 232 246])

Data Types: uint32

ConnectorLineColor — Connector line color

1x3 uint32 row vector

Connector line color, specified as a 1x3 uint32 row vector in the form [Red Green Blue].

This name-value argument is only valid for connector, port, and interface stereotypes. The element a stereotype applies to is set with the AppliesTo name-value argument.

Example: addStereotype(profile,'electricalComponent','ConnectorLineColor',[206 232 246])

Data Types: uint32

ConnectorLineStyle — Connector line style

character vector | string

Connector line style name, specified as a character vector or string. Options include:

• "Default"

• "Dot"

• "Dash"

• "Dash Dot"

• "Dash Dot Dot"

This name-value argument is only valid for connector, port, and interface stereotypes. The element a stereotype applies to is set with the AppliesTo name-value argument.

Data Types: char | string

Output Arguments

stereotype — Created stereotype

stereotype object

Created stereotype, returned as a systemcomposer.profile.Stereotype object.

More About

Definitions

Term	Definition	Application	More Information
stereotype	Stereotypes provide a mechanism to extend the core language elements and add domain-specific metadata.	Apply stereotypes to core element types. An element can have multiple stereotypes. Stereotypes allow you to style different elements. Stereotypes provide elements with a common set of properties, such as mass, cost, and power.	Define Stereotypes and Perform Analysis for Mobile Robot Extend Architectural Design Using Stereotypes Change Stereotypes Based on Stereotype Hierarchy in Portable Blender Architecture
property	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.	Set Properties Add Properties with Stereotypes Set Properties for Analysis
profile	A profile is a package of stereotypes.	You can use profiles to create a domain of specialized 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.	Extend System Composer Language Elements Using Profiles Change Stereotype Order Using Manage Profiles Tool

Version History

Introduced in R2019a