Merge branch 'main' into pyproject_update

.pre-commit-config.yaml

@@ -20,6 +20,6 @@ repos:
       - id: isort
         args: ["--profile", "black"]
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.19.0
+    rev: v3.19.1
     hooks:
       - id: pyupgrade

README.md

@@ -53,7 +53,11 @@ If you use the Qibochem plugin please refer to the documentation for citation in
 
 ## Contact
 
-For questions, comments and suggestions please contact us at [https://matrix.to/#/#qibo:matrix.org](url)
+To get in touch with the community and the developers, consider joining the Qibo workspace on Matrix:
+
+[![Matrix](https://img.shields.io/matrix/qibo%3Amatrix.org?logo=matrix)](https://matrix.to/#/#qibo:matrix.org)
+
+If you have a question about the project, contact us at [📫](mailto:[email protected]).
 
 ## Contributing
 

doc/source/api-reference/ansatz.rst

@@ -30,3 +30,15 @@ Basis rotation
 --------------
 
 .. autofunction:: qibochem.ansatz.basis_rotation.basis_rotation_gates
+
+Givens Excitation
+-----------------
+
+.. autofunction:: qibochem.ansatz.givens_excitation.givens_excitation_circuit
+
+.. autofunction:: qibochem.ansatz.givens_excitation.givens_excitation_ansatz
+
+Symmetry-Preserving
+-------------------
+
+.. autofunction:: qibochem.ansatz.symmetry.symm_preserving_circuit

doc/source/appendix/citing-qibochem.rst

@@ -1,22 +1,20 @@
-Publications
-============
-
-If Qibochem has been significant in your research, and you would like to acknowledge
-the project in your academic publication, we suggest citing the following documents:
-
-Software References in Zenodo
------------------------------
-
-Wong Zicheng, Adrian Mak, Tan Le, Stefano Carrazza, Alessandro Candido, & Ye Jun. (2024). qiboteam/qibochem: Qibochem 0.0.1 (v0.0.1). Zenodo. https://doi.org/10.5281/zenodo.10473173
-
-Authorship Guideline
---------------------
-
-In order to appear as an author of a Qibochem publication (paper, proceedings, etc)
-each author must fullfil the following requirements:
-
-* Participate to the official meetings.
-
-* Contribute to the code with documented commits.
-
+Publications
+============
+
+If Qibochem has been significant in your research, and you would like to acknowledge the project in your academic publication, we suggest citing the following reference:
+
+Software References in Zenodo
+-----------------------------
+
+Wong Zi Cheng, Adrian Matthew Mak, Tan Le, Stefano Carrazza, Alessandro Candido & Ye Jun. (2024). qiboteam/qibochem: Qibochem 0.0.1 (v0.0.1). Zenodo. https://doi.org/10.5281/zenodo.10473173
+
+Authorship Guideline
+--------------------
+
+In order to appear as an author of a Qibochem publication (paper, proceedings, etc), one must fullfil the following requirements:
+
+* Participate to the official meetings.
+
+* Contribute to the code with documented commits.
+
 * Contribute to the manuscript elaboration.