PLECS 2.0 Online Help

Command Line Interface

PLECS offers a Command Line Interface (CLI) to access component and circuit parameters directly from the MATLAB command line. The command for the CLI is

plecsedit(’cmd’, ’parameter1’, ’parameter2’,...)

where cmd is one of the following commands: get, set, thermal, export, version, hostid.

Reading Parameters of Components

The command

plecsedit(’get’, ’componentPath’)
plecsedit(’get’, ’componentPath’, ’parameter’)

returns the value of parameter of the PLECS component indicated by the componentPath as a string. If parameter is omitted a cell array with all available parameters is returned.

Setting Parameters of Components

plecsedit(’set’, ’componentPath’, ’parameter’, ’value’)

sets the value of parameter of the PLECS component indicated by the componentPath to value.

Converting Thermal Descriptions

plecsedit(’thermal’, ’import’, valVon, valEon, valEoff)

imports the on-state voltage drop valVon and the switching losses valEon and valEoff into the thermal editor. The parameter valVon has to be a struct with two index vectors i, T and an output matrix v. The parameters valEon and valEoff have to be structs with three index vectors v, i, T and an output array E. The command can be used to import thermal descriptions as used in PLECS 1.x into the thermal library of PLECS 2.x.

plecsedit(’thermal’, ’export’, ’filename’)

reads the thermal data sheet from filename and returns a struct with the fields Von, Eon and Eoff containing the voltage drop and switching losses. The parameter filename has to be an absolute filename to the data sheet including the extension .xml.

plecsedit(’thermal’, ’export’, ’filename’, ’modelName’)

reads the thermal data sheet from filename and returns a struct with the fields Von, Eon and Eoff containing the voltage drop and switching losses. The parameter filename has to be a relative filename to the data sheet without the .xml extension.

Export for PLECS Viewer

plecsedit(’export’, ’modelName’)
plecsedit(’export’, ’modelName’, hideSchematics)
plecsedit(’export’, ’modelName’, hideSchematics, ’filename’)

exports the model modelName for the PLECS Viewer. By setting the optional argument hideSchematics to true all PLECS circuits are marked as non-viewable. If argument filename is given it is used as the exported model's filename, otherwise you are prompted for a filename.

Other CLI Commands

The command

plecsedit(’version’)

returns the PLECS version information as a string and

plecsedit(’hostid’)

returns a struct with hostid and MATLAB license information.

Examples

Some examples for using the command line interface:

plecsedit(’get’, ’mdl/Circuit1’)

returns the parameters of Circuit1 in the simulink model mdl.

plecsedit(’get’, ’mdl/Circuit1’, ’Name’)

returns the name of Circuit1.

plecsedit(’get’, ’mdl/Circuit1’, ’CircuitModel’)

returns the circuit simulation method of Circuit1.

plecsedit(’get’, ’mdl/Circuit1/R1’)

returns the parameters of component R1 in circuit Circuit1.

plecsedit(’set’, ’mdl/Circuit1/R1’, ’R’, ’2’)

sets the resistance of component R1 in circuit Circuit1 to 2.

plecsedit(’export’, ’mdl’, true, ’exported.mdl’)

exports the model mdl to the model file exported.mdl which can be opened with the PLECS Viewer. The contents of all PLECS schematics are hidden.

data = plecsedit(’thermal’, ’export’, ’Infineon/SDP04S60’, ...
  ’plSMPS_CCM’)

assigns the thermal description from library element Infineon/SDP04S60 in model plSMPS_CCM to the variable data in the MATLAB workspace.