From c16f99327c12d3141c7dd698f277df0de51ff255 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Thu, 21 Nov 2024 03:13:59 +0000 Subject: [PATCH] Update API dev docs (#2356) An action recently synced the latest dev docs. This PR updates all dev APIs that changed. > [!NOTE] > This pull request was created by a GitHub action. Co-authored-by: github-actions[bot] --- ...sses.scheduling.PadDynamicalDecoupling.mdx | 2 +- .../dev/fake_provider-1_02.png | Bin 11837 -> 11631 bytes scripts/config/api-html-artifacts.json | 2 +- 3 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.transpiler.passes.scheduling.PadDynamicalDecoupling.mdx b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.transpiler.passes.scheduling.PadDynamicalDecoupling.mdx index d75794db98d..486266bc5fe 100644 --- a/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.transpiler.passes.scheduling.PadDynamicalDecoupling.mdx +++ b/docs/api/qiskit-ibm-runtime/dev/qiskit_ibm_runtime.transpiler.passes.scheduling.PadDynamicalDecoupling.mdx @@ -8,7 +8,7 @@ python_api_name: qiskit_ibm_runtime.transpiler.passes.scheduling.PadDynamicalDec # PadDynamicalDecoupling - + Dynamical decoupling insertion pass for IBM dynamic circuit backends. This pass works on a scheduled, physical circuit. It scans the circuit for idle periods of time (i.e. those containing delay instructions) and inserts a DD sequence of gates in those spots. These gates amount to the identity, so do not alter the logical action of the circuit, but have the effect of mitigating decoherence in those idle periods. As a special case, the pass allows a length-1 sequence (e.g. \[XGate()]). In this case the DD insertion happens only when the gate inverse can be absorbed into a neighboring gate in the circuit (so we would still be replacing Delay with something that is equivalent to the identity). This can be used, for instance, as a Hahn echo. This pass ensures that the inserted sequence preserves the circuit exactly (including global phase). diff --git a/public/images/api/qiskit-ibm-runtime/dev/fake_provider-1_02.png b/public/images/api/qiskit-ibm-runtime/dev/fake_provider-1_02.png index d0a60c32b9b1d59032570053d56a04814c05888e..5b1514fb0c72a97a254e51c73ff080c1fb2ee6bc 100644 GIT binary patch literal 11631 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 kviTz#ApAS0oL8vG6P7bv+I#)H;0g#