Clone the repository using

git clone https://github.com/StunningLlama/SemiSim.git

Building requres Java 1.8 and Maven for dependency management.

• Go to File > Import > Existing Maven Projects
• Select the cloned repository folder
• Click Finish

Brandon's semiconductor simulator (SemiSim) is an educational tool made with the original purpose of helping its creator understand semiconductor devices. It is fully interactive, letting users draw circuits and create their own devices in a manner similar to painting software. There is a wide variety of different materials to choose from and many ways to visualize the electromagnetic phenomena associated with semiconductors. Users can either load one of the many premade simulations or create their own.

The simulation is set on a two-dimensional grid over which it solves the 2D Maxwell equations. The electric field lies in the same plane as the surface of the screen whereas the magnetic field is perpendicular to it. On top of this, there are two types of charge carriers, electrons and holes, which feel electric and chemical forces that determine their dynamics. The simulation uses a FDTD (finite-difference time domain) scheme obtained by discretizing the Maxwell equations and the drift-diffusion equations and coupling the two together. This results in a simulation that demonstrates many of the important properties of semiconductors and semiconductor devices, such as:

• PN junctions
• Metal-semiconductor junctions
• Field effect transistors
• Galvani potential
• Thermoelectricity

Because the simulation uses a very simplified model of how semiconductors work, it is not able capture some phenomena that show up in real systems. Things that the simulation cannot handle include:

• Metal band structures
• Electrical breakdown
• Kinetic effects
• Quantum tunelling
• Velocity saturation
• Fermi level pinning
• Different recombination mechanisms

Finally, certain properties of materials differ from their real life counterparts (for example, the charge carrier mobility of the semiconductor material is about 1500x greater than that of Silicon). This was done for educational purposes.

The interface consists of the simulation area which the user can interact with and the settings panel containing all the simulation controls.

Simulation area (purple, left) and settings (blue, right).

The main way to interact with circuits is to change the strength of voltage sources and turn switches on and off. The quickest way to get started is to load one of the examples and start changing the voltages.

Arrows: The direction and brightness of arrows corresponds to the direction and magnitude of the vector field.

Lines: The brightness and density of lines indicates the magnitude of the field.

Dots [desktop]: The velocity of the dots is proportional to the value of the vector field.

Contour [desktop]: Contour lines indicate a region on which the scalar field has a constant value.

Charge carriers [desktop]: Electrons and holes are represented as blue and red dots, respectively. Both dots move at the actual drift velocities of their corresponding charge carriers and their density accurately reflects the density of charge carriers. This is much more realistic but less flexible than the dots view.

Interact	Allows user to control voltage sources and turn switches on and off by clicking.
Draw	Adds material to the field.
Voltage	Adds a voltage probe that measures electrochemical potential at a certain point (See "What do voltmeters actually measure").
Current [click and drag]	Adds a current probe that measures current across a wire.
Ground	Specifies the point relative to which probes measure voltage (optional).
Delete probe	Click to delete a probe.
Plot bands [click and drag, desktop]	Specifies a 1D line along which the bands are plotted. The plot contains the conduction and valence energy band edges as well as the quasi-Fermi levels of electrons in both bands. Valence and conduction band energies shown as solid lines. Quasi-Fermi levels are dashed lines.
Plot scalar field [click and drag, desktop]	Makes a plot of the currently selected scalar field.
Plot carriers [click and drag, desktop]	Makes a logarithmic plot of the number density of electrons and holes.
Flashlight [click and hold, desktop]	Shines a light on the region under the cursor. Light generates electron and hole pairs.
Replace	Similar to the draw tool, but overwrites occupied areas.
Line [click and drag]	Draws a line of material.
Fill	Fills a region with a certain material, similar to the bucket tool.
Erase	Erases material.
Select	Makes a rectangular selection which can be dragged around and moved.
Select region	Selects a contiguous region, similar to the bucket tool.
Text	Place a text cursor allowing text to be typed on the screen.

Colors of all the materials.

I created this simulator because I wanted to get a deeper understanding of how semiconductors work. It's been my experience that there's been a lack of good simulations that demonstrate advanced topics in physics. There certaintly exists many educational physics simulations, but they're all either aimed at lower educational levels, or they are very restricted in how the user can interact with the system. The only examples I've seen of simulations that combine advanced topics with a generous amount of interactivity are the physics applets written by Paul Falstad, to whom I'm also grateful for looking over my project and helping to convert it to Javascript. I've tried to give users many different ways of interacting with the simulation. Circuits can be drawn with just a few clicks of the mouse, allowing users to easily experiment with their own circuits. There are also many different ways of visualizing the underlying physics that I've incorporated into the settings. Each one gives a different perspective on the physics that is happening.

In general, the color red is associated with either holes or a positive charge. Blue represents electrons or negative charge. White means both electrons and holes exist a location. In the rest of the cases, yellow represents a positve quantity (eg. chemical potential or magnetic field), while cyan is negative. Finally, green is used for quantites that are always positive (eg. energy density). Note: Each material also has its own color which is unrelated to the aforementioned color scheme.

You might notice that the reading from a voltage probe doesn't match the electric potential Φ. In reality, voltmeters do not measure Φ but rather differences in electrochemical potential of charge carriers. Things get a bit trickier when we ask what the voltage is in a piece of semiconductor, becuase now there are multiple charge carriers! In this case we can try to define voltage as the reading we get when we stick a small metallic probe at a certain point. This can actually be performed in the simulation, and the result is that the electrochemical potential of the metal lies between that of electrons and holes, closer to whichever one has a larger density. I approximate this with a simple weighted average, the result of which is displayed on the voltage probe.

Because the simulation is in 2D, circuits actually extend infinitely in the z-direction (out of the page), so current flowing through a closed circuit has the same effect as current flowing through a 3D solenoid. If you recall from E&M class, the magnetic field within an infinitely long solenoid is entirely contained within it. This is certainly a point of departure from how we expect circuits to behave. It means that each current loop has its own inductance, and trying to create "inductors" that behave like their 3D counterparts is quite tricky.

Copyright (c) 2025 Brandon Li
brandonli.lex@gmail.com