Metadata-Version: 2.3
Name: tergite-autocalibration
Version: 2025.3.0
Summary: commandline application to calibrate the WACQT quantum computers automatically
Author: Eleftherios Moschandreou
Author-email: elemos@chalmers.se
Maintainer: Chalmers Next Labs AB
Maintainer-email: contact@quantum.chalmersnextlabs.se
Requires-Python: >=3.10,<3.11
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: Jinja2 (==3.1.2)
Requires-Dist: click (<8.2.0)
Requires-Dist: colorama (==0.4.6)
Requires-Dist: filelock (>=3.16.1,<4.0.0)
Requires-Dist: h5netcdf (==1.4.0)
Requires-Dist: h5py (==3.7.0)
Requires-Dist: jokeapi (==1.0.5)
Requires-Dist: matplotlib (>=3.9.3,<4.0.0)
Requires-Dist: netcdf4 (==1.7.1.post2)
Requires-Dist: numpy (>=2.0)
Requires-Dist: optuna (==4.0.0)
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: pydantic (==2.9.2)
Requires-Dist: pyqt5 (>=5.15.11,<6.0.0)
Requires-Dist: pyqt5-qt5 (==5.15.2) ; sys_platform == "linux"
Requires-Dist: pyqt5-qt5 (==5.15.2) ; sys_platform == "win32"
Requires-Dist: pyqt5-qt5 (>=5.15.2,<6.0.0) ; sys_platform == "darwin"
Requires-Dist: pyqtgraph (>=0.13.7,<0.14.0)
Requires-Dist: python-dotenv (==1.0.1)
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: requests (>=2.32.3,<3.0.0)
Requires-Dist: rich (>=14.0.0,<15.0.0)
Requires-Dist: scikit-learn (==1.5.2)
Requires-Dist: scipy (>=1.14.1,<2.0.0)
Requires-Dist: toml (==0.10.2)
Requires-Dist: tomlkit (>=0.13.2,<0.14.0)
Requires-Dist: typer (>=0.12.5,<0.13.0)
Requires-Dist: xarray (>=2024.11.0,<2025.0.0)
Description-Content-Type: text/markdown

# 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.10 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.10 -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 [Quarto](https://quarto.org/). 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 see the documentation for the branch that you are currently working on, please open
the [`docs/index.html`](./docs/index.html) file in your browser.
If the rendered documentation does not reflect the state of the documentation of the markdown files in `docs_editable`,
open a terminal in `docs_editable` and run:

```bash
quarto preview
```

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
 
