Quantum spin-chain time-evolution simulation using exact diagonalisation and Trotterisation.
Project Structure
├── GroupProject/
│ ├── __init__.py
│ ├── run_time_evolution_project.py # CLI entry point
│ └── time_evolution/
│ ├── __init__.py
│ ├── spin_chain.py # Core: Pauli operators, XXZ Hamiltonian, exact evolution
│ └── project_pipeline.py # Pipeline: Trotter decomposition, noise model, plotting
├── tests/
│ └── test_spin_chain.py # Unit tests for spin_chain module
├── pyproject.toml # Project metadata and dependencies
├── Project_TimeEvolution.pdf # Project specification document
├── LICENSE
└── README.md
Installation
If you want NumPy-vs-Qiskit comparison outputs, also install Qiskit:
Running the Project
Run the full simulation pipeline (exact evolution, Trotter decomposition, noisy trajectories, and error-scaling analysis):
python -m GroupProject.run_time_evolution_project
For a faster smoke run during development:
python -m GroupProject.run_time_evolution_project --quick
Results (figures, .npz data files, and JSON metrics) are written to GroupProject/results/ by default. Use --output-dir to change the output directory.
By default the pipeline also writes Qiskit comparison outputs for each case:
<case>_spacetime_qiskit.png<case>_numpy_vs_qiskit.png
To disable Qiskit comparison while keeping the rest of the pipeline:
python -m GroupProject.run_time_evolution_project --no-qiskit-compare
Running Tests
License
Apache-2.0 – see LICENSE for details.