move

Move element from one path to another

Syntax

opNew = move(op, oldPath, newPath)

Description

opNew = move(op, oldPath, newPath) returns a copy of the OperatingPoint object op, with an element at the specified location oldPath moved to the new location, specified by newPath. Use this function to update the operating point data after restructuring your model or renaming a block or subsystem.

Examples

Rename Element to Match New Block Name

When you rename a block in your model, use the move function to update the operating point data.

Open the Permanent Magnet DC Motor example model and create an OperatingPoint object named op using the Start values from the model:

openExample('simscape/PermanentMagnetDCMotorExample')
op = simscape.op.create(gcs, 'Start')

op = 

  OperatingPoint with children:

  OperatingPoints:

   ChildId         Size
   ______________  ____

   'DC Motor'       1x1
   'DC Voltage'     1x1
   'ERef'           1x1
   'Load Torque'    1x1
   'MRRef Motor'    1x1
   'MRRef Torque'   1x1
   'Sensing'        1x1
   'Step Input'     1x1

Select the DC Voltage block and find the relative path to this block in the operating point data hierarchy:

 oldPath = relativePath(op, gcb)

oldPath =

    'DC Voltage'

Rename the DC Voltage block to 1.5V.

Select the block again and find the new relative path:

 newPath = relativePath(op, gcb)

newPath =

    '1.5V'

Update the operating point data hierarchy to reflect the new block name:

op = move(op, oldPath, newPath)

op = 

  OperatingPoint with children:

  OperatingPoints:

   ChildId         Size
   ______________  ____

   '1.5V'           1x1
   'DC Motor'       1x1
   'ERef'           1x1
   'Load Torque'    1x1
   'MRRef Motor'    1x1
   'MRRef Torque'   1x1
   'Sensing'        1x1
   'Step Input'     1x1

Operating point op now lists 1.5V as its child.

Input Arguments

op — Operating point

OperatingPoint object

Original operating point in the workspace, specified as an OperatingPoint object.

oldPath — Relative path to original element

slash-delimited character vector or string scalar

Relative path to the original element in the operating point data tree, specified as a slash-delimited character vector or string scalar. The element can be a subsystem, block, or variable target.

Data Types: char | string

newPath — Relative path to new element

slash-delimited character vector or string scalar

Relative path to the new element in the operating point data tree, specified as a slash-delimited character vector or string scalar. The element can be a subsystem, block, or variable target.

Data Types: char | string

Output Arguments

opNew — New operating point

OperatingPoint object

New OperatingPoint object, which is a copy of the original OperatingPoint object, op, with element specified by oldPath moved to the new location, newPath. You can move elements recursively, that is, the name of the new OperatingPoint object, opNew, can be the same as the name of the original OperatingPoint object, op.

Version History

Introduced in R2017b