Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 46 additions & 2 deletions docs/guides/error-mitigation-overview.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,50 @@
---
title: Overview of noise management techniques
description: Discover tools that help manage noise through the available error mitigation and suppression techniques
keywords: ["error mitigation", "noise management", "quantum error suppression", "ZNE", "PEC", "TREX", "dynamical decoupling", "Qiskit Runtime", "quantum noise"]
category: "Guides"
tags: ["error-mitigation", "noise-management", "quantum-computing", "qiskit-runtime", "qiskit-addons"]
date: "2026-05-28"
updated: "2026-05-28"
version: "1.0"
is_latest: true

# Semantic context
topic: "Quantum Error Mitigation and Noise Management"
audience: "quantum-developers"
difficulty: "intermediate"
reading_time: "8 min"

# Content structure
sections: ["general-techniques", "expectation-value-mitigation", "sampling-mitigation"]
technologies: ["Qiskit Runtime", "Qiskit Addons", "quantum-hardware"]

# Relationships
related_docs:
- "error-mitigation-and-suppression-techniques"
- "directed-execution-model"
- "configure-error-mitigation"
prerequisites: ["basic-quantum-computing", "qiskit-fundamentals"]
next_steps: ["error-mitigation-and-suppression-techniques", "directed-execution-model"]

# Discoverability
aliases: ["noise-management", "error-suppression-overview", "quantum-error-mitigation-guide"]
summary: "Comprehensive index of error mitigation and noise suppression techniques available in Qiskit, including both open-source addons and Qiskit Runtime features. Covers general noise management, expectation value estimation techniques (TREX, ZNE, PEA, PEC), and sampling-based methods (SQD, M3)."

# Content metadata
techniques_covered:
- "Directed execution model"
- "Dynamical decoupling"
- "Pauli twirling"
- "TREX"
- "ZNE"
- "PEA"
- "PEC"
- "OBP"
- "PNA"
- "SQD"
- "M3"
use_cases: ["expectation-value-estimation", "sampling-results", "noise-reduction"]
---

