Overview

The Python layer in QXel is organized around a small set of subsystems:

• QXel.provider.braket adapts the simulators to the AWS Braket LocalSimulator interface and translates Braket IR into internal QXel operators, observables, and result descriptors.

• QXel.simulator, QXel.simulation, and QXel.transpiler implement the high-level execution flow from circuit lowering through backend-specific execution plans.

• QXel.operator, QXel.observable, QXel.result, QXel.tensor, and QXel.types expose the typed building blocks backed by the native extension.

• QXel.core, QXel.distributed, QXel.functional, and QXel.logging provide runtime services such as device selection, MPI collectives, kernel dispatch, and rank-aware logging.

• QXel.benchmark contains benchmark runners and helper scripts used to exercise the package against external circuit suites.

Reference generation notes

The Sphinx reference intentionally excludes two categories of source:

• src/QXel/benchmark/mqt-bench/, which vendors an external benchmark project that already carries its own documentation.

• src/QXel/provider/braket/openqasm/parser/generated/, which contains ANTLR-generated parser modules better treated as build artifacts than hand-authored API surfaces.