quantsim_core 0.2.0

A quantum circuit simulator
Documentation

quantsim_core

License [Rust]

A pure Rust library for quantum circuit simulation. This crate provides the core simulation engine for quantum computing, designed to be portable and reusable without any UI dependencies.

Features

  • Pure Rust Implementation: No UI dependencies, making it suitable for integration into any Rust project
  • Comprehensive Gate Library: Support for standard quantum gates including single-qubit, multi-qubit, and parametric gates
  • Custom Gate Support: Define your own unitary gates programmatically
  • Embedded Circuit Templates: Built-in quantum algorithm examples (Bell states, Grover's algorithm, QFT, etc.)
  • Parallel Execution: Uses Rayon for efficient parallelization of computationally intensive operations
  • Introspection API: Detailed per-timestep snapshots of quantum state evolution
  • JSON Serialization: Easy circuit persistence and sharing

Usage

Add this to your Cargo.toml:

[dependencies]
quantsim_core = "0.1.0"

Basic Example

use quantsim_core::{Circuit, Engine, GateRegistry};

let mut registry = GateRegistry::new();
registry.register_standard_gates();

// Create a Bell state circuit
let mut circuit = Circuit::new(2);
circuit.add_gate("H", &[0]).unwrap();
circuit.add_gate("CX", &[0, 1]).unwrap();

// Simulate
let mut engine = Engine::new();
let result = engine.run(&circuit, None).unwrap();

println!("Final state: {:?}", result.final_state);

Loading Built-in Templates

use quantsim_core::circuits;

let bell_circuit = circuits::load_template("bell").unwrap();

Architecture

The library is organized into several key modules:

  • circuit: Quantum circuit representation and manipulation
  • engine: Simulation execution engine
  • gates: Gate definitions and registry system
  • types: Core data types and representations
  • circuits: Built-in circuit templates

Performance

  • Parallel gate application using Rayon
  • Efficient state vector representation
  • Optimized for both small educational circuits and larger quantum algorithms

License

Licensed under either of

at your option.