SIMPLIS Parts

SPICE Model Installation Process

All SPICE models are installed using a common, two-step procedure:

• Step 1: Install the model
• Step 2: Associate model with category and symbol

If you already have a model file, you can use that file for these procedures. Otherwise, a sample file with three SPICE MOSFET models is available for download in Step 1. The three models in this sample file provide three different methods you can use to create the associations:

• The first model, example_model_1, is a definition that SIMetrix recognizes and automatically categorizes and associates with a symbol. For more information, see 2.1_Automatically associate a model with a category and symbol.
• The second model, example_model_2, requires you to select the model-library category and the symbol name. For more information, see 2.2 Manually associate a model with a category and symbol.
• The third model, example_model_3, has the associations embedded in the text file and can be used immediately after installation. This model-to-symbol association is defined in the model file on a single line that must appear inside the subcircuit definition that begins with the .SUBCKT line and ends with the .ENDS line. for more information, see 2.3  Embed the association in the model definition.

This tutorial also includes a method to remove an association. See Undo the model-to-symbol associations.

Step 1: Install the models

To use the sample models, follow these steps:

1. Right click the following link: model_examples.txt.
2. Select Save as..., and navigate to a convenient location to save the model for use in the next procedure..

To install either the example model file or your own model file, follow these steps:

1. Open Windows Explorer to the directory where you saved the model file and position the SIMetrix/SIMPLIS command shell so that you have access to both the Windows Explorer window and the command shell.
2. Drag and drop the file into the command shell.
3. Click OK at the prompt, confirming that you want to install the file.
   The command shell displays a message that the model library has changed and that the catalog rebuild is complete. If no message appears in the command shell, these models, most likely, already exist in the library.

Important: SIMetrix/SIMPLIS registers the full file path to the model file, and will look for your model in that file location. If you move the model file from the location where it was installed, you must repeat the installation process in this section.

If you installed your own model file, one of the following three sections will apply to the model-symbol association process. Simply follow these sections to see which applies to your model. A different example model is used in each section. Substitute your model name for the supplied model name in each procedural step.

▲ back to top

Step 2:  Associate model with category and symbol

This section describes three methods for associating a model with a category and symbol:

• 2.1  Automatically associate a model with a category and symbol
• 2.2  Manually associate a model with a category and symbol
• 2.3  Embed the association in the model definition

2.1  Automatically associate a model with a category and symbol

The first model, example_model_1, is one that SIMetrix can automatically associate with a model-library category and a symbol name.

Create a new schematic and then follow these steps:

1. From the schematic menu bar, select Place ▶ From Model Library...

   The Select Device dialog appears with the Recently Added Models category highlighted in the panel on the left. The new models from model_examples.txt appear in the selection pane on the right.

   
   
2. Highlight example_model_1.
   The following text appears in the lower left pane:
   SIMetrix does not know what symbol to use for this model.
3. Click the Place button.
   The Extract MOSFET Parameters dialog opens with default test conditions for this type of model. You can set these default test conditions in the SIMPLIS Options.

   

4. Make the appropriate changes to the test conditions for this model, and then click Extract.
   A progress bar appears and then the mouse cursor turns to the symbol and is ready to be placed on the schematic.
5. Click to put the associated symbol in an appropriate place on your schematic.

   For this type of model, no additional steps are required because SIMetrix is able to automatically categorize and associate the model with a symbol. This model example is now associated with an nmos_sub symbol and is categorized as NMOS in the SIMetrix/SIMPLIS library.

Note: If you installed your own model file, you may be presented with the "Associate Symbol with Model" dialog. If this dialog appears, you can skip ahead to step #2 in the next section.

▲ back to top

2.2  Manually associate a model with a category and symbol

The second model, example_model_2, falls into the class of models for which SIMetrix cannot determine the association and you must, therefore, select a category and an associated symbol.

To associate this model with a library category and a symbol, follow these steps:

1. From the schematic menu bar, select Place ▶ From Model Library...
   The Select Device dialog appears.
   
2. Highlight example_model_2.
   The following text appears in the lower left pane:
   SIMetrix does not know what symbol to use for this model.
3. Click the Place button.
   A dialog opens with a list of the categories and symbols that are required by SIMPLIS for the common semiconductor devices.
   
   Table 1. Common SPICE Model Types, Categories, and Symbol Names

   Model Type	Model Library Category	Symbol
   N-Channel MOSFET	NMOS	NMOS 3 Terminal
   P-Channel MOSFET	PMOS	PMOS 3 Terminal
   NPN Bipolar Transistor	NPN	NPN
   PNP Bipolar Transistor	PNP	PNP
   Diodes	Diodes	Junction Diode
   Schottky Diodes	Schottky Diodes	Schottky
   Zener Diodes	Zeners	Zener
   N-Channel JFET	N-Channel JFET	N-Channel JFET
   P-Channel JFET	P-Channel JFET	P-Channel JFET
   N-Channel GaN MOSFET	N-Channel JFET	N-Channel JFET
   P-Channel GaN MOSFET	P-Channel JFET	P-Channel JFET
   Insulated Gate Bipolar Transistor	IGBTs	IGBT

