Main Content

ee_importDeviceParameters

Import device parameters from XML file to Simscape Electrical IGBT (Ideal, Switching), MOSFET (Ideal, Switching), and Diode blocks

Since R2021b

Description

example

ee_importDeviceParameters(file,"hitachi",blockPath) extracts the device parameters from an XML file, file, and imports them to the Simscape™ block at the specified blockPath, and imports them using the Hitachi parameterization format to the Simscape block.

The XML file must be on the MATLAB path and must use a parameterization format supported by Hitachi.

For the "hitachi" format, this function supports these blocks:

For examples of Hitachi format XML files for IGBT and diode devices, see the Insulated Gate Bipolar Transistor (IGBT) and diode modules with SPT, SPT+, SPT++ and TSPT+ chips page on the Hitachi website.

ee_importDeviceParameters(file,"infineon",blockPath,GateResistanceOn=Rgon,GateResistanceOff=Rgoff) extracts the parameters from an XML file, file, and imports them using the Infineon parameterization format to the Simscape block at the specified blockPath. Infineon datasheets include dependencies with respect to the switch-on and switch-off gate resistance values. This function allows you to select the values of the switch-on and switch-off gate resistance by specifying the GateResistanceOn and GateResistanceOff arguments.

The XML file must be on the MATLAB path and must use a parameterization format supported by Infineon.

For the "infineon" format, this function supports these blocks:

For examples of Infineon format XML files for IGBT devices, see the IGBTs – Insulated Gate Bipolar Transistors page on the Infineon website.

ee_importDeviceParameters(___,Verbose=true) also enables warnings about unused fields in the XML file.

ee_importDeviceParameters(___,Verbose=false) also disables warnings about unused fields in the XML file.

Note

After you run the ee_importDeviceParameters function, check for parameters that contain % Parameter not set in their value. The function automatically assigns these parameters their default values after the parameterization.

If you simulate a model that contains this block and you do not obtain the expected results, modify these parameters. If modifying these parameters is not enough, change the modeling options for the block, such as the fidelity level or the charge dynamics. The ee_importDeviceParameters function parameterizes the block only for a specific fidelity level. If you change the fidelity level, the simulation results are different.

Examples

collapse all

Choose the block you want to import the parameters into. Open a model that contains an IGBT (Ideal, Switching) block.

openExample("simscapeelectrical/ImportIGBTFromHitachiExample")

Edit the ee_import_igbt_device_parameters_data.xml file to inspect the content.

edit ImportIGBTFromHitachiData.xml 

Click the IGBT (Ideal, Switching) block, then call the ee_importDeviceParameters function.

ee_importDeviceParameters("ImportIGBTFromHitachiData.xml","hitachi",gcb)

Input Arguments

collapse all

Name of the XML file that you want to import and extract the parameters from, specified as a case-sensitive string.

Block path or handle of the IGBT (Ideal, Switching), Diode, or MOSFET (Ideal, Switching) block that you want to import the parameters into, specified as a character vector or block handle.

Since R2024a

Switch-on gate resistance for the Infineon device, specified as a positive scalar.

To enable this argument, set the format argument to "infineon".

Since R2024a

Switch-off gate resistance for the Infineon device, specified as a positive scalar.

To enable this argument, set the format argument to "infineon".

Whether to enable warnings about unused fields in the XML file when you use this function, specified as true or false.

Version History

Introduced in R2021b

expand all