Documentation Center

  • Trial Software
  • Product Updates

new_system

Create empty Simulink system

Syntax

new_system(sys)
new_system(sys, model)
new_system(sys, model, subsystem_path)
new_system(sys, model, 'ErrorIfShadowed')
new_system(sys, 'Library')
h = new_system(sys)

Description

new_system(sys) or new_system(sys, model) creates an empty system where sys is the name of the new system. This command displays an error if sys is a MATLAB® keyword, 'simulink', or more than 63 characters long.

new_system(sys, model, subsystem_path) creates a system from a subsystem where subsystem_path is the full path of the subsystem. The model that contains the subsystem must be open when this command is executed.

new_system(sys, model, 'ErrorIfShadowed') creates an empty system having the specified name. This command generates an error if another model, MATLAB file, or variable of the same name exists on the MATLAB path or workspace.

new_system(sys, 'Library') creates an empty library.

h = new_system(sys) returns the numeric handle of the system that has been created. You can pass h to any of the Simulink® API functions, for example, open_system(h).

    Note   The new_system command does not open the window of the system or library that it creates.

See Model Parameters and Block-Specific Parameters for a list of the default parameter values for the new system.

Examples

This command creates a new system named 'mysys'.

new_system('mysys')

The command

new_system('mysys','Library')

creates, but does not open, a new library named 'sys'.

The command

new_system('vdp','Model','ErrorIfShadowed')

returns an error because 'vdp' is the name of a model on the MATLAB path.

The commands

load_system('f14')
new_system('mycontroller','Model','f14/Controller') 

create a new model named mycontroller that has the same contents as does the subsystem named Controller in the f14 model.

The commands

 h = new_system('mymodel')
h =
     3.0012

>> get_param(h,'Name')
ans =
   mymodel

 open_system(h) 

return the numeric handle of the system that has been created, and use that handle to get parameters and open the model.

See Also

| |

Was this topic helpful?