Simulink.BlockPath

Fully specified Simulink block path

Description

A Simulink.BlockPath object represents a fully specified block path that uniquely identifies a block within a model hierarchy, even when the model hierarchy references the same model multiple times.

Creation

Use either the Simulink.BlockPath or gcbp function to create a Simulink.BlockPath object. To get a Simulink.BlockPath object for the most recently clicked or loaded block, use the gcbp function.

Syntax

bp = Simulink.BlockPath

bp = Simulink.BlockPath(blockpath)

bp = Simulink.BlockPath(paths)

bp = Simulink.BlockPath(paths,subpath)

Description

bp = Simulink.BlockPath creates an empty BlockPath object.

bp = Simulink.BlockPath(blockpath) creates a copy of the specified BlockPath object.

bp = Simulink.BlockPath(paths) creates a BlockPath object from the specified character vector or cell array of character vectors. Each character vector represents a path at a level of the model hierarchy. Simulink^® builds the full block path based on the character vectors.

bp = Simulink.BlockPath(paths,subpath) additionally specifies an individual component of the block, such as a signal, that you specify with the subpath argument.

Input Arguments

blockpath — Existing BlockPath object

BlockPath object

Existing BlockPath object that you want to copy, specified as a BlockPath object.

paths — Paths used to build block path

character vector | cell array of character vectors

Paths used to build the block path, specified as a character vector or cell array of character vectors.

Specify each character vector in order, from the top model to the specific block for which you are creating a BlockPath object.

Each character vector must be a path to a block within the Simulink model. The block must be:

• A block in a single model

• A Model block (except for the last character vector, which may be a block other than a Model block)

• A block in the model referenced by the Model block that the previous character vector specifies

subpath — Individual component of block

character vector

Individual component of a block, such as a signal, specified as a character vector.

Properties

SubPath — Component of block

'' (default) | character vector

Component of the block, specified as a character vector that provides the block path. For example, if the block path refers to a Stateflow^® chart, you can use SubPath to indicate the chart signals.

Example: 'gear_state.first'

Data Types: char

Object Functions

convertToCell	Convert block path to cell array of character vectors
getBlock	Get single block path in model reference hierarchy
getLength	Get number of hierarchy levels in block path
open	Open specified model, library, subsystem, or block
validate	Determine whether block path represents valid block hierarchy

Examples

Create Simulink.BlockPath Object Using Cell Array

Open the project named ModelReferenceHierarchy.

openProject("ModelReferenceHierarchy");

The project opens a model hierarchy with sldemo_mdlref_depgraph as the top model.

Create a Simulink.BlockPath object named bp by using a cell array of character vectors that represent elements of the block path.

bp = Simulink.BlockPath(...
    {'sldemo_mdlref_depgraph/thermostat',...
    'sldemo_mdlref_heater/Fahrenheit to Celsius',...
    'sldemo_mdlref_F2C/Gain1'})

bp = 
  Simulink.BlockPath
  Package: Simulink

  Block Path:
    'sldemo_mdlref_depgraph/thermostat'
      'sldemo_mdlref_heater/Fahrenheit to Celsius'
        'sldemo_mdlref_F2C/Gain1'

  Use the getBlock method to access block path character vectors from this object.

The resulting block path identifies the block within the model reference hierarchy.

Version History

Introduced in R2010b