#quantum-computing #quantum #quantum-simulator #qubits #rust


A simple, efficient, quantum computer simulator

2 unstable releases

0.2.0 Feb 27, 2019
0.1.0 Jan 30, 2019

#10 in Simulation

Download history 9/week @ 2019-01-28 2/week @ 2019-02-04 1/week @ 2019-02-11 1/week @ 2019-02-18

6 downloads per month




Build Status License crates.io Released API docs

A simple, efficient, quantum computer simulator.


q1tsim is a simulator library for a quantum computer, written in Rust. Its goal is to be an easy to use, efficient simulator for the development and testing of quantum algorithms.


  • Easy implementation and simulation of quantum circuits
  • Supports the creation of arbitrary quantum gates
  • Most common quantum gates already included
  • Measurement in X, Y, or Z basis.
  • Creation of histograms of measurement results over multiple runs
  • Operations conditional on classical values
  • Export of circuits to Open QASM and c-QASM


To use q1tsim in your Rust application, add the following to your Cargo.toml file:

q1tsim = "0.2"

As an example, here is a 3-qubit quantum Fourier transform of the |000〉quantum state:

extern crate q1tsim;

use q1tsim::{circuit, gates};

fn main()
    // The number of times this circuit os evaulated
    let nr_runs = 8192;

    // Create a quantum circuit with 3 quantum bits and 3 classical (measurement)
    // bits, that is evaluated `nr_runs` times. The circuit starts by default
    // with all quantum bits in the |0〉state, so in this case |000〉.
    let mut circuit = circuit::Circuit::new(3, 3, nr_runs);

    // Set up a 3-qubit quantum Fourier transform
    // There is no predefined method on Circuit that implements a controlled
    // `S` or `T` gate, so we use the `add_gate()` method for those.
    circuit.add_gate(gates::CS::new(), &[1, 2]);
    circuit.add_gate(gates::CT::new(), &[0, 2]);
    circuit.add_gate(gates::CS::new(), &[0, 1]);
    circuit.add_gate(gates::Swap::new(), &[0, 2]);

    // Measure all quantum bits in the Pauli `Z` basis
    circuit.measure_all(&[0, 1, 2]);

    // Actually calculate the resulting quantum state and perform the measurements

    // And print the results.
    let hist = circuit.histogram_string();
    for (bits, count) in hist
        println!("{}: {}", bits, count);

The result should be a more or less equal distribution over the eight possible states (000, 001, ..., 111).

Read the complete source code documentation on docs.rs.


~60K SLoC