deallocate

Delete allocation

Syntax

deallocate(allocScenario,sourceElement,targetElement)

Description

deallocate(allocScenario,sourceElement,targetElement) deletes allocation, if one exists, between a source and a target element.

Examples

Create Allocation Set and Deallocate Elements Between Models

% Create two new models with a component each
mSource = systemcomposer.createModel('Source_Model_Allocation',true);
sourceComp = mSource.Architecture.addComponent('Source_Component');
mTarget = systemcomposer.createModel('Target_Model_Allocation',true);
targetComp = mTarget.Architecture.addComponent('Target_Component');

% Create the allocation set with name 'MyNewAllocation'
allocSet = systemcomposer.allocation.createAllocationSet('MyNewAllocation',...
     'Source_Model_Allocation','Target_Model_Allocation');

% Get the default allocation scenario
defaultScenario = allocSet.getScenario('Scenario 1');

% Allocate components between models
allocation = defaultScenario.allocate(sourceComp,targetComp);

% Deallocate components between models
defaultScenario.deallocate(sourceComp,targetComp);

% Save the allocation set
allocSet.save;

% Open the allocation editor 
systemcomposer.allocation.editor()

Input Arguments

allocScenario — Allocation scenario

allocation scenario object

Allocation scenario to remove allocations from, specified as a systemcomposer.allocation.AllocationScenario object.

sourceElement — Source element to delete allocation

element object

Source element to delete allocation, specified as a systemcomposer.arch.Element object.

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

targetElement — Target element to delete allocation

element object

Target element to delete allocation, specified as a systemcomposer.arch.Element object.

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

More About

Definitions

Term	Definition	Application	More Information
allocation	An allocation is a directed relationship from an element in one model to an element 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.	Allocate Architectures in a Tire Pressure Monitoring System
allocation scenario	An allocation scenario contains a set of allocations between a source and target model.	Allocate between model elements within an allocation in an allocation scenario. The default allocation scenario is called Scenario 1.	Create and Manage Allocations
allocation set	An allocation set consists of one more allocation scenarios which describe various allocations between a source and target model.	Create an allocation set with allocation scenarios.	Create and Manage Allocations