4. Click Close.
   OR
   To avoid seeing this dialog again, check "Don't show this message again." and then click Close.
   The Associate Models with Symbols dialog appears.
   
5. From the Choose Category... drop-down menu, select NMOS for this model example.
   Tip: To locate the category more quickly, type the first few letters of the category to move to that section of the list.
6. From the Define Symbol drop-down menu, select NMOS 3 Terminal.
   Tip: To locate the symbol more quickly, type the first few letters of the symbol to move to that section of the list and then use the scroll bar or arrow key if necessary to move down the list.
7. Click OK.
   The Extract MOSFET Parameters dialog opens with default test conditions for this type of model.
   
8. Make the appropriate changes to the test conditions for this model, and then click Extract.
   A progress bar appears and then the mouse cursor turns to the symbol and is ready to be placed on the schematic.
9. Click to put the associated symbol in an appropriate place on your schematic.

   This model example is now  is categorized as NMOS in the SIMetrix/SIMPLIS library and associated with the symbol for an NMOS 3 Terminal (nmos_sub).

▲ back to top

2.3  Embed the association in the model definition

The third model, example_model_3, has the following extra line in the model definition just after the .SUBCKT information:

*#ASSOC Category=NMOS Symbol=nmos_sub

1. • The first portion of the line, *#ASSOC, is a keyword that tells SIMetrix to expect a model-library category and a symbol name on the same line.
   • The second portion of the line, Category=NMOS, defines the model-library category.
   • The third portion, Symbol=nmos_sub, defines which symbol name to associate with this model.

Note: Since this line is a comment, it has no electrical significance in the model.

Because the model is already associated with a model-library category and symbol, it can be placed on a schematic directly.

1. From the schematic menu bar, select Place ▶ From Model Library....
2. Highlight example_model_3.
   The symbol appears in the lower-left pane of the Select Device dialog, indicating that the model has a symbol association.
   
3. Click the Place button.
   The Extract MOSFET Parameters dialog opens with default test conditions for this type of model.
   
4. Make the appropriate changes to the test conditions for this model, and then click Extract.
   A progress bar appears and then the mouse cursor turns to the symbol and is ready to be placed on the schematic. The mouse cursor turns into the symbol and is ready to be placed on the schematic.
5. Click to put the associated symbol in an appropriate place on your schematic.
   The MOSFET is now placed on the schematic without any intervention by SIMetrix.

To save and close your schematic, select File ▶ Close and select a convenient location to store the schematic file.

▲ back to top

Undo the model-to-symbol associations

At times, models are accidentally associated with the wrong symbols. Although no built-in support is available for removing associations within SIMetrix, you can do this manually with a text editor. The user-defined model-to-symbol associations are stored in a text file in the Application Data directory.

Note: This procedure is for a typical installation of the Windows operating system. If the following steps fail, search your drive(s) for the file, user_v2.cat.

To edit user_v2.cat and remove associations for the two models that did not have associations embedded in the file, follow these steps:

1. Open a Windows Explorer window.
2. Choose an appropriate path from the following table:
   

   If your version is ...	Use this path ...
   SIMetrix/SIMPLIS Intro, version 7.0	%appdata%\SIMetrix Technologies\SIMetrixIntro700\devdb\user
   SIMetrix/SIMPLIS full version 7.00	%appdata%\SIMetrix Technologies\SIMetrix700\devdb\user
   Other versions	Replace the "SIMetrix700" with the appropriate version number; for example, for version 7.10, use "%appdata%\SIMetrix Technologies\SIMetrix710\devdb\user"

3. Paste the appropriate path identified in step 2 into the file path field at the top of the Windows Explorer window.
4. To open the user_v2.cat file with a text editor, select the file, right click, and select Open with..., and choose a text editor, such as Notepad.
   The file opens in a text editor.
   If both example_model_1 and example_model_2 were installed, the user_v2.cat file would have these two entries:
   example_model_1,3;nmos_sub;;NMOS;;;
   example_model_2,3;nmos_sub;;NMOS;;;
5. To remove an association, delete the entire line from this file and then save it.

Note: The embedded associations are not stored in this file, rather the association is stored in the model library file.

▲ back to top

© 2015 simplistechnologies.com | All Rights Reserved