Main Content

removeElement

Remove component from element group of view

    Description

    example

    removeElement(elementGroup,component) adds the component component to the element group elementGroup of an architecture view.

    Note

    removeElement cannot be used when a selection query or grouping is defined on the view. To remove the query, run removeQuery.

    Examples

    collapse all

    Open the keyless entry system example and create a view, 'NewView'.

    scKeylessEntrySystem
    model = systemcomposer.loadModel('KeylessEntryArchitecture');
    view = model.createView('NewView');

    Open the Architecture Views Gallery to see the new view named 'NewView'.

    model.openViews

    Add an element to the view by path.

    view.Root.addElement('KeylessEntryArchitecture/Lighting System/Headlights')

    Add an element to the view by object.

    component = model.lookup('Path','KeylessEntryArchitecture/Lighting System/Cabin Lights');
    view.Root.addElement(component)

    Remove an element from the view by path.

    view.Root.removeElement('KeylessEntryArchitecture/Lighting System/Headlights')

    Remove an element from the view by object.

    view.Root.removeElement(component)

    Input Arguments

    collapse all

    Element group for view, specified as a systemcomposer.view.ElementGroup object.

    Component to remove from view, specified as a systemcomposer.arch.Component object, a systemcomposer.arch.VariantComponent object, an array of systemcomposer.arch.Component objects, an array of systemcomposer.arch.VariantComponent objects, the path to a component, or a cell array of component paths.

    Example: 'KeylessEntryArchitecture/Lighting System/Headlights'

    More About

    collapse all

    Definitions

    TermDefinitionApplicationMore Information
    viewA view shows a customizable subset of elements in a model. Views can be filtered based on stereotypes or names of components, ports, and interfaces, along with the name, type, or units of an interface element. Construct views by pulling in elements manually. Views create a simplified way to work with complex architectures by focusing on certain parts of the architecture design.

    You can use different types of views to represent the system:

    • Operational views demonstrate how a system will be used and should be well integrated with requirements analysis.

    • Functional views focus on what the system must do to operate.

    • Physical views show how the system is constructed and configured.

    A viewpoint represents a stakeholder perspective that specifies the contents of the view.

    element groupAn element group is a grouping of components in a view.Use element groups to programmatically populate a view.Create Architectural Views Programmatically
    queryA query is a specification that describes certain constraints or criteria to be satisfied by model elements.Use queries to search elements with constraint criteria and to filter views.Find Elements in a Model Using Queries

    Introduced in R2021a