ruqu_core/lib.rs
1//! # ruqu-core -- Quantum Execution Intelligence Engine
2//!
3//! Pure Rust quantum simulation and execution engine for the ruVector stack.
4//! Supports state-vector (up to 32 qubits), stabilizer (millions), Clifford+T
5//! (moderate T-count), and tensor network backends with automatic routing,
6//! noise modeling, error mitigation, and cryptographic witness logging.
7//!
8//! ## Quick Start
9//!
10//! ```
11//! use ruqu_core::prelude::*;
12//!
13//! // Create a Bell state |00> + |11> (unnormalised notation)
14//! let mut circuit = QuantumCircuit::new(2);
15//! circuit.h(0).cnot(0, 1);
16//! let result = Simulator::run(&circuit).unwrap();
17//! let probs = result.state.probabilities();
18//! // probs ~= [0.5, 0.0, 0.0, 0.5]
19//! ```
20
21// -- Core simulation layer --
22pub mod types;
23pub mod error;
24pub mod gate;
25pub mod state;
26pub mod mixed_precision;
27pub mod circuit;
28pub mod simulator;
29pub mod optimizer;
30pub mod simd;
31pub mod backend;
32pub mod circuit_analyzer;
33pub mod stabilizer;
34pub mod tensor_network;
35
36// -- Scientific instrument layer (ADR-QE-015) --
37pub mod qasm;
38pub mod noise;
39pub mod mitigation;
40pub mod hardware;
41pub mod transpiler;
42pub mod replay;
43pub mod witness;
44pub mod confidence;
45pub mod verification;
46
47// -- SOTA differentiation layer --
48pub mod planner;
49pub mod clifford_t;
50pub mod decomposition;
51pub mod pipeline;
52
53// -- QEC control plane --
54pub mod decoder;
55pub mod subpoly_decoder;
56pub mod qec_scheduler;
57pub mod control_theory;
58
59// -- Benchmark & proof suite --
60pub mod benchmark;
61
62/// Re-exports of the most commonly used items.
63pub mod prelude {
64 pub use crate::types::*;
65 pub use crate::error::{QuantumError, Result};
66 pub use crate::gate::Gate;
67 pub use crate::state::QuantumState;
68 pub use crate::circuit::QuantumCircuit;
69 pub use crate::simulator::{SimConfig, SimulationResult, Simulator, ShotResult};
70 pub use crate::qasm::to_qasm3;
71 pub use crate::backend::BackendType;
72}