From 0043622010c69fcd870c019f581f90f213aef083 Mon Sep 17 00:00:00 2001 From: Renato Mello Date: Sun, 17 Mar 2024 11:39:38 +0400 Subject: [PATCH 1/8] add figure --- doc/source/_static/entangling_layer.png | Bin 0 -> 88196 bytes doc/source/api-reference/qibo.rst | 6 ++++++ 2 files changed, 6 insertions(+) create mode 100644 doc/source/_static/entangling_layer.png diff --git a/doc/source/_static/entangling_layer.png b/doc/source/_static/entangling_layer.png new file mode 100644 index 0000000000000000000000000000000000000000..413050188284555954920ece5fe496637ebec7fd GIT binary patch literal 88196 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 literal 0 HcmV?d00001 diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index c574c90145..40562b1502 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -391,6 +391,12 @@ Entangling layer Generates a layer of nearest-neighbour two-qubit gates, assuming 1-dimensional connectivity. +.. image:: ../_static/entangling_layer.png + :width: 1867px + :height: 1552px + :scale: 30 % + :align: center + .. autofunction:: qibo.models.encodings.entangling_layer From 6f4992126a2ba30c00e717b7b2f3860267bdd895 Mon Sep 17 00:00:00 2001 From: Renato Mello Date: Mon, 18 Mar 2024 20:04:47 +0400 Subject: [PATCH 2/8] improve api doc --- doc/source/api-reference/qibo.rst | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index 40562b1502..e896b2375c 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -390,13 +390,27 @@ Entangling layer """""""""""""""" Generates a layer of nearest-neighbour two-qubit gates, assuming 1-dimensional connectivity. +With the exception of :class:`qibo.gates.gates.GeneralizedfSim`, +can be set to any of the two-qubit gates implemented in ``qibo``. +If the chosen gate is parametrized, all phases are set to :math:`0.0`. +Note that these phases can be updated a posterior by using +:meth:`qibo.models.Circuit.set_parameters`. +There are four possible choices of layer ``architechture``: +``diagonal``, ``shifted``, ``even-layer``, and ``odd-layer``. +For instance, we show below an example for each architecture and ``nqubits = 6``. + .. image:: ../_static/entangling_layer.png - :width: 1867px + :width: 2500px :height: 1552px :scale: 30 % :align: center + +If ``closed_boundary`` is set to ``True``, then an extra gate is added connecting the last and the first qubit, +with the last qubit as the control qubit and the first qubit as a target qubit. + + .. autofunction:: qibo.models.encodings.entangling_layer @@ -1633,6 +1647,7 @@ We provide integration with the `stim `_ pac It is possible to run Clifford circuits using `stim` as an engine: .. code-block:: python + from qibo.backends import CliffordBackend from qibo.quantum_info import Clifford, random_clifford From 92bf9644240331213e773c607477a5a67dd77a9d Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Mon, 18 Mar 2024 16:07:15 +0000 Subject: [PATCH 3/8] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- doc/source/api-reference/qibo.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index e896b2375c..899245808a 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -390,12 +390,12 @@ Entangling layer """""""""""""""" Generates a layer of nearest-neighbour two-qubit gates, assuming 1-dimensional connectivity. -With the exception of :class:`qibo.gates.gates.GeneralizedfSim`, +With the exception of :class:`qibo.gates.gates.GeneralizedfSim`, can be set to any of the two-qubit gates implemented in ``qibo``. If the chosen gate is parametrized, all phases are set to :math:`0.0`. -Note that these phases can be updated a posterior by using +Note that these phases can be updated a posterior by using :meth:`qibo.models.Circuit.set_parameters`. -There are four possible choices of layer ``architechture``: +There are four possible choices of layer ``architechture``: ``diagonal``, ``shifted``, ``even-layer``, and ``odd-layer``. For instance, we show below an example for each architecture and ``nqubits = 6``. From 68309e128e74414155515d8075d5b88b93b995e0 Mon Sep 17 00:00:00 2001 From: Renato Mello Date: Tue, 19 Mar 2024 04:20:51 +0000 Subject: [PATCH 4/8] Update doc/source/api-reference/qibo.rst --- doc/source/api-reference/qibo.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index 899245808a..51020aca35 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -397,7 +397,7 @@ Note that these phases can be updated a posterior by using :meth:`qibo.models.Circuit.set_parameters`. There are four possible choices of layer ``architechture``: ``diagonal``, ``shifted``, ``even-layer``, and ``odd-layer``. -For instance, we show below an example for each architecture and ``nqubits = 6``. +For instance, we show below an example of each architecture for ``nqubits = 6``. .. image:: ../_static/entangling_layer.png From 4d29173788bd06d5a566baa0018931cb70719736 Mon Sep 17 00:00:00 2001 From: MatteoRobbiati Date: Tue, 19 Mar 2024 10:19:17 +0100 Subject: [PATCH 5/8] fix: standardize encoding images in the docs --- doc/source/api-reference/qibo.rst | 25 ++++++++++--------------- 1 file changed, 10 insertions(+), 15 deletions(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index 51020aca35..dfed994311 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -271,9 +271,8 @@ For instance, the following two circuit generations are equivalent: .. image:: ../_static/comp_basis_encoder.png - :width: 3400px - :height: 2000px - :scale: 25 % + :width: 400 + :height: 250 :align: center @@ -307,9 +306,8 @@ For instance, the following two circuit generations are equivalent: .. image:: ../_static/phase_encoder.png - :width: 1333px - :height: 1552px - :scale: 30 % + :width: 300 + :height: 300 :align: center @@ -346,9 +344,8 @@ For example, to encode a :math:`8`-dimensional data, one could use the so-called *tree* architechture below: .. image:: ../_static/unary_encoder_tree.png - :width: 1333px - :height: 1552px - :scale: 30 % + :width: 400 + :height: 500 :align: center where the first gate is the :class:`qibo.gates.X` @@ -361,9 +358,8 @@ On the other hand, the same encoding could be performed using the so-called *diagonal* (also known as *ladder*) architecture below: .. image:: ../_static/unary_encoder_ladder.png - :width: 1867px - :height: 1552px - :scale: 30 % + :width: 700 + :height: 550 :align: center This architecture leads to a choice of angles based on @@ -401,9 +397,8 @@ For instance, we show below an example of each architecture for ``nqubits = 6``. .. image:: ../_static/entangling_layer.png - :width: 2500px - :height: 1552px - :scale: 30 % + :width: 700 + :height: 450 :align: center From b1c075a5a42aca25adf02e06a339e777aff4c516 Mon Sep 17 00:00:00 2001 From: Renato Mello Date: Tue, 19 Mar 2024 10:32:20 +0000 Subject: [PATCH 6/8] Update doc/source/api-reference/qibo.rst Co-authored-by: Matteo Robbiati <62071516+MatteoRobbiati@users.noreply.github.com> --- doc/source/api-reference/qibo.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index 51020aca35..11fa7ab92d 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -395,7 +395,7 @@ can be set to any of the two-qubit gates implemented in ``qibo``. If the chosen gate is parametrized, all phases are set to :math:`0.0`. Note that these phases can be updated a posterior by using :meth:`qibo.models.Circuit.set_parameters`. -There are four possible choices of layer ``architechture``: +There are four possible choices of layer ``architecture``: ``diagonal``, ``shifted``, ``even-layer``, and ``odd-layer``. For instance, we show below an example of each architecture for ``nqubits = 6``. From 3f6e57309bb7a1d9c8b8ab7576a8efae8394febb Mon Sep 17 00:00:00 2001 From: Renato Mello Date: Tue, 19 Mar 2024 10:32:31 +0000 Subject: [PATCH 7/8] Update doc/source/api-reference/qibo.rst Co-authored-by: Matteo Robbiati <62071516+MatteoRobbiati@users.noreply.github.com> --- doc/source/api-reference/qibo.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index 11fa7ab92d..a32ed8600a 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -391,7 +391,7 @@ Entangling layer Generates a layer of nearest-neighbour two-qubit gates, assuming 1-dimensional connectivity. With the exception of :class:`qibo.gates.gates.GeneralizedfSim`, -can be set to any of the two-qubit gates implemented in ``qibo``. +any of the two-qubit gates implemented in ``qibo`` can be selected to customize the entangling layer. If the chosen gate is parametrized, all phases are set to :math:`0.0`. Note that these phases can be updated a posterior by using :meth:`qibo.models.Circuit.set_parameters`. From f29234ad5575e5859bfd5a1ff6049faa07e47f83 Mon Sep 17 00:00:00 2001 From: Renato Mello Date: Wed, 20 Mar 2024 15:38:24 +0400 Subject: [PATCH 8/8] adjust image --- doc/source/api-reference/qibo.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/api-reference/qibo.rst b/doc/source/api-reference/qibo.rst index 91aff4a35c..29d059ee29 100644 --- a/doc/source/api-reference/qibo.rst +++ b/doc/source/api-reference/qibo.rst @@ -397,7 +397,7 @@ For instance, we show below an example of each architecture for ``nqubits = 6``. .. image:: ../_static/entangling_layer.png - :width: 700 + :width: 800 :height: 450 :align: center