qb-compiler documentation

qb-compiler is a calibration-aware quantum circuit compiler. It ingests live device calibration data and compiles circuits that survive today’s hardware: reducing depth, improving estimated fidelity, and keeping you within budget.

Getting Started

• Getting Started
  • Installation
  • Quick Start
  • CLI Usage
  • Next Steps
• Optimization Level Guide
  • Optimization Levels
  • Compilation Strategies
  • Decision Tree
  • Performance vs Quality
  • Calibration-Aware vs Topology-Only
  • Combining Level and Strategy
• CLI Reference
  • Global Options
  • qbc compile
  • qbc info
  • qbc calibration show
  • Environment Variables
  • qbc chem-audit
  • qbc measure-plan
  • qbc verify-receipt
  • qbc corpus
  • qbc record
  • qbc pricing
  • More Environment Variables

Guides

• Architecture
  • Pass pipeline
  • Calibration system
  • Fidelity estimation
  • Cost estimation
• Calibration System Guide
  • Data Model
  • Calibration Providers
  • How Calibration Feeds Compilation
  • Best Practices
• Receipts: what ran, and who says so
  • The receipt describes the layout that ran
  • Signing, and what a signature is worth
  • Verifying, which is free and offline
  • Where receipts come from
  • Calibration age rides on every selection receipt
• Chemistry inputs: is the file sound, and what will measuring it cost
  • qbc chem-audit
  • qbc measure-plan
  • Both in CI
• Public QEC datasets, hash verified
  • Check your copy
  • What a digest does and does not tell you
  • Why this is not a downloader
  • Coming
  • What is not listed
• Records: how they are built, and what a decoder leaves on them
  • What “validated” means, and what it does not
  • Quickstart
  • Two traps, with the numbers each one leaves behind
  • The eight checks
  • The residual metric
  • The .npz contract
  • Command line
  • Running the tests against a real record
  • Beyond validation
• Prices: where each number came from, and what it is a number about
  • Live, cached, static
  • How the vendors actually bill
  • The feed, and what a signature buys
  • The shipped table
• Preflight in CI
  • Use it
  • Inputs
  • Pinning
  • Exit codes, if you would rather call the CLI directly
  • What is not in it
• Writing Custom Passes
  • Pass Contract
  • Base Classes
  • Example: Analysis Pass: Gate Frequency
  • Example: Transformation Pass: Identity Gate Removal
  • Example: Redundant Gate Removal
  • Composing Passes with PassManager
  • Using Custom Passes with QBCompiler
  • Testing Custom Passes
  • Tips
• Migrating from Qiskit Transpiler
  • Option 1: Drop-in Replacement
  • Option 2: passmanager() Factory
  • Option 3: QBCalibrationPass as a Qiskit TransformationPass
  • Option 4: QBCalibrationLayout AnalysisPass
  • Option 5: Full QBCompiler API
  • Key Differences from Qiskit
• FAQ & Troubleshooting
  • General Questions
  • Calibration Questions
  • Compilation Questions
  • Cost & Budget Questions
  • Troubleshooting
  • Getting Help

API Reference

• API Reference
  • Compiler API
  • Compiler Passes
  • Backends, Calibration & Noise

Project

• Changelog
• Contributing
• Release Process
• GPG Signing Guide