Metadata-Version: 2.4
Name: tergite-autocalibration
Version: 2026.3.0
Summary: Commandline application to calibrate the WACQT quantum computers automatically
Author-email: Eleftherios Moschandreou <elemos@chalmers.se>, Liangyu Chen <liangyuc@chalmers.se>, Stefan Hill <stefanhi@chalmers.se>, Amr Osman <oarm@chalmers.se>, Tong Liu <liuto@chalmers.se>, Joel Sandås <sandas@chalmers.se>, Pontus Vikstål <pontus.vikstal@chalmersnextlabs.se>, Michele Faucci Giannelli <faucci@chalmers.se>, Axel Erik Andersson <axean@chalmers.se>
Maintainer-email: Chalmers Next Labs AB <contact@quantum.chalmersnextlabs.se>
Requires-Python: <3.13,>=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pyqt5-qt5==5.15.2; platform_system == "Linux"
Requires-Dist: pyqt5-qt5==5.15.2; platform_system == "Windows"
Requires-Dist: pyqt5-qt5<6.0.0,>=5.15.2; platform_system == "Darwin"
Requires-Dist: colorama==0.4.6
Requires-Dist: h5netcdf==1.4.0
Requires-Dist: h5py>=3.12.1
Requires-Dist: Jinja2==3.1.2
Requires-Dist: numpy>=2.0
Requires-Dist: qblox-instruments==0.14.2
Requires-Dist: qcodes==0.49.0
Requires-Dist: quantify-core==0.7.8
Requires-Dist: quantify-scheduler==0.21.2
Requires-Dist: redis==5.0.0
Requires-Dist: scikit-learn==1.5.2
Requires-Dist: toml==0.10.2
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: requests>=2.32.3
Requires-Dist: typer>=0.12.5
Requires-Dist: jokeapi==1.0.5
Requires-Dist: optuna==4.0.0
Requires-Dist: netcdf4==1.7.1.post2
Requires-Dist: tomlkit>=0.13.2
Requires-Dist: rich>=14.0.0
Requires-Dist: click<8.2.0
Requires-Dist: matplotlib>=3.9.3
Requires-Dist: scipy>=1.14.1
Requires-Dist: pandas>=2.2.3
Requires-Dist: xarray>=2024.11.0
Requires-Dist: filelock>=3.16.1
Requires-Dist: pyqtgraph>=0.13.7
Requires-Dist: pyqt5>=5.15.11
Requires-Dist: pydantic==2.9.2
Requires-Dist: dash>=3.1.1
Requires-Dist: dash-renderjson>=0.0.1
Requires-Dist: networkx==3.4.2
Provides-Extra: dev
Requires-Dist: jupyter>=1.0.0; extra == "dev"
Requires-Dist: black>=24.10.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: pylint>=3.3.8; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs-material==9.6.14; extra == "docs"
Requires-Dist: mkdocstrings[python]~=0.29; extra == "docs"
Requires-Dist: mkdocs-gen-files==0.5.0; extra == "docs"
Requires-Dist: mkdocs-literate-nav==0.6.2; extra == "docs"
Requires-Dist: mkdocs-jupyter==0.25.1; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest>=8.3.3; extra == "test"
Requires-Dist: requests-mock>=1.11.0; extra == "test"
Requires-Dist: pytest-cov>=7.0.0; extra == "test"
Requires-Dist: fakeredis>=2.32.1; extra == "test"
Dynamic: license-file

# Tergite Automatic Calibration

![CI](https://github.com/tergite/tergite-autocalibration/actions/workflows/ci.yml/badge.svg)

A commandline application to calibrate the WACQT quantum computers automatically.  

This project contains a calibration supervisor, a collection of calibration schedules and a collection of
post-processing and analysis routines.
It is developed and tested on WACQT Quantum Computer at Chalmers University of Technology.

**This project is developed by a core group of collaborators.**    
**Chalmers Next Labs AB (CNL) takes on the role of managing and maintaining this project.**

Note: The Tergite stack is developed on a separate version control system and mirrored on GitHub.
If you are reading this on GitHub, then you are looking at a mirror. 



## Quick Start

### Dependencies

- Ensure you have [conda](https://docs.anaconda.com/free/miniconda/index.html) installed.
  (_You could simply have python +3.12 installed instead._)
- Ensure you have [redis server](https://redis.io/) running
- The standard port for a redis server is `6379`, so, this is going to be filled in the `.env` configuration later.

```shell
redis-server
```

### Installation

- Clone the repo
- If you are developing on another server e.g. the development server, please replace the url to clone

```shell
git clone git@github.com:tergite/tergite-autocalibration.git
```

- Create conda environment

```shell
conda create -n tac -y python=3.12 -y
conda activate tac
```

- Install the application

```shell
cd tergite-autocalibration
pip install -e .
```

- Copy the `.example.env` file to `.env` and 
  update the environment variables there appropriately.
- Check out the section about configuration about which other configuration files have to be edited.

```shell
cp .example.env .env
```

- Start the automatic calibration

```shell
acli start
```

- For more help on other commands, type:

```shell
acli --help
```

### Documentation

The documentation is maintained using [MkDocs Material](https://squidfunk.github.io/mkdocs-material/). Everytime there is a release, you can find the
documentation from the release
on [https://tergite.github.io/tergite-autocalibration](https://tergite.github.io/tergite-autocalibration).

To preview the documentation for the branch you're currently working on you first need to install the project with documentation dependencies (only needed once):

```bash
pip install -e '.[docs]'
```
Then start the live preview server of the documentation from the root of the repository:

```bash
mkdocs serve
```

and open the URL shown in the terminal (typically [http://localhost:8000/](http://localhost:8000/)) in your browser.

If you are interested to edit the documentation, please check out the documentation section in
the [contribution guidelines](CONTRIBUTING.md#documentation). There is also a page in the documentation to help you
with [writing better documentation](./docs/developer-guide/writing_documentation.html).

## Contributing to the project

If you would like to contribute to tergite-autocalibration, please have a look at our
[contribution guidelines](./CONTRIBUTING.md).

### Authors

This project is a work of
[many contributors](https://github.com/tergite/tergite-autocalibration/graphs/contributors).

Special credit goes to the authors of this project as seen in the [CREDITS](./CREDITS.md) file.

### Change log

To view the changelog for each version, have a look at
the [CHANGELOG.md](./CHANGELOG.md) file.

### License

When you submit code changes, your submissions are understood to be under the
same [Apache 2.0 License](./LICENSE.txt) that covers the project.

## Acknowledgements

This project was sponsored by:

- [Knut and Alice Wallenberg Foundation](https://kaw.wallenberg.org/en) under
  the [Wallenberg Center for Quantum Technology (WACQT)](https://www.chalmers.se/en/centres/wacqt/) project
  at [Chalmers University of Technology](https://www.chalmers.se)
-   [Nordic e-Infrastructure Collaboration (NeIC)](https://neic.no) and [NordForsk](https://www.nordforsk.org/sv) under the [NordIQuEst](https://neic.no/nordiquest/) project
-   [European Union's Horizon Europe](https://research-and-innovation.ec.europa.eu/funding/funding-opportunities/funding-programmes-and-open-calls/horizon-europe_en) under the [OpenSuperQ](https://cordis.europa.eu/project/id/820363) project
-   [European Union's Horizon Europe](https://research-and-innovation.ec.europa.eu/funding/funding-opportunities/funding-programmes-and-open-calls/horizon-europe_en) under the [OpenSuperQPlus](https://opensuperqplus.eu/) project
 
