Prepare release notes for Qiskit Terra 0.19

docs/apidocs/synthesis.rst

@@ -0,0 +1,6 @@
+.. _qiskit-synthesis:
+
+.. automodule:: qiskit.synthesis
+   :no-members:
+   :no-inherited-members:
+   :no-special-members:

docs/apidocs/synthesis_aqc.rst

@@ -0,0 +1,6 @@
+.. _qiskit-transpiler-synthesis-aqc:
+
+.. automodule:: qiskit.transpiler.synthesis.aqc
+   :no-members:
+   :no-inherited-members:
+   :no-special-members:

docs/apidocs/terra.rst

@@ -21,6 +21,7 @@ Qiskit Terra API Reference
    providers_models
    pulse
    scheduler
+   synthesis
    qasm
    qobj
    qpy
@@ -32,6 +33,7 @@ Qiskit Terra API Reference
    transpiler_passes
    transpiler_preset
    transpiler_plugins
+   transpiler_builtin_plugins
    utils
    utils_mitigation
    opflow

docs/apidocs/transpiler_builtin_plugins.rst

@@ -0,0 +1,10 @@
+.. _qiskit-transpiler-builtin-plugins:
+
+=====================================
+Built-in Transpiler Synthesis Plugins
+=====================================
+
+.. toctree::
+   :maxdepth: 2
+
+   synthesis_aqc

qiskit/circuit/library/__init__.py

@@ -187,6 +187,15 @@
 
    QuadraticForm
 
+Other arithmetic functions
+--------------------------
+
+.. autosummary::
+   :toctree: ../stubs/
+   :template: autosummary/class_no_inherited_members.rst
+
+   ExactReciprocal
+
 Amplitude Functions
 ===================
 
@@ -393,6 +402,7 @@
     PiecewiseChebyshev,
     HRSCumulativeMultiplier,
     RGQFTMultiplier,
+    ExactReciprocal,
 )
 
 from .n_local import (

qiskit/circuit/library/arithmetic/__init__.py

@@ -24,3 +24,4 @@
 from .adders import VBERippleCarryAdder, CDKMRippleCarryAdder, DraperQFTAdder
 from .piecewise_chebyshev import PiecewiseChebyshev
 from .multipliers import HRSCumulativeMultiplier, RGQFTMultiplier
+from .exact_reciprocal import ExactReciprocal

qiskit/circuit/library/arithmetic/exact_reciprocal.py

@@ -31,15 +31,18 @@ def __init__(
         r"""
         Args:
             num_state_qubits: The number of qubits representing the value to invert.
-            scaling: Scaling factor of the reciprocal function, i.e. to compute
-             ::math:: `scaling / x`.
-            neg_vals: Whether x might represent negative values. In this case the first qubit is
-             the sign, with |1> for negative and |0> for positive. For the negative case it is
-             assumed that the remaining string represents 1 - x. This is because
-             ::math:: `e^{-2 \pi i x} = e^{2 \pi i (1 - x)}` for ::math:: `x \in [0,1)`.
+            scaling: Scaling factor :math:`s` of the reciprocal function, i.e. to compute
+                :math:`s / x`.
+            neg_vals: Whether :math:`x` might represent negative values. In this case the first
+                qubit is the sign, with :math:`|1\rangle` for negative and :math:`|0\rangle` for
+                positive.  For the negative case it is assumed that the remaining string represents
+                :math:`1 - x`. This is because :math:`e^{-2 \pi i x} = e^{2 \pi i (1 - x)}` for
+                :math:`x \in [0,1)`.
             name: The name of the object.
-        Note:
-            It is assumed that the binary string x represents a number < 1.
+
+        .. note::
+
+            It is assumed that the binary string :math:`x` represents a number < 1.
         """
         qr_state = QuantumRegister(num_state_qubits, "state")
         qr_flag = QuantumRegister(1, "flag")

qiskit/circuit/library/basis_change/qft.py

@@ -111,11 +111,9 @@ def num_qubits(self) -> int:
 
         Returns:
             The number of qubits in the circuit.
-
-        Note:
-            This method needs to be overwritten to allow adding the setter for num_qubits while
-            still complying to pylint.
         """
+        # This method needs to be overwritten to allow adding the setter for num_qubits while still
+        # complying to pylint.
         return super().num_qubits
 
     @num_qubits.setter

qiskit/extensions/__init__.py

@@ -25,6 +25,7 @@
 
    UnitaryGate
    HamiltonianGate
+   SingleQubitUnitary
 
 Simulator Extensions
 ====================
@@ -47,7 +48,7 @@
 from qiskit.circuit.library.standard_gates import *
 from qiskit.circuit.barrier import Barrier
 
-from .quantum_initializer.initializer import Initialize
+from .quantum_initializer import Initialize, SingleQubitUnitary
 from .unitary import UnitaryGate
 from .hamiltonian_gate import HamiltonianGate
 from .simulator import Snapshot

qiskit/extensions/quantum_initializer/__init__.py

@@ -19,3 +19,4 @@
 from .diagonal import DiagonalGate
 from .uc import UCGate
 from .isometry import Isometry
+from .initializer import Initialize

qiskit/extensions/quantum_initializer/initializer.py

@@ -28,7 +28,6 @@
 from qiskit.circuit.library.standard_gates.ry import RYGate
 from qiskit.circuit.library.standard_gates.rz import RZGate
 from qiskit.circuit.reset import Reset
-from qiskit.quantum_info import Statevector
 
 _EPS = 1e-10  # global variable used to chop very small numbers to zero
 
@@ -61,6 +60,9 @@ def __init__(self, params, num_qubits=None):
             and params is 3. This allows qubits 0 and 1 to be initialized to `|1>` and the
             remaining 3 qubits to be initialized to `|0>`.
         """
+        # pylint: disable=cyclic-import
+        from qiskit.quantum_info import Statevector
+
         if isinstance(params, Statevector):
             params = params.data