From 097da089ea6861ecfd7da8314ffa2e479ca76159 Mon Sep 17 00:00:00 2001
From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com>
Date: Mon, 26 Feb 2024 13:45:38 -0500
Subject: [PATCH] Generate Qiskit 1.0.1 (#877)
`npm run gen-api -- -p qiskit -v 1.0.1`
---
docs/api/qiskit/_package.json | 2 +-
.../api/qiskit/qiskit.dagcircuit.DAGInNode.md | 2 +-
docs/api/qiskit/qiskit.dagcircuit.DAGNode.md | 2 +-
.../api/qiskit/qiskit.dagcircuit.DAGOpNode.md | 2 +-
.../qiskit/qiskit.dagcircuit.DAGOutNode.md | 2 +-
...iskit.synthesis.OneQubitEulerDecomposer.md | 26 ++++++++++
...iskit.synthesis.TwoQubitBasisDecomposer.md | 27 ++++++++++
.../qiskit/qiskit.synthesis.XXDecomposer.md | 24 ++++++++-
.../qiskit/qiskit.transpiler.CouplingMap.md | 2 +-
...iskit.transpiler.passes.BasisTranslator.md | 2 +-
.../qiskit/qiskit.visualization.dag_drawer.md | 2 +-
docs/api/qiskit/release-notes/1.0.md | 47 +++++++++++-------
public/api/qiskit/objects.inv | Bin 68318 -> 68345 bytes
public/images/api/qiskit/circuit-5.png | Bin 7347 -> 8430 bytes
.../qiskit/providers_fake_provider-1_02.png | Bin 13920 -> 13811 bytes
public/images/api/qiskit/pulse-2.png | Bin 10857 -> 10970 bytes
public/images/api/qiskit/pulse-3.png | Bin 59805 -> 59628 bytes
public/images/api/qiskit/pulse-4.png | Bin 19231 -> 19027 bytes
public/images/api/qiskit/pulse-5.png | Bin 16544 -> 16521 bytes
public/images/api/qiskit/pulse-6.png | Bin 11505 -> 11537 bytes
public/images/api/qiskit/pulse-7.png | Bin 14244 -> 14243 bytes
.../qiskit-circuit-ControlledGate-2.png | Bin 7305 -> 7297 bytes
...skit-circuit-library-PermutationGate-2.png | Bin 16160 -> 16179 bytes
...skit-circuit-library-PhaseEstimation-1.png | Bin 12215 -> 12242 bytes
...it-visualization-plot_circuit_layout-1.png | Bin 10507 -> 9566 bytes
.../qiskit-visualization-plot_error_map-1.png | Bin 49322 -> 49625 bytes
...qiskit-visualization-timeline_drawer-1.png | Bin 15387 -> 15852 bytes
...qiskit-visualization-timeline_drawer-2.png | Bin 8255 -> 8074 bytes
...qiskit-visualization-timeline_drawer-3.png | Bin 26379 -> 27296 bytes
public/images/api/qiskit/transpiler-16.png | Bin 24624 -> 24669 bytes
public/images/api/qiskit/transpiler-17.png | Bin 18802 -> 18640 bytes
31 files changed, 114 insertions(+), 26 deletions(-)
diff --git a/docs/api/qiskit/_package.json b/docs/api/qiskit/_package.json
index c56c2e1c6c1..ceedb4995be 100644
--- a/docs/api/qiskit/_package.json
+++ b/docs/api/qiskit/_package.json
@@ -1,4 +1,4 @@
{
"name": "qiskit",
- "version": "1.0.0"
+ "version": "1.0.1"
}
diff --git a/docs/api/qiskit/qiskit.dagcircuit.DAGInNode.md b/docs/api/qiskit/qiskit.dagcircuit.DAGInNode.md
index 6b52eef5f61..31b273d8438 100644
--- a/docs/api/qiskit/qiskit.dagcircuit.DAGInNode.md
+++ b/docs/api/qiskit/qiskit.dagcircuit.DAGInNode.md
@@ -36,7 +36,7 @@ Create an incoming node
`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
-Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14)").
**Parameters**
diff --git a/docs/api/qiskit/qiskit.dagcircuit.DAGNode.md b/docs/api/qiskit/qiskit.dagcircuit.DAGNode.md
index b6daae6f007..78e1893d6b7 100644
--- a/docs/api/qiskit/qiskit.dagcircuit.DAGNode.md
+++ b/docs/api/qiskit/qiskit.dagcircuit.DAGNode.md
@@ -26,7 +26,7 @@ Create a node
`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
-Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14)").
**Parameters**
diff --git a/docs/api/qiskit/qiskit.dagcircuit.DAGOpNode.md b/docs/api/qiskit/qiskit.dagcircuit.DAGOpNode.md
index 5b60f04bac6..22e6e07e98b 100644
--- a/docs/api/qiskit/qiskit.dagcircuit.DAGOpNode.md
+++ b/docs/api/qiskit/qiskit.dagcircuit.DAGOpNode.md
@@ -50,7 +50,7 @@ Returns the Instruction name corresponding to the op for this node
`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
-Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14)").
**Parameters**
diff --git a/docs/api/qiskit/qiskit.dagcircuit.DAGOutNode.md b/docs/api/qiskit/qiskit.dagcircuit.DAGOutNode.md
index 9b745e7697b..8df9c26838b 100644
--- a/docs/api/qiskit/qiskit.dagcircuit.DAGOutNode.md
+++ b/docs/api/qiskit/qiskit.dagcircuit.DAGOutNode.md
@@ -36,7 +36,7 @@ Create an outgoing node
`static semantic_eq(node1, node2, bit_indices1, bit_indices2)`
-Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14.0)").
+Check if DAG nodes are considered equivalent, e.g., as a node\_match for [`rustworkx.is_isomorphic_node_match()`](https://www.rustworkx.org/apiref/rustworkx.is_isomorphic_node_match.html#rustworkx.is_isomorphic_node_match "(in rustworkx v0.14)").
**Parameters**
diff --git a/docs/api/qiskit/qiskit.synthesis.OneQubitEulerDecomposer.md b/docs/api/qiskit/qiskit.synthesis.OneQubitEulerDecomposer.md
index e7985ec4f8e..0e0aa940f83 100644
--- a/docs/api/qiskit/qiskit.synthesis.OneQubitEulerDecomposer.md
+++ b/docs/api/qiskit/qiskit.synthesis.OneQubitEulerDecomposer.md
@@ -33,6 +33,32 @@ The resulting decomposition is parameterized by 3 Euler rotation angle parameter
| ‘U1X’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} U_1(\phi+\pi).R_X\left(\frac{\pi}{2}\right).$ $U_1(\theta+\pi).R_X\left(\frac{\pi}{2}\right).U_1(\lambda)$ |
| ‘RR’ | $Z(\phi) Y(\theta) Z(\lambda)$ | $e^{i\gamma} R\left(-\pi,\frac{\phi-\lambda+\pi}{2}\right).$ $R\left(\theta+\pi,\frac{\pi}{2}-\lambda\right)$ |
+### \_\_call\_\_
+
+
+
+`__call__(unitary, simplify=True, atol=1e-12)`
+
+Decompose single qubit gate into a circuit.
+
+**Parameters**
+
+* **unitary** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *|*[*Gate*](qiskit.circuit.Gate "qiskit.circuit.Gate") *| np.ndarray*) – 1-qubit unitary matrix
+* **simplify** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – reduce gate count in decomposition \[Default: True].
+* **atol** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – absolute tolerance for checking angles when simplifying returned circuit \[Default: 1e-12].
+
+**Returns**
+
+the decomposed single-qubit gate circuit
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if input is invalid or synthesis fails.
+
Initialize decomposer
Supported bases are: `'U'`, `'PSX'`, `'ZSXX'`, `'ZSX'`, `'U321'`, `'U3'`, `'U1X'`, `'RR'`, `'ZYZ'`, `'ZXZ'`, `'XYX'`, `'XZX'`.
diff --git a/docs/api/qiskit/qiskit.synthesis.TwoQubitBasisDecomposer.md b/docs/api/qiskit/qiskit.synthesis.TwoQubitBasisDecomposer.md
index 0beaff83f6e..d36a842a6f1 100644
--- a/docs/api/qiskit/qiskit.synthesis.TwoQubitBasisDecomposer.md
+++ b/docs/api/qiskit/qiskit.synthesis.TwoQubitBasisDecomposer.md
@@ -23,6 +23,33 @@ A class for decomposing 2-qubit unitaries into minimal number of uses of a 2-qub
* **euler\_basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Basis string to be provided to [`OneQubitEulerDecomposer`](qiskit.synthesis.OneQubitEulerDecomposer "qiskit.synthesis.OneQubitEulerDecomposer") for 1Q synthesis. Valid options are \[`'ZYZ'`, `'ZXZ'`, `'XYX'`, `'U'`, `'U3'`, `'U1X'`, `'PSX'`, `'ZSX'`, `'RR'`].
* **pulse\_optimize** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)") *| None*) – If `True`, try to do decomposition which minimizes local unitaries in between entangling gates. This will raise an exception if an optimal decomposition is not implemented. Currently, only \[\{CX, SX, RZ}] is known. If `False`, don’t attempt optimization. If `None`, attempt optimization but don’t raise if unknown.
+### \_\_call\_\_
+
+
+
+`__call__(unitary, basis_fidelity=None, approximate=True, *, _num_basis_uses=None)`
+
+Decompose a two-qubit `unitary` over fixed basis and $SU(2)$ using the best approximation given that each basis application has a finite `basis_fidelity`.
+
+**Parameters**
+
+* **unitary** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or ndarray*) – $4 \times 4$ unitary to synthesize.
+* **basis\_fidelity** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)") *or None*) – Fidelity to be assumed for applications of KAK Gate. If given, overrides `basis_fidelity` given at init.
+* **approximate** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Approximates if basis fidelities are less than 1.0.
+* **\_num\_basis\_uses** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) – force a particular approximation by passing a number in \[0, 3].
+
+**Returns**
+
+Synthesized quantum circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
+**Raises**
+
+[**QiskitError**](exceptions#qiskit.exceptions.QiskitError "qiskit.exceptions.QiskitError") – if `pulse_optimize` is True but we don’t know how to do it.
+
## Methods
### decomp0
diff --git a/docs/api/qiskit/qiskit.synthesis.XXDecomposer.md b/docs/api/qiskit/qiskit.synthesis.XXDecomposer.md
index 16570984b7c..7603257f737 100644
--- a/docs/api/qiskit/qiskit.synthesis.XXDecomposer.md
+++ b/docs/api/qiskit/qiskit.synthesis.XXDecomposer.md
@@ -20,13 +20,35 @@ A class for optimal decomposition of 2-qubit unitaries into 2-qubit basis gates
* **basis\_fidelity** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *|*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – available strengths and fidelity of each. Can be either (1) a dictionary mapping `XX` angle values to fidelity at that angle; or (2) a single float `f`, interpreted as `{pi: f, pi/2: f/2, pi/3: f/3}`.
* **euler\_basis** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) – Basis string provided to [`OneQubitEulerDecomposer`](qiskit.synthesis.OneQubitEulerDecomposer "qiskit.synthesis.OneQubitEulerDecomposer") for 1Q synthesis. Defaults to `"U"`.
-* **embodiments** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – A dictionary mapping interaction strengths alpha to native circuits which embody the gate $CAN(\alpha, 0, 0)$. Strengths are taken so that $pi/2$ represents the class of a full [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
+* **embodiments** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")*\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – A dictionary mapping interaction strengths alpha to native circuits which embody the gate $CAN(\alpha, 0, 0)$. Strengths are taken so that $\pi/2$ represents the class of a full [`CXGate`](qiskit.circuit.library.CXGate "qiskit.circuit.library.CXGate").
* **backup\_optimizer** (*Callable\[...,* [*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")*] | None*) – If supplied, defers synthesis to this callable when [`XXDecomposer`](#qiskit.synthesis.XXDecomposer "qiskit.synthesis.XXDecomposer") has no efficient decomposition of its own. Useful for special cases involving 2 or 3 applications of $XX(\pi/2)$, in which case standard synthesis methods provide lower 1Q gate count.
If `embodiments` is not passed, or if an entry is missing, it will be populated as needed using the method `_default_embodiment`.
+### \_\_call\_\_
+
+
+
+`__call__(unitary, basis_fidelity=None, approximate=True)`
+
+Fashions a circuit which (perhaps approximately) models the special unitary operation `unitary`, using the circuit templates supplied at initialization as `embodiments`. The routine uses `basis_fidelity` to select the optimal circuit template, including when performing exact synthesis; the contents of `basis_fidelity` is a dictionary mapping interaction strengths (scaled so that $CX = RZX(\pi/2)$ corresponds to $\pi/2$) to circuit fidelities.
+
+**Parameters**
+
+* **unitary** ([*Operator*](qiskit.quantum_info.Operator "qiskit.quantum_info.Operator") *or ndarray*) – $4 \times 4$ unitary to synthesize.
+* **basis\_fidelity** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)") *or*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) – Fidelity of basis gates. Can be either (1) a dictionary mapping `XX` angle values to fidelity at that angle; or (2) a single float `f`, interpreted as `{pi: f, pi/2: f/2, pi/3: f/3}`. If given, overrides the basis\_fidelity given at init.
+* **approximate** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) – Approximates if basis fidelities are less than 1.0 .
+
+**Returns**
+
+Synthesized circuit.
+
+**Return type**
+
+[QuantumCircuit](qiskit.circuit.QuantumCircuit "qiskit.circuit.QuantumCircuit")
+
## Methods
### num\_basis\_gates
diff --git a/docs/api/qiskit/qiskit.transpiler.CouplingMap.md b/docs/api/qiskit/qiskit.transpiler.CouplingMap.md
index 0012b4c057b..a84e16ea9b9 100644
--- a/docs/api/qiskit/qiskit.transpiler.CouplingMap.md
+++ b/docs/api/qiskit/qiskit.transpiler.CouplingMap.md
@@ -184,7 +184,7 @@ The undirected distance
Draws the coupling map.
-This function calls the [`graphviz_draw()`](https://www.rustworkx.org/apiref/rustworkx.visualization.graphviz_draw.html#rustworkx.visualization.graphviz_draw "(in rustworkx v0.14.0)") function from the `rustworkx` package to draw the [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object.
+This function calls the [`graphviz_draw()`](https://www.rustworkx.org/apiref/rustworkx.visualization.graphviz_draw.html#rustworkx.visualization.graphviz_draw "(in rustworkx v0.14)") function from the `rustworkx` package to draw the [`CouplingMap`](#qiskit.transpiler.CouplingMap "qiskit.transpiler.CouplingMap") object.
**Returns**
diff --git a/docs/api/qiskit/qiskit.transpiler.passes.BasisTranslator.md b/docs/api/qiskit/qiskit.transpiler.passes.BasisTranslator.md
index c1737607a96..1c4ea56c208 100644
--- a/docs/api/qiskit/qiskit.transpiler.passes.BasisTranslator.md
+++ b/docs/api/qiskit/qiskit.transpiler.passes.BasisTranslator.md
@@ -49,7 +49,7 @@ EquivalenceLibrary
**param target\_basis**
-Target basis names to unroll to, e.g. \[‘u3’, ‘cx’].
+Target basis names to unroll to, e.g. `['u3', 'cx']`.
**type target\_basis**
diff --git a/docs/api/qiskit/qiskit.visualization.dag_drawer.md b/docs/api/qiskit/qiskit.visualization.dag_drawer.md
index 62835d9cf50..30d4a6d4208 100644
--- a/docs/api/qiskit/qiskit.visualization.dag_drawer.md
+++ b/docs/api/qiskit/qiskit.visualization.dag_drawer.md
@@ -16,7 +16,7 @@ python_api_name: qiskit.visualization.dag_drawer
Plot the directed acyclic graph (dag) to represent operation dependencies in a quantum circuit.
-This function calls the [`graphviz_draw()`](https://www.rustworkx.org/apiref/rustworkx.visualization.graphviz_draw.html#rustworkx.visualization.graphviz_draw "(in rustworkx v0.14.0)") function from the `rustworkx` package to draw the DAG.
+This function calls the [`graphviz_draw()`](https://www.rustworkx.org/apiref/rustworkx.visualization.graphviz_draw.html#rustworkx.visualization.graphviz_draw "(in rustworkx v0.14)") function from the `rustworkx` package to draw the DAG.
**Parameters**
diff --git a/docs/api/qiskit/release-notes/1.0.md b/docs/api/qiskit/release-notes/1.0.md
index 7f31e32f91f..31660e480d0 100644
--- a/docs/api/qiskit/release-notes/1.0.md
+++ b/docs/api/qiskit/release-notes/1.0.md
@@ -4,10 +4,38 @@ description: New features and bug fixes
---
# Qiskit 1.0 release notes
+## 1.0.1
+
+
+
+### Prelude
+
+Qiskit 1.0.1 is a patch release fixing a small number of bugs identified in the Qiskit 1.0.0 release.
+
+
+
+
+
+### Bug Fixes
+
+* Fixed a bug in the conversion of custom pulse instructions to the legacy [`qiskit.qobj`](/api/qiskit/qobj#module-qiskit.qobj "qiskit.qobj") format. The bug was introduced in Qiskit 1.0.0 and caused conversion of instructions with custom pulse shapes to raise an error. After the fix, the conversion is carried out correctly, and the custom pulse is converted to a `pulse.Waveform` as it should. Fixed [#11828](https://github.com/Qiskit/qiskit/issues/11828).
+
+* Fixed an issue in the [`InverseCancellation`](/api/qiskit/qiskit.transpiler.passes.InverseCancellation "qiskit.transpiler.passes.InverseCancellation") transpiler pass where in some cases it would incorrectly cancel a self-inverse parameterized gate even if the parameter value didn’t match. Fixed [#11815](https://github.com/Qiskit/qiskit/issues/11815).
+
+* [`BasePassManager.run()`](/api/qiskit/qiskit.passmanager.BasePassManager#run "qiskit.passmanager.BasePassManager.run") will no longer leak the previous [`PropertySet`](/api/qiskit/qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet") into new workflows when called more than once. Previously, the same [`PropertySet`](/api/qiskit/qiskit.passmanager.PropertySet "qiskit.passmanager.PropertySet") as before would be used to initialize follow-on runs, which could mean that invalid property information was being given to tasks. The behavior now matches that of Qiskit 0.44. Fixed [#11784](https://github.com/Qiskit/qiskit/issues/11784).
+
+* A bug has been fixed in `convert_durations_to_dt()` where the function assumed its inputs were all in seconds, rather than reading the actual unit. This could lead to wrong orders of magnitude in the reported circuit durations.
+
+
+
+
+
## 1.0.0
+
+
### Prelude
We are very pleased to release Qiskit 1.0.0. This release is the culmination of 7 years of development to mature Qiskit into a stable, high- performance SDK for quantum computing, and is the start of a new era for the Qiskit project and community. Besides general performance and stability improvements, the most significant changes with the 1.0.0 release relate to the stability policy, release cycles, and versioning. Qiskit is now formally using [semantic versioning](https://semver.org/), and this means that, for the entire lifecycle of the 1.x release series, the project is committed to maintaining backwards compatibility in its public documented APIs. We’re also now starting to offer bugfix support for major versions, so that you continue to have a supported branch for 6 months after the release of the next major version. This starts now with the 1.x and 0.x major series: the 0.46.x release will continue to be supported, with periodic patch releases that contain bug fixes, for 6 months after the release of 1.0. That is, 0.46.x will be supported until 2024-08. You can see the full details of the new policy here:
@@ -1047,6 +1075,8 @@ This guide is meant to complement the release notes and have a targeted advice f
+
+
### Bug Fixes
* Fixed the return of improper measurement schedules when only a subset of qubits was requested. Previously, a measurement schedule for all qubits would be returned.
@@ -1137,20 +1167,3 @@ This guide is meant to complement the release notes and have a targeted advice f
* The [`TemplateOptimization`](/api/qiskit/qiskit.transpiler.passes.TemplateOptimization "qiskit.transpiler.passes.TemplateOptimization") pass will now return parametric expressions using the native symbolic expression format of [`ParameterExpression`](/api/qiskit/qiskit.circuit.ParameterExpression "qiskit.circuit.ParameterExpression"), rather than always using Sympy. For most supported platforms, this means that the expressions will be Symengine objects. Previously, the pass could return mismatched objects, which could lead to later failures in parameter-handling code.
-
-
-## Unreleased Notes Preview
-
-
-
-
-
-### Bug Fixes
-
-* Update properties and configuration information of [`FakeOpenPulse2Q`](/api/qiskit/qiskit.providers.fake_provider.FakeOpenPulse2Q "qiskit.providers.fake_provider.FakeOpenPulse2Q") backend. Missing gate properties were added for some gates defined in the pulse defaults so that the gates defined in the two locations were consistent.
-
-* [`InstructionDurations.from_backend()`](/api/qiskit/qiskit.transpiler.InstructionDurations#from_backend "qiskit.transpiler.InstructionDurations.from_backend") now returns an instance of any subclass of [`InstructionDurations`](/api/qiskit/qiskit.transpiler.InstructionDurations "qiskit.transpiler.InstructionDurations") instead of the base class.
-
-
-
-
diff --git a/public/api/qiskit/objects.inv b/public/api/qiskit/objects.inv
index 0f52a6d3d22de1a547aaf6a804f898c03f84db50..53aa0795e9da5384cf64bccdd569f9d0ef4c5f65 100644
GIT binary patch
delta 37034
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�i|q1ovLl}Z
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