Main Content

addComponent

Add components to architecture

Description

example

components= addComponent(architecture,compNames)adds a set of components specified by the namescompNames.

To remove a component, use thedestroyfunction.

components= addComponent(architecture,compNames,stereotypes)applies stereotypes specified instereotypesto the new components.

Examples

collapse all

Create a model, get the root architecture, and create components. Arrange the layout to view both components.

model = systemcomposer.createModel("archModel",true); arch = get(model,"Architecture"); names = ["Component1","Component2"]; comps = addComponent(arch,names); Simulink.BlockDiagram.arrangeSystem("archModel");

Input Arguments

collapse all

Parent architecture to add component to, specified as asystemcomposer.arch.Architectureobject.

Name of components, specified as a cell array of character vectors or an array of strings. The length ofcompNamesmust be the same asstereotypes.

Data Types:char|string

Stereotypes to apply to components, specified as a cell array of character vectors or an array of strings. Each element is the qualified stereotype name for the corresponding component in the form".".

Data Types:char|string

Output Arguments

collapse all

Created components, returned as an array ofsystemcomposer.arch.Componentobjects.

More About

collapse all

Definitions

Term Definition Application More Information
architecture

A System Composer™architecturerepresents a system of components and how they interface with each other structurally and behaviorally. You can represent specific architectures using alternate views.

Different types of architectures describe different aspects of systems:

  • Functional architecturedescribes the flow of data in a system.

  • Logical architecturedescribes the intended operation of a system.

  • Physical architecturedescribes the platform or hardware in a system.

Compose Architecture Visually
model

A System Composermodelis the file that contains architectural information, including components, ports, connectors, interfaces, and behaviors.

Perform operations on a model:

  • Extract the root-level architecture contained in the model.

  • Apply profiles.

  • Link interface data dictionaries.

  • Generate instances from model architecture.

A System Composer model is stored as an SLX file.

Create Architecture Model with Interfaces and Requirement Links
component

Acomponentis a nontrivial, nearly independent, and replaceable part of a system that fulfills a clear function in the context of an architecture. A component defines an architectural element, such as a function, a system, hardware, software, or other conceptual entity. A component can also be a subsystem or subfunction.

Represented as a block, a component is a part of an architecture model that can be separated into reusable artifacts.

Components
port

Aportis a node on a component or architecture that represents a point of interaction with its environment. A port permits the flow of information to and from other components or systems.

There are different types of ports:

  • Component portsare interaction points on the component to other components.

  • Architecture portsare ports on the boundary of the system, whether the boundary is within a component or the overall architecture model.

Ports
connector

Connectorsare lines that provide connections between ports. Connectors describe how information flows between components or architectures.

A connector allows two components to interact without defining the nature of the interaction. Set an interface on a port to define how the components interact.

Connections

Term Definition Application More Information
stereotype

Astereotypeis 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, and functions. Functions only apply to software architectures. 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
property

Apropertyis 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.

profile

Aprofileis a package of stereotypes to create a self-consistent domain of element types.

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

Version History

Introduced in R2019a