Contribution

code

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 on github or contact us directly.

How can you upload your own tutorial or research page?

How to install Quarto

For installing and using Quarto correctly, please take a look at some helpful links:

  • Installation: https://quarto.org/docs/get-started/
  • Quarto basics: https://quarto.org/docs/get-started/hello/rstudio.html

How to set up the environment and compile the blog

  1. Clone from source
  2. Create a conda environment with the name ‘BlogQa’ (concrete: opt/anaconda3/envs/BlogQA/bin/python3):
  • conda create -n BlogQA python=3.9
  • conda env list
  • python -m ipykernel install –user –name=BlogQA
  • conda install ipykernel
  • conda activate BlogQA
  1. Install the dependencies as well as everything needed regarding Jupyter and the BlogQA Kernel: In particular these are the following ones:
  • conda create -n BlogQA python=3.9
  • pip install pyyaml
  • pip install nbformat
  • pip install nbclient
  • pip install numpy
  • pip install scipy
  • pip install matplotlib
  • pip install tequila-basic
  • pip install qulacs
  • pip install pyscf

Also, these packages are necessary for the Documentation: * pip install sphinx * pip install sphinxcontrib * pip install sphinxcontrib-programoutput * pip install sphinx-rtd-theme

  1. Preview with “quarto preview”

How to add your contribution

First, please make sure that only ipynb-files or quarto-files are allowed as tutorials or research pages for the website. Within these, the following HTML parameters can be placed in a separate markdown at the top, before the actual content begins:

title: "Any titel"
author: "Your full name"
date: "yyyy-mm-dd"
categories: [code]
image: "Preview_Image.png"
image-width: "1cm"
image-height: "1cm"
format:
    html:
        code-fold: false
        eval: true
jupyter: blogqa

Begin and end this section with three hyphens (—)

How to submit

  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.
  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. Navigate to the tutorial/ researches folder and create your own subfolder, which you name with the tutorial/research name. This subfolder should include your ipynb/quarto-file (as well as other necessary files, such as png-files for importing images).
  5. Introduce changes to the code and commit them with git.
  6. Push the changes to your github account.
  7. Log into github and create a pull request to the main github repository. The pull request should be directed to the devel branch (but we can also change that afterwards).

If you would like to include a preview image with your contribution, feel free to use our preview image template. It is available as a .png file (for non-macOS users) and a Keynote file (for macOS users). You can find the template in the main folder alongside the other files.

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 repos README).