Files
quantum-math-lab/README.md
blackboxprogramming d7ded89444 Add README.md
2025-07-24 02:34:49 -07:00

21 lines
2.3 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Quantum Math Lab
Quantum Math Lab is an educational project that combines a **simple quantumcomputing simulator** with an exploration of some of the most famous unsolved problems in mathematics. The goal of this repository is twofold:
1. **Quantum Computing Simulation** provide a minimal yet functional simulator for quantum circuits. The code in `quantum_simulator.py` models a register of qubits using a complex state vector and implements a handful of basic gates (Hadamard, PauliX and controlledNOT). You can create circuits, apply gates and measure the qubits to observe the probabilistic outcomes associated with quantum mechanics.
2. **Unsolved Mathematical Problems** collect descriptions of ten open problems that continue to challenge mathematicians. These descriptions, along with references to authoritative sources, are provided in `problems.md`. The list includes the seven Clay Mathematics Institute (CMI) Millennium Prize Problems and a few other longstanding conjectures from number theory and analysis.
## Why this project?
Mathematics and quantum computing share a common theme: profound questions whose answers unlock entirely new possibilities. While this project is purely **simulative** nothing here can harness particles or energy in the physical world it offers a platform for learning and experimentation. The simulator illustrates key quantum concepts such as superposition and entanglement, and the problem summaries point readers toward some of the deepest unsolved questions in modern mathematics.
## Getting started
1. **Clone this repository** and install the only required dependency (NumPy) with `pip install numpy`.
2. **Explore `quantum_simulator.py`** this module defines a `QuantumCircuit` class with methods to apply gates and perform measurements. The included docstrings provide examples.
3. **Read `problems.md`** each section describes an unsolved problem and cites a primary source or wellknown reference for further reading.
## Disclaimer
This project does not attempt to solve any of the unsolved problems listed here. It provides succinct descriptions for educational purposes and a simple code base for playing with quantum circuits. For realworld quantum computation, consider using established frameworks such as [Qiskit](https://qiskit.org/) or [Cirq](https://quantumai.google/cirq).