⚡ WireWorld Simulation

A Python-based simulation of the WireWorld cellular automaton using the Tkinter library.
The application allows users to create their own WireWorld patterns, visualize electron movement, and explore how simple rules can be used to simulate digital circuits and computational systems.

🔎 Preview

⚙️ Features

• Interactive grid-based WireWorld simulation.
• Create WireWorld patterns using click & drag mouse interaction.
• Cycle through the four WireWorld cell states:
  • Empty (black)
  • Conductor (yellow)
  • Electron Head (red)
  • Electron Tail (blue)
• Simulate one step at a time using the Cycle button.
• Run continuous simulations using the Play button.
• Pause simulations using the Stop button.
• Reset the grid and clear all cells using the Reset button.
• Display the fundamental WireWorld rules through the built-in help menu.
• Includes an inspiration sheet with examples of logic gates and electronic components.
• Implements the Moore neighborhood concept to determine neighboring electron heads.

💻 Installation & Running

1. Clone the repository:

git clone https://github.com/Royaltyclaws22/WireWorld-Simulation.git

2. Navigate to the project folder:

cd WireWorld-Simulation

3. Run the program:

python WireWorld_Simulation.py

Make sure that the image file Inspiration.png is located in the same directory as WireWorld_Simulation.py.

💡 Usage

• Left click on a cell to change its state.
• Click & drag across the grid to quickly create WireWorld patterns.
• Cells change state in the following order:
  • Empty → Conductor → Electron Head → Electron Tail → Empty
• Press Cycle to advance the simulation by one generation.
• Press Play to automatically run the simulation continuously.
• Press Stop to pause the simulation.
• Press Reset to clear the grid and return all cells to the Empty state.
• Open the Help menu to view the WireWorld rules and additional information.