Main Content

getAllocatedFrom

Get allocation source

Since R2020b

collapse all in page

    Syntax

    sourceElements = getAllocatedFrom(allocScenario,targetElement)

    Description

    example

    sourceElements = getAllocatedFrom(allocScenario,targetElement) gets all allocated source elements from which a target element targetElement is allocated.

    Examples

    collapse all

    Create two new models with a component each.

    mSource = systemcomposer.createModel("Source_Model_Allocation");
systemcomposer.openModel("Source_Model_Allocation");
sourceComp = addComponent(get(mSource,"Architecture"),"Source_Component");
mTarget = systemcomposer.createModel("Target_Model_Allocation");
systemcomposer.openModel("Target_Model_Allocation");
targetComp = addComponent(get(mTarget,"Architecture"),"Target_Component");

    Create the allocation set MyNewAllocation.

    allocSet = systemcomposer.allocation.createAllocationSet("MyNewAllocation",...
     "Source_Model_Allocation","Target_Model_Allocation");

    Get the default allocation scenario.

    defaultScenario = getScenario(allocSet,"Scenario 1");

    Allocate components between models.

    allocation = allocate(defaultScenario,sourceComp,targetComp);

    Get allocated from source component allocated to target component.

    sourceElement = getAllocatedFrom(defaultScenario,targetComp)
    sourceElement = 

  Component with properties:

     IsAdapterComponent: 0
           Architecture: [1×1 systemcomposer.arch.Architecture]
                   Name: 'Source_Component'
                 Parent: [1×1 systemcomposer.arch.Architecture]
                  Ports: [0×0 systemcomposer.arch.ComponentPort]
             OwnedPorts: [0×0 systemcomposer.arch.ComponentPort]
      OwnedArchitecture: [1×1 systemcomposer.arch.Architecture]
               Position: [15 15 65 76]
                  Model: [1×1 systemcomposer.arch.Model]
         SimulinkHandle: 2.0001
    SimulinkModelHandle: 1.2207e-04
                   UUID: 'c5ab7c89-3ebc-4a19-934b-9b0f473a0737'
            ExternalUID: ''

    Input Arguments

    collapse all

    Allocation scenario , specified as a systemcomposer.allocation.AllocationScenario object.

    Output Arguments

    collapse all

    Source elements from which specified target element is allocated, returned as an array of systemcomposer.arch.Element objects.

    An element object translates to a systemcomposer.arch.Component, systemcomposer.arch.VariantComponent, systemcomposer.arch.ComponentPort, systemcomposer.arch.ArchitecturePort, systemcomposer.arch.Connector, or systemcomposer.arch.PhysicalConnector object.

    More About

    collapse all

    Definitions

    TermDefinitionApplicationMore Information
    allocation

    An allocation establishes a directed relationship from architectural elements — components, ports, and connectors — in one model to architectural elements in another model.

    Resource-based allocation allows you to allocate functional architectural elements to logical architectural elements and logical architectural elements to physical architectural elements.
    allocation scenario

    An allocation scenario contains a set of allocations between a source and a target model.

    Allocate between model elements in an allocation scenario. The default allocation scenario is called Scenario 1.

    		Systems Engineering Approach for SoC Applications
    allocation set

    An allocation set consists of one or more allocation scenarios that describe various allocations between a source and a target model.

    Create an allocation set with allocation scenarios in the Allocation Editor. Allocation sets are saved as MLDATX files.

    Version History

    Introduced in R2020b

    See Also

    Tools

    Blocks

    Objects

    Functions

    Topics