Models in SIMPLIS are typically ASCII text and collected together in model files. These model files can be installed into SIMetrix/SIMPLIS, or the individual model text can be included in the schematic's F11 window. In this topic you will install a subcircuit capacitor model into the library system and verify it works by simulating the design.
To download the examples for Module 4, click Module_4_Examples.zip
In this topic:
This topic addresses the following key concepts:
In this topic, you will learn the following:
It is important to note that multiple models can be saved in a single file, hence the term model library file. The POP Trigger model is stored in the simplis_param.lb model file which contains several other models including the Electrolytic Capacitor model you viewed in section 3.0.2 What Actual Device is Simulated in SIMPLIS?
Models like the PERIODIC_OP subcircuit are stored in model files, and in the getting started example, the model library file name is simplis_param.lb. Model files must be installed in SIMetrix/SIMPLIS for the program to find the subcircuit models contained in the files. To view the model libraries which are currently installed, execute the SIMetrix/SIMPLIS menu bar: File > Model Library > View/Remove Libraries....
This dialog shows that two "libraries" are installed. Each library path includes the asterisk wildcard character (*), indicating that all files ending with a .lb extension located in the directory are installed. As these two entries include all built-in model libraries, we strongly suggest you not remove either one.
In this exercise you will install a subcircuit capacitor model into the library system. Using the open schematic, 4.2_LLC_Closed_Loop.sxsch, you will change the output capacitor from an ideal primitive capacitor to use this subcircuit capacitor, and note the change in output voltage waveforms.
The subcircuit capacitor was taken from the OS-CON website. This is a ladder model with 5 capacitors, 3 inductors, and 8 resistors. The model text is:
*1 SVPC-Series *$ .SUBCKT 2R5SVPC2700M 1 2 C_C1 6 7 2682.6u C_C2 1 4 1765.9u C_C3 1 3 900u C_C4 1 9 5000u C_C5 1 10 12000u L_L1 8 2 5.63n L_L2 4 6 0.88n L_L3 4 5 1.14n R_R1 7 8 4.4m R_R2 1 7 1900 R_R3 1 4 14.2m R_R4 4 6 107m R_R5 3 4 1.5m R_R6 9 3 5m R_R7 5 6 18m R_R8 10 9 25m .ENDS
Installing D:/Training/Module_4_Examples/2R5SVPC2700M.lb Model library changed. Rebuilding catalogs, please wait... Completed
SIMetrix/SIMPLIS installed the model file. This process includes scanning the model file, identifying which models are present, and building an index of these models. The index is used when SIMetrix/SIMPLIS netlists and preprocesses the netlist to speed up the model inclusion process.
The schematic is now configured to use the subcircuit capacitor defined in a model file. In the next exercise you will attempt to simulate the design.
In this exercise you will attempt to simulate the design using the installed model library file.
*** ERRORS REPORTED BY SIMPLIS *** **************************************** <<<<<<<< Error Message ID: 1023 >>>>>>>> input file D:\Training\Module_4_Examples\SIMPLIS_Data/4.2_LLC_Closed_Loop.deck, line 8: X$C3 19 39 2R5SVPC2700M Unable to locate the definition of `subcircuit 2R5SVPC2700M' in the input, include, or library file(s). *** END SIMPLIS ERROR REPORT ***
What happened? The circuit is properly configured to use a subcircuit model for C3. But the model cannot be found. The reason is the model is installed in the SIMetrix library and not the SIMPLIS one.
This common error is caused by the model being installed in the wrong library. The .SIMULATOR control tells SIMetrix/SIMPLIS to include the model in either the SIMetrix, SIMPLIS or both libraries. Without a .SIMULATOR SIMPLIS statement, models are installed in the SIMetrix library, and therefore cannot be found when the netlist preprocessor searches the SIMPLIS library to include the models.
In the next exercise you will add a .SIMULATOR SIMPLIS directive to the model library file.
When you added the .SIMULATOR statement to the library file, you told SIMetrix/SIMPLIS to include the 2R5SVPC2700M subcircuit in the SIMPLIS library. You now need to tell SIMetrix/SIMPLIS to rebuild the library catalogs so the model is included in the SIMPLIS catalog. You do this by executing the SIMetrix/SIMPLIS menu: File > Model Library > Re-build Catalog. This opens the following dialog:
After clicking on the Ok button, you will see the following message in the command shell:
Model library changed. Rebuilding catalogs, please wait... Completed
After you have rebuilt the model library catalogs, you are ready to run the simulation.
Models can also be included in the simulation deck by entering the model text in the Command (F11) window. In the next exercise, you will copy the text from the model file and paste it into the schematic's command (F11) window.
The .INCLUDE statement can be used to include text files in the simulation deck file. The include statement inserts an exact copy of the entire referenced file at the location of the .INCLUDE statement. This makes the .INCLUDE statement an easy way to include the model file in the deck.