TimeEvolutionQuantComputing

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

pip install -e ".[dev]"

If you want NumPy-vs-Qiskit comparison outputs, also install Qiskit:

pip 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

pytest

License

Apache-2.0 – see LICENSE for details.