Main Content

open_system

Open model, library, subsystem, or block dialog box

Description

example

open_system(obj)opens the specified model, library, subsystem, or block. This is equivalent to double-clicking the model or library in the Current Folder Browser, or the subsystem or block in the Simulink®Editor.

A model or library opens in a new window. For a subsystem or block within a model, the behavior depends on the type of block and its properties.

  • Any OpenFcn callback parameter is evaluated.

  • If there is no OpenFcn callback, and a mask is defined, the mask parameter dialog box opens.

  • Without an OpenFcn callback or a mask parameter, Simulink opens the object.

    • A referenced model opens in a new window.

    • A subsystem opens in a new tab in the same window.

    • For blocks, the parameters dialog box for the block opens.

To open a specific subsystem or block, you must load the model or library containing it. Otherwise Simulink returns an error.

You can override the default behavior by supplying a second input argument.

example

open_system(sys,'loadonly')loads the specified model or library without opening the Simulink Editor. This is equivalent to usingload_system.

example

open_system(sbsys,'window')opens the subsystemsbsysin a new Simulink Editor window. Before opening a specific subsystem or block, load the model or library containing it. Otherwise Simulink returns an error.

open_system(sbsys,'tab')opens the subsystem in a new Simulink Editor tab in the same window. Before opening a specific subsystem or block, load the model or library containing it. Otherwise Simulink returns an error.

example

open_system(blk,'mask')opens the mask dialog box of the block or subsystem specified byblk. Load the model or library containingblkbefore opening it.

open_system(blk,'force')看起来的面具下掩盖了块或subsystem. It opens the dialog box of the block under the mask or opens a masked subsystems in a new Simulink Editor tab. This is equivalent to theLook Under Maskmenu item. Before opening a specific subsystem or block, load the model or library containing it. Otherwise Simulink returns an error.

open_system(blk,'parameter')opens the block parameter dialog box.

open_system(blk,'OpenFcn')runs the block callbackOpenFcn.

Examples

collapse all

Open thef14model.

open_system('f14')

Load thef14model.

open_system('f14','loadonly')

Open the Controller subsystem of thef14model.

load_system('f14') open_system('f14/Controller')

Open the f14 model and open theControllersubsystem in a new tab.

f14 open_system('f14/Controller','tab')

Open a subsystem in its own Simulink Editor window.

open_system('f14') open_system('f14/Controller','window')

Open the modelsldemo_mdlref_counter, which is referenced by the CounterAModelblock insldemo_mdlref_basic.

openExample('sldemo_mdlref_basic') open_system('sldemo_mdlref_basic/CounterA')

The referenced model opens in its own Simulink Editor window as a top model. To open the referenced model in the context of a model hierarchy, use theopenfunction with aSimulink.BlockPathobject.

Open the block parameters dialog box for the first Gain block in theControllersubsystem.

load_system('f14') open_system('f14/Controller/Gain')

Define anOpenFcncallback for a block and execute the block callback.

f14 set_param('f14/Pilot','OpenFcn','disp(''Hello World!'')') open_system('f14/Pilot','OpenFcn')

The wordsHello Worldappear on the MATLAB Command Prompt.

Open the contents of the masked subsystem Pump in the modelsldemo_hydcyl.

openExample('sldemo_hydcyl') open_system('sldemo_hydcyl/Pump','force')

Create a cell array of two model names,f14andvdp. Open both models usingopen_systemwith the cell array name.

models = {'f14','vdp'} open_system(models)

Input Arguments

collapse all

Model, referenced model, library, subsystem, or block path, specified as a character vector. If the model is not on the MATLAB path, specify the full path to the model file. Specify the block or subsystem using its full name, e.g.,f14/Controller/Gain, on an opened or loaded model. On UNIX®systems, the fully qualified path name of a model can start with a tilde (~), signifying your home directory.

Data Types:char

The full name or path of a model or library, specified as a character vector.

Data Types:char

The full name or path of a subsystem in an open or loaded model, specified as a character vector.

Data Types:char

The full name or path of a block or subsystem in an open or loaded model, specified as a character vector.

Data Types:char

Tips

To open a referenced model in the context of a model hierarchy, use theopenfunction with aSimulink.BlockPathobject.

版本历史

Introduced before R2006a