Compilation and execution

Start with a quantum program, compile it for a simulator or device, and inspect its results. MQT Core accepts OpenQASM, Qiskit circuits, and typed program objects. Python, command-line, and C++ interfaces share its MLIR compiler infrastructure; see [1].

Start with a result

The Shor factoring walkthrough compiles and executes an order-finding circuit with local DDSIM. It connects a quantum benchmark, the compiler, and QDMI in one example. No hardware account or MLIR knowledge is required.

Then work through the compiler tutorials to inspect representations, optimize gates, follow measurement feedback, and compile under hardware constraints. Continue into QIR execution, QDMI jobs, and jeff exchange between compilers. Each tutorial is an executable notebook with experiments to change and rerun.

Choose a workflow

  • Compile and inspect: the compiler guide covers the Python, command-line, and C++ interfaces, custom pipelines, and simulation.

  • Compile for a device: the target-compilation guide uses device operations, connectivity, and accepted program formats to produce a runnable program.

  • Exchange programs: use OpenQASM or Qiskit at the frontend, or compile to QIR and execute LLVM text or bitcode with DDSIM. Use jeff to exchange structured programs between compilers.

Continue with QDMI devices and integrations to discover devices, connect an SDK, or configure remote execution. For direct state and operator manipulation, use the decision-diagram package. For repeatable workloads and reference results, use quantum benchmarks.

Compiler internals are documented in the MLIR reference and the development policy.