Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Quantum Microcope

Quantum Microscope is an open source add-on to Blender, simulating subatomic particles and the formation of matter using classical physics. It provides a microscopic look at molecules, atoms, atomic nuclei, particles and spacetime, using the theoretical model from Energy Wave Theory (EWT).

Getting Started

These instructions enable the add-on to be run on a local machine and provide access to the source files to contribute to the ongoing development of the project.


Installing the Blender Add-On

  1. Download the Quantum Microscope Add-On zip file at
  2. Open the Blender app (ensure that it is v2.8 or later)
  3. In Blender, under the Edit menu select Preferences
  4. Select Add-Ons
  5. Select Install and navigate to the file downloaded in step 1.
  6. Select the checkbox next to "Quantum Microscope" to enable the add-on

Running the Simulation

Starting a Simulation

There are multiple simulations in the Quantum Microscope add-on. Once the add-on is successfully installed, the following steps may be taken to run a simulation:

  1. Open the Blender app, ensuring it is defaulted to the Layout workspace
  2. Open the Sidebar by selecting View->Sidebar. Alternatively, you may press the "N" key.
  3. The Sidebar should appear on the right of the Layout workspace. Select the Qscope tab.
  4. Select the Run "X" button under the Simulator panel to run each type of simulation (X)

Changing the Simulation Type

The simulation has multiple types, representing a greater zoom factor, from the smallest particles to molecules. Each type assumes the physics of a previous phase (type) which is re-used for scalability. For example, the physics of a standing wave is proven in Phase 1 Spacetime for efficiency in Phase 2 Particles.

Each simulation has its own panel with various UI options to control the simulation. After changing UI controls, the simulation is started by selecting the "Run X" button, where X is the simulation type. The UI options and suggested steps to run in each simulation type is addressed in its own ReadMe file:

Simulation Type README
Spacetime (e.g. neutrino) /phase1/
Particles (e.g. electron) /phase2/
Nucleons (e.g. protons) /phase3/
Atoms (e.g. hydrogen) /phase4/
Molecules (e.g. molecular hydrogen) /phase5/

Changing Additional Configuration Variables

The simulator has additional configuration options not exposed in the UI. These additional config options require editing a text file. Using a text editor, open the common/ file and make any necessary changes.

Built With

  • Blender - 3D creation suite
  • Python - Programming language within Blender


Simulating with 100% real physics requires changes to the scripts or Blender's physics engine. Developers may wish to contribute and enhance the simulation. Each simulation type has its own ReadMe file (see table above), detailing what needs to be improved or corrected. There are also TODOs marked in the Python scripts. Refer to the EWT Project for general information about the project and the initial requirements for the simulator.

The project source code may be downloaded from GitHub at:

git clone

The root directory of the project contains the file for the Blender UI. A folder for each phase of the project contains the code for that phase (e.g. quantum-microscope/phase1/ for Spacetime). A common folder contains shared code and data across phases (quantum-microscope/common).

Development Mode

To develop and contribute to the add-on, first clone the project using the steps above. In the directory where the project was downloaded:

  1. Open Blender and save a new file to the project home directory (e.g. quantum-microscope/Simulator.blend). In development mode, the Blender file must be in this directory (not required for the add-on).
  2. In Blender, go to the Scripting workspace (in the top menu).
  3. In the Scripting workspace, choose Open and find in the project home directory (e.g. quantum-microscope/, find the line with the add_on_mode variable and then make the following change:
add_on_mode = False
  1. In the Scripting workspace, choose Run Script.
  2. Follow the previous steps in Running the Simulation to run the add-on.

With the exception of changes to, all changes to code in your local repository should be automatically reflected in the Blender simulation when your code is saved. The exception is Any changes to this file requires Run Script to be executed to test changes.

Add-On Mode

When development is complete, the packaging for the add-on may be tested with the following steps:

  1. In the in the project home directory (e.g. quantum-microscope/, make the following change:
add_on_mode = True
  1. Create a .zip file of the entire project home directory (e.g.

  2. Follow the previous steps in this ReadMe for Installing the Blender Add-On, beginning with Step 3.

Committing Changes

To commit any changes to the project, refer to the instructions page at:


  • Jeff Yee - Initial work


This project is licensed under the MIT License - see the file for details


  • Heinz-Dieter Hauger
  • Lori Gardi
  • Kuldeep Singh
  • Chris Seely
  • Terrence Howard
  • Ted Bogner


To simulate the creation of particles, atoms and matter with classical physics, illustrating that the universe operates under a single set of laws.







No releases published


No packages published