Learn more about our quantum error correction milestone

Building with Bazel

qsim provides Bazel build rules for its applications and tests. To build and run all tests using Bazel, run the following command:

# AVX and OpenMP are recommended for best performance.
# See "Build configs" section below for more information.
bazel test --config=avx --config=openmp tests:all

To run a sample simulation, use the command below. Note that this command requires the circuit file to be specified both on the command line and in the data field of the qsim_base BUILD rule.

bazel run --config=avx --config=openmp apps:qsim_base -- -c circuits/circuit_q24

Build configs

Depending on the optimizers available on your machine, different config flags (such as --config=avx, above) can be set to control which optimizers are included in a given build or test run.

Vector arithmetic optimizers (pick one at most):

# Use AVX instructions for vector arithmetic.

# Use SSE instructions for vector arithmetic.

# Do not use vector arithmetic optimization (default).

Parallelism optimizers (pick one at most):

# Use OpenMP to run operations in parallel when possible.

# Do not use OpenMP for parallelism (default).

Memory allocation (pick one at most):

# Use tcmalloc for memory allocation.

# Use malloc for memory allocation (default).