mobile-main-menu-button
Menu

How can we help? What do you want to learn? Search our knowledgebase.

AfterMath EIS Circuits: Custom Models and Descriptor Syntax

Last Updated: 9/23/20 by Neil Spinner

ARTICLE TAGS
  • aftermath circuit fit,
  • circuit fit,
  • syntax,
  • EIS circuit syntax,
  • custom circuit,
  • user built circuit
Article Contents/Section Navigation
  1. Selecting an EIS Circuit
    1. User-Defined Circuits: GUI
    2. User-Defined Circuits: Descriptor Entry and Syntax

1Selecting an EIS Circuit

When performing an EIS Circuit Fit or Circuit Simulation in AfterMath, the user has two options: (1) select a circuit from the set of Built-In Circuits; or (2) construct a User-Defined Circuit.  Upon adding the new Circuit Fit or Circuit Simulation node, the Circuit Library window will appear, as shown below in Figure 1:
 
EIS Circuit Library in AfterMath

Figure 1. EIS Circuit Library in AfterMath

 
Any previously-saved User-Defined Circuits will appear in the bottom section and may be selected again.  Double-clicking on any circuit in either list will select that circuit for fitting or simulation.
Back To Top

1.1User-Defined Circuits: GUI

The most common method of constructing a new User-Defined Circuit is by double-clicking "New...", then using the graphical user interface (GUI) in the circuit designer window that appears, as shown in Figure 2:
 
AfterMath Circuit Designer Window

Figure 2. AfterMath Circuit Designer Window

 
Circuit elements can be dragged-and-dropped from the right side into the blank space, then the left and right terminals connected as desired to form a custom circuit, as shown in Figure 3:
 
Drawing Custom Circuits with AfterMath Circuit Designer GUI

Figure 3. Drawing Custom Circuits with AfterMath Circuit Designer GUI

 
Once the circuit has been drawn and all terminals connected as desired, it is good practice to verify the circuit is valid.  The checkbox at the top left of the designer window can be clicked, and AfterMath will indicate whether the circuit is valid (Figure 4) or invalid, including what issues must be rectified (Figure 5).
 
AfterMath Custom Circuit Validation Check with Valid Circuit

Figure 4. AfterMath Custom Circuit Validation Check with Valid Circuit

 
AfterMath Custom Circuit Validation Check with Invalid Circuit

Figure 5. AfterMath Custom Circuit Validation Check with Invalid Circuit

 
If the circuit is valid, it can be saved.  A name must be given in the box at the top labeled "Name:", then the save icon can be clicked, as shown in Figure 6:
 
Saving Custom Circuit in AfterMath

Figure 6. Saving Custom Circuit in AfterMath

 
After saving the circuit, the X in the upper right of the designer window can be clicked, and then the custom circuit will be visible in the list of User-Defined Circuits, as shown in Figure 7.  This circuit can now be selected for fitting or simulation.
 
Circuit Library with Saved Custom Circuit

Figure 7. Circuit Library with Saved Custom Circuit

Back To Top

1.2User-Defined Circuits: Descriptor Entry and Syntax

An alternate way to create a User-Defined Circuit is by using the notepad icon at the top of the designer window.  When this icon is clicked, a Descriptor Entry window appears.  In this window, a circuit can be added manually by typing in the appropriate syntax (see Figure 8).
 
AfterMath EIS Circuit Descriptor Entry Syntax Window

Figure 8. AfterMath EIS Circuit Descriptor Entry Syntax Window

 
Each circuit in the AfterMath Circuit Library, whether Built-In or User-Defined, has both a Descriptor and a Name.  These fields cannot be changed for the Built-In Circuits.  When creating a User-Defined Circuit using the GUI, a unique name must be given to save the circuit into the library, as shown in Section 1.1 and Figure 6.  Additionally, a Descriptor will be automatically generated from the drawn circuit.
 
When entering a circuit descriptor to create a custom circuit, the proper syntax must be used.  The Descriptor Entry will alert the user while typing a circuit whether the circuit syntax is valid but incomplete (yellow), or invalid (red), as shown in Figure 8.  Below are the rules for circuit syntax in AfterMath:
 
Descriptor Meaning
R Resistor
C Capacitor
Q Constant Phase Element (CPE)
L Inductor
W Infinite Warburg
Ws Warburg Short (or Warburg Absorbing)
Wo Warburg Open (or Warburg Reflecting)
G Gerischer Element
TxL Transmission Line
s in series (goes between circuit elements)
p in parallel (goes between circuit elements)
parentheses ( ) groups circuit elements, similar to mathematics rules
Table 1. Circuit Descriptor Syntax in AfterMath

NOTE: It is advised to not create a custom circuit including a transmission line using the Descriptor Entry box.  Create TxL elements using the GUI instead.

All circuit elements are accompanied by a number, and all elements must have a distinct name.  For example, "R1", "R2", and "R3".  It is also not required to start at the index of 1 for each element.  Additionally, once any custom circuit has been created, whether via the Descriptor Entry box or the GUI, any individual circuit element can be renamed as desired.
Back To Top
Questions? Find Answers.

Our knowledgebase is the central repository for written content, including help topics, theory, application notes, specifications, and software information.

Select a category below or view the Knowledgebase home page
Software

Detailed information about our Software, which includes AfterMath and retired PineChem.

Applications

Application notes discuss practical aspects of conducting specific experiments.

Theory

Fundamental electrochemical theory presented in a brief and targeted manner.

Product Specifications

Review complete product specifications and compare products within a category here.