ticit 0.1.0

Exact sampler for noisy, adaptive Clifford-dominated quantum circuits
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# ticit

Ticit is a pure-Rust implementation of [SymFT](https://arxiv.org/abs/2607.28600)
with both CPU and an experimental CUDA backend utilizing
[cutile-rs](https://github.com/NVlabs/cutile-rs).

## Installation

### Build from source

```sh
# rust
git clone https://github.com/inmzhang/ticit.git
cd ticit
cargo build --release

# python
uv sync --project ticit_py
```

### `ticit` CLI binary

```sh
cargo install ticit
```

### `ticit` Rust crate

```sh
cargo add ticit
```

### `ticit` Python package

```sh
uv add ticit
```

## Rust API

See the [Rust API documentation](https://docs.rs/ticit).

```rust
use ticit::{Circuit, SamplerOptions};

let circuit = Circuit::from_text("M 0\nOBSERVABLE_INCLUDE(0) rec[-1]")?;
let mut compiled_sampler = circuit.compile(SamplerOptions::default())?;
let result = compiled_sampler.sample(1_000, false)?;
```

Use `sample_with_seed(shots, seed, bit_packed)` when reproducible records are
required. Setting `bit_packed` packs eight record bits into each output byte.

## Python API

See the [Python API reference](docs/python_api_reference.md).

```python
import ticit

compiled_sampler = ticit.Circuit("M 0").compile(backend="cpu")
result = compiled_sampler.sample(shots=1_000, seed=42)
```

## Benchmarks

See [ticit vs SymFT vs Clifft](docs/benchmark.md) for CPU and GPU results,
methodology, and caveats.

## AI acknowledgement

Extensive use of generative AI is an explicit initial goal of this project:
to port SymFT's C++ implementation to Rust and experiment with Rust portable
SIMD and [cuTile-rs](https://github.com/NVlabs/cutile-rs). AI tools assist with
implementation, review, analysis, benchmarking, and documentation; human
contributors make and verify the substantive design, validation, and release
decisions.

## License

[Apache-2.0](LICENSE)