Merge branch 'master' into devel

Author: kottmanj

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,52 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is. If you are referring to methods reported in papers please add a link to the paper (preferably Arxiv).
+
+**To Reproduce**
+Steps to reproduce the behavior: Ideally an executable code snipped like
+```python
+import tequila as tq
+
+U = tq.gates.Ry(angle="a", target=0)
+H = tq.paulis.X(0)
+E = tq.ExpectationValue(H=H, U=U)
+
+energy = tq.compile(E)
+
+eval = energy()
+
+```
+
+**Expected behavior**
+A clear and concise description of what you expected to happen or what you want to do.
+
+**Computer (please complete the following information):**
+ - OS: [e.g. iOS/Linux/Windows]
+ - Version [Python and Tequila]
+Get is via
+```
+import sys, platform
+import tequila as tq
+
+print("tequila version: ", tq.__version__)
+print("python version: ", sys.version)
+print("platform: ", platform.version())  
+
+```
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

CONTRIBUTING.md

@@ -0,0 +1,19 @@
+# How to contribute
+If you find any bugs or inconveniences in `tequila` please don't be shy and let us know.
+You can do so either by raising an issue here on github or contact us directly.
+
+If you already found a solution you can contribute to `tequila` over a pull-request.
+Here is how that works:
+
+1. Make a fork of `tequila` to your own github account.
+2. Checkout the `devel` branch and make sure it is up to date with the main [github repository](https://github.com/aspuru-guzik-group/tequila).
+3. Create and checkout a new branch from `devel` via `git branch pr-my-branch-name` followed by `git checkout pr-my-branch-name`. By typing `git branch` afterwards you can check which branch is currently checked out on your computer.
+4. Introduce changes to the code and commit them with git.
+5. Push the changes to *your* github account
+6. Log into github and create a pull request to the main [github repository](https://github.com/aspuru-guzik-group/tequila). The pull-request should be directed to the `devel` branch (but we can also change that afterwards).
+
+If you plan to introduce major changes to the base library it can be beneficial to contact us first.
+This way we might be able to avoid conflicts before they arise.
+
+If you used `tequila` for your research, feel free to include your algorithms here, either by integrating it into the core libraries or by demonstrating it with a notebook in the tutorials section. If you let us know about it, we will also add your research article in the list of research projects that use tequila (see the github repo
+s README).

README.md

@@ -228,6 +228,17 @@ K. Gratsea, C. Sun, P.D. Johnson
 When to Reject a Ground State Preparation Algorithm  
 [arxiv:2212.09492](https://doi.org/10.48550/arXiv.2212.09492)  
 
+R.P. Pothukuchi, L. Lufkin, Y.J. Shen, A. Simon, R. Thorstenson, B.E. Trevisan, M. Tu, M. Yang, B. Foxman, V. S. Pothukuchi, G. Epping, B. J. Jongkees, T.-H. Kyaw, J. R. Busemeyer, J. D Cohen, A. Bhattacharjee  
+Quantum Cognitive Modeling: New Applications and Systems Research Directions  
+[arxiv:2309.00597](https://arxiv.org/abs/2309.00597)  
+
+T.-H. Kyaw, M. B. Soley, B. Allen, P. Bergold, C. Sun, V.S. Batista and A. Aspuru-Guzik  
+Boosting quantum amplitude exponentially in variational quantum algorithms  
+[10.1088/2058-9565/acf4ba](doi.org/10.1088/2058-9565/acf4ba)  
+
+A.G. Cadavid, I. Montalban, A. Dalal, E. Solano, N.N. Hegade  
+Efficient DCQO Algorithm within the Impulse Regime for Portfolio Optimization  
+[arxiv:2308.15475](https://arxiv.org/abs/2308.15475)  
 
 Let us know, if you want your research project and/or tutorial to be included in this list!