tequila-tutorials

This repository functions as a tutorial collection for tequila.
Feel free to contribute your own! (see below)

Check out this small overview to get a glimpse on what tequila is,
or, get an overview through different slides and recordings of talks on different level of detail: See here.
Find the original tequila codebase here.

It's recommended to start with BasicUsage and take a look at FAQ.

The other tutorials are sorted into different directories depending on what they represent:

1. Main Directory: Basic Usage and Data Structures

• BasicUsage: How to use tequila (QCircuits, Hamiltonian, Objective, grad)
• QTensor: Tutorial on the QTensor class (works like numpy.ndarray just with tequila Objectives)
• BraKet: Tutorial on the BraKet class (automatically decomposes <X|H|y> into a tq.Objective)
• CircuitCompiler: Brief Overview on how gate compilation works
• Optimizers: Tutorial on supported optimizers (in-build, scipy, gpyopy)
• OpenQASMConversion: Interface with OpenQASM 2
• NoisySimulation: Tutorial on how to add noise instruction to simulations
• FAQ: Some frequently asked questions (cross-compiling, ibmq, ...)

2. Chemistry Directory: Tutorials on the supported chemistry modules (pyscf, psi4, madness) and applications
3. Research Directory: Tutorial collection on published research projects with tequila
4. Other Directory: Other features, applications, examples

Install tequila

Easiest is to pip install from github:

pip install git+https://github.com/aspuru-guzik-group/tequila.git

Do not install over PyPi (Minecraft lovers excluded)
pip install tequila

See the main repository for information.

Research projects with example code:

See the main repo for an extensive list.

Let us know, if you want your research project and/or tutorial to be included in this list!

How to add your own tutorial/demonstration

If you want to make your own tutorial or write a small notebook highlighting some of your research with tequila, here is how it works:

• Make a fork of this repository
• Add your own tutorial/demonstration on your branch
• Add your research article with or without link to your a possible tutorial/demonstration
• Make a pull request to this repo's main branch

How to contribute to tequila's core library

Similar procedure. Please check the main reposiory.