Main Content

gcs

Get path name of current system

collapse all in page

Syntax

gcs

Description

example

gcs returns the path name of the current system. The current system is one of these:

  • During editing, the system or subsystem most recently clicked or that contains the block most recently clicked

  • During simulation of a system that contains an S-Function block, the system or subsystem containing the S-Function block currently being evaluated

  • When a callback is invoked, the system executing the callback

  • During evaluation of MaskInitialization, the system containing the block whose mask is being evaluated

  • The system most recently loaded into memory with load_system; only the first use of load_system makes the model the current system

The current system is the current model or a subsystem of the current model. Use bdroot to get the current model.

If you close the model that contains the current system, another open or loaded system becomes the current one. Use gcs to find out the new current system.

To explicitly set the current system, you can either:

  • Use set_param with the 'CurrentSystem' parameter on the root Simulink® model, for example:

    set_param(0,'CurrentSystem','mymodel')

  • Open the model by using open_system or the model name at the MATLAB® command prompt.

Examples

collapse all

Return the path of the system that contains the most recently selected block.

Open the Model a Fault-Tolerant Fuel Control System example model sldemo_fuelsys. Open the subsystem To Controller. 

openExample('simulink_automotive/ModelingAFaultTolerantFuelControlSystemExample')
sldemo_fuelsys
open_system('sldemo_fuelsys/To Controller')

Click the Rate Transition block. Get the current system.

gcs
ans =

    'sldemo_fuelsys/To Controller'

Open the model f14 and get the current system.

f14
gcs
ans =

    'f14'

Load the model vdp using load_system. Then get the current system. 

load_system('vdp');
gcs

ans =

    'vdp'

To remove vdp from memory, close it. In this example, the current system becomes the open model, f14. 

close_system('vdp');
gcs

ans =

    'f14'

Version History

Introduced before R2006a

See Also

| |