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).
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.
- Blender 2.8+
- Python IDE (optional)
Installing the Blender Add-On
- Download the Quantum Microscope Add-On zip file at http://www.energywavetheory.com/project/qscope
- Open the Blender app (ensure that it is v2.8 or later)
- In Blender, under the Edit menu select Preferences
- Select Add-Ons
- Select Install and navigate to the quantum-microscope.zip file downloaded in step 1.
- 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:
- Open the Blender app, ensuring it is defaulted to the Layout workspace
- Open the Sidebar by selecting View->Sidebar. Alternatively, you may press the "N" key.
- The Sidebar should appear on the right of the Layout workspace. Select the Qscope tab.
- 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:
|Spacetime (e.g. neutrino)||/phase1/README.md|
|Particles (e.g. electron)||/phase2/README.md|
|Nucleons (e.g. protons)||/phase3/README.md|
|Atoms (e.g. hydrogen)||/phase4/README.md|
|Molecules (e.g. molecular hydrogen)||/phase5/README.md|
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/config.py file and make any necessary changes.
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 https://github.com/ewt-project/quantum-microscope
The root directory of the project contains the _init_.py file for the Blender UI. A folder for each phase of the project contains the code for that phase (e.g. quantum-microscope/phase1/spacetime.py for Spacetime). A common folder contains shared code and data across phases (quantum-microscope/common).
To develop and contribute to the add-on, first clone the project using the steps above. In the directory where the project was downloaded:
- 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).
- In Blender, go to the Scripting workspace (in the top menu).
- In the Scripting workspace, choose Open and find __init__.py in the project home directory (e.g. quantum-microscope/__init__.py), find the line with the add_on_mode variable and then make the following change:
add_on_mode = False
- In the Scripting workspace, choose Run Script.
- Follow the previous steps in Running the Simulation to run the add-on.
With the exception of changes to __init__.py, all changes to code in your local repository should be automatically reflected in the Blender simulation when your code is saved. The exception is __init__.py. Any changes to this file requires Run Script to be executed to test changes.
When development is complete, the packaging for the add-on may be tested with the following steps:
- In the __init__.py in the project home directory (e.g. quantum-microscope/__init__.py), make the following change:
add_on_mode = True
Create a .zip file of the entire project home directory (e.g. quantum-microscope.zip)
Follow the previous steps in this ReadMe for Installing the Blender Add-On, beginning with Step 3.
To commit any changes to the project, refer to the instructions page at: http://www.energywavetheory.com/project/competition-instructions
- Jeff Yee - Initial work
This project is licensed under the MIT License - see the LICENSE.md file for details
- Heinz-Dieter Hauger
- Lori Gardi
- Kuldeep Singh
- Chris Seely
- Terrence Howard
- Ted Bogner