{/* cspell:ignore lightcones */}
Expand Down Expand Up @@ -73,7 +117,7 @@ When executing quantum workloads, there are multiple ways to reduce the impact o
<Card
title="Probabilistic error cancellation (PEC)"
description="Returns an unbiased estimate of the expectation value, at the expense of greater overhead than other techniques such as ZNE. It extrapolates output of the ideal circuit by executing different noisy circuit instances."
href="/docs/guides/error-mitigation-and-suppression-techniques#probabilistic-error-cancellation-pec"
href="/docs/guides/error-mitigation-and-suppression-techniques#probabilistic-error-cancellation-pec"
analyticsName="Documentation page: PEC"
linkText="Learn more"
/>
Expand Down Expand Up @@ -107,7 +151,7 @@ When executing quantum workloads, there are multiple ways to reduce the impact o
<Card
title="Sample-based quantum diagonalization (SQD)"
description="Implements a technique for finding eigenvalues and eigenvectors of quantum operators, such as a quantum system Hamiltonian, using quantum and distributed classical computing together."
href="https://qiskit.github.io/qiskit-addon-sqd/"
href="https://qiskit.github.io/qiskit-addon-sqd/"
analyticsName="Documentation page: SQD"
linkText="Browse documentation"
/>
Expand Down
73 changes: 73 additions & 0 deletions docs/guides/hello-world.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,79 @@
"---\n",
"title: Run your first circuit on hardware\n",
"description: Get started using Qiskit with IBM Quantum hardware in this Hello World example\n",
"keywords: [\"hello world\", \"quantum hardware\", \"IBM Quantum\", \"first circuit\", \"Bell state\", \"QPU\", \"quantum processing unit\", \"Qiskit Runtime\", \"hardware execution\"]\n",
"category: \"Guides\"\n",
"tags: [\"hello-world\", \"tutorial\", \"beginner\", \"hardware\", \"qpu\", \"bell-state\", \"qiskit-runtime\", \"authentication\"]\n",
"date: \"2026-05-28\"\n",
"updated: \"2026-05-28\"\n",
"version: \"1.0\"\n",
"is_latest: true\n",
"\n",
"# Semantic context\n",
"topic: \"Running Quantum Circuits on Real Hardware\"\n",
"audience: \"beginners\"\n",
"difficulty: \"beginner\"\n",
"reading_time: \"15 min\"\n",
"completion_time: \"20 min\"\n",
"\n",
"# Tutorial metadata\n",
"tutorial_type: \"hello-world\"\n",
"hands_on: true\n",
"requires_hardware: true\n",
"requires_api_key: true\n",
"requires_account: true\n",
"\n",
"# Content structure\n",
"sections: [\"installation\", \"authentication\", \"simple-program\", \"scaling\", \"next-steps\"]\n",
"code_languages: [\"python\"]\n",
"technologies: [\"Qiskit\", \"Qiskit Runtime\", \"IBM Quantum\", \"QPU\", \"Jupyter\"]\n",
"\n",
"# Learning objectives\n",
"learning_outcomes:\n",
" - \"Set up IBM Quantum account and authentication\"\n",
" - \"Install Qiskit Runtime for hardware access\"\n",
" - \"Create and run a Bell state circuit on real quantum hardware\"\n",
" - \"Understand the four-step Qiskit pattern workflow\"\n",
" - \"Scale circuits to utility-level qubit counts\"\n",
" - \"Analyze results from quantum hardware execution\"\n",
"\n",
"# Relationships\n",
"related_docs:\n",
" - \"quick-start\"\n",
" - \"cloud-setup-invited\"\n",
" - \"cloud-setup-untrusted\"\n",
" - \"plans-overview\"\n",
" - \"bit-ordering\"\n",
"prerequisites: [\"quick-start\", \"python-basics\", \"ibm-quantum-account\"]\n",
"next_steps: [\"configure-error-mitigation\", \"primitives\", \"qiskit-patterns\"]\n",
"\n",
"# Discoverability\n",
"aliases: [\"hello-world\", \"first-hardware-run\", \"quantum-hardware-tutorial\", \"run-on-qpu\"]\n",
"summary: \"Complete hello world tutorial for running quantum circuits on real IBM Quantum hardware. Covers account setup, authentication, creating Bell states, executing on QPUs, and scaling to utility-level circuits. Includes the four-step Qiskit pattern: map, optimize, execute, and analyze.\"\n",
"\n",
"# Technical details\n",
"qiskit_version: \"~=2.4.0\"\n",
"qiskit_runtime_version: \"~=0.46.1\"\n",
"dependencies: [\"qiskit\", \"qiskit-ibm-runtime\", \"jupyter\"]\n",
"environment: \"cloud\"\n",
"execution_mode: \"hardware\"\n",
"access_plan: \"Open Plan\"\n",
"\n",
"# QPU usage\n",
"qpu_usage:\n",
" estimated_shots: \"1000-10000\"\n",
" estimated_circuits: \"2-5\"\n",
" qubit_count: \"2-127\"\n",
" circuit_depth: \"low-to-medium\"\n",
" execution_time: \"minutes\"\n",
" cost_estimate: \"free (Open Plan)\"\n",
"\n",
"# Content features\n",
"includes_code: true\n",
"includes_visualization: true\n",
"interactive: true\n",
"estimated_runtime: \"5-10 min\"\n",
"quantum_concepts: [\"Bell state\", \"entanglement\", \"quantum circuits\", \"observables\", \"primitives\"]\n",
"---\n",
"\n",
"\n",
Expand Down
58 changes: 58 additions & 0 deletions docs/guides/quick-start.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,64 @@
"---\n",
"title: Quickstart\n",
"description: Build and visualize a quantum circuit in under two minutes, no sign-in or API key necessary.\n",
"keywords: [\"quickstart\", \"getting started\", \"quantum circuit\", \"Bell state\", \"entanglement\", \"Qiskit tutorial\", \"first circuit\", \"quantum computing basics\"]\n",
"category: \"Guides\"\n",
"tags: [\"quickstart\", \"tutorial\", \"beginner\", \"quantum-circuit\", \"bell-state\", \"entanglement\", \"qiskit-basics\"]\n",
"date: \"2026-05-28\"\n",
"updated: \"2026-05-28\"\n",
"version: \"1.0\"\n",
"is_latest: true\n",
"\n",
"# Semantic context\n",
"topic: \"Getting Started with Qiskit\"\n",
"audience: \"beginners\"\n",
"difficulty: \"beginner\"\n",
"reading_time: \"5 min\"\n",
"completion_time: \"2 min\"\n",
"\n",
"# Tutorial metadata\n",
"tutorial_type: \"quickstart\"\n",
"hands_on: true\n",
"requires_hardware: false\n",
"requires_api_key: false\n",
"\n",
"# Content structure\n",
"sections: [\"installation\", \"circuit-building\", \"visualization\", \"experimentation\", \"next-steps\"]\n",
"code_languages: [\"python\"]\n",
"technologies: [\"Qiskit\", \"Python\", \"Jupyter\"]\n",
"\n",
"# Learning objectives\n",
"learning_outcomes:\n",
" - \"Install Qiskit in a local environment\"\n",
" - \"Build a simple quantum circuit\"\n",
" - \"Create a Bell state (entangled qubits)\"\n",
" - \"Run circuit simulation locally\"\n",
" - \"Visualize quantum measurement results\"\n",
" - \"Understand quantum entanglement basics\"\n",
"\n",
"# Relationships\n",
"related_docs:\n",
" - \"hello-world\"\n",
" - \"install-qiskit\"\n",
" - \"basics-of-quantum-information\"\n",
"prerequisites: [\"python-basics\"]\n",
"next_steps: [\"hello-world\", \"basics-of-quantum-information\"]\n",
"\n",
"# Discoverability\n",
"aliases: [\"getting-started\", \"first-circuit\", \"qiskit-quickstart\", \"beginner-tutorial\"]\n",
"summary: \"Hands-on quickstart guide for building your first quantum circuit with Qiskit. Learn to create a Bell state, run local simulations, and visualize results in under 2 minutes. No sign-in or API key required. Perfect for beginners new to quantum computing.\"\n",
"\n",
"# Technical details\n",
"qiskit_version: \"~=2.4.0\"\n",
"dependencies: [\"qiskit\", \"matplotlib\", \"qiskit[visualization]\"]\n",
"environment: \"local\"\n",
"execution_mode: \"simulation\"\n",
"\n",
"# Content features\n",
"includes_code: true\n",
"includes_visualization: true\n",
"interactive: true\n",
"estimated_runtime: \"< 1 min\"\n",
"---\n",
"\n",
"\n",
Expand Down
Loading