Metadata-Version: 2.1
Name: qibolab
Version: 0.1.2
Summary: Quantum hardware module and drivers for Qibo
Home-page: https://qibo.science/
License: Apache-2.0
Author: The Qibo team
Requires-Python: >=3.9,<3.12
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Physics
Provides-Extra: qblox
Provides-Extra: qm
Provides-Extra: rfsoc
Provides-Extra: zh
Requires-Dist: laboneq (>=2.12.0) ; extra == "zh"
Requires-Dist: more-itertools (>=9.1.0,<10.0.0)
Requires-Dist: networkx (>=3.0,<4.0)
Requires-Dist: pyvisa-py (==0.5.3) ; extra == "qblox"
Requires-Dist: pyyaml (>=6.0,<7.0)
Requires-Dist: qblox-instruments (==0.11.0) ; extra == "qblox"
Requires-Dist: qcodes (>=0.37.0,<0.38.0) ; extra == "qblox" or extra == "rfsoc"
Requires-Dist: qcodes_contrib_drivers (==0.18.0) ; extra == "qblox" or extra == "rfsoc"
Requires-Dist: qibo (>=0.2.0,<0.3)
Requires-Dist: qibosoq (>=0.0.4,<0.2) ; extra == "rfsoc"
Requires-Dist: qm-qua (==1.1.1) ; extra == "qm"
Requires-Dist: qualang-tools (==0.14.0) ; extra == "qm"
Requires-Dist: setuptools (>67.0.0) ; extra == "qm"
Project-URL: Documentation, https://qibo.science/docs/qibolab/stable
Project-URL: Repository, https://github.com/qiboteam/qibolab/
Description-Content-Type: text/markdown

# Qibolab

![Tests](https://github.com/qiboteam/qibolab/workflows/Tests/badge.svg)
[![codecov](https://codecov.io/gh/qiboteam/qibolab/branch/main/graph/badge.svg?token=11UENAPBPH)](https://codecov.io/gh/qiboteam/qibolab)
[![DOI](https://zenodo.org/badge/241307936.svg)](https://zenodo.org/badge/latestdoi/241307936)

Qibolab is the dedicated [Qibo](https://github.com/qiboteam/qibo) backend for
the automatic deployment of quantum circuits on quantum hardware.

Some of the key features of Qibolab are:

* Deploy Qibo models on quantum hardware easily.
* Create custom experimental drivers for custom lab setup.
* Support multiple heterogeneous platforms.
* Use existing calibration procedures for experimentalists.

## Documentation

The qibolab backend documentation is available at [https://qibo.science/qibolab/stable/](https://qibo.science/qibolab/stable/).

## Minimum working example

A simple example on how to connect to a platform and use it execute a pulse sequence:

```python
from qibolab import create_platform, ExecutionParameters
from qibolab.pulses import DrivePulse, ReadoutPulse, PulseSequence

# Define PulseSequence
sequence = PulseSequence()
# Add some pulses to the pulse sequence
sequence.add(
    DrivePulse(
        start=0,
        amplitude=0.3,
        duration=4000,
        frequency=200_000_000,
        relative_phase=0,
        shape="Gaussian(5)",  # Gaussian shape with std = duration / 5
        channel=1,
    )
)

sequence.add(
    ReadoutPulse(
        start=4004,
        amplitude=0.9,
        duration=2000,
        frequency=20_000_000,
        relative_phase=0,
        shape="Rectangular",
        channel=2,
    )
)

# Define platform and load specific runcard
platform = create_platform("my_platform")

# Connects to lab instruments using the details specified in the calibration settings.
platform.connect()
# Configures instruments using the loaded calibration settings.
platform.setup()
# Turns on the local oscillators
platform.start()

# Execute a pulse sequence
options = ExecutionParameters(nshots=1000)
results = platform.execute_pulse_sequence(sequence, options)

# Print the acquired shots
print(results.samples)

# Turn off lab instruments
platform.stop()
# Disconnect from the instruments
platform.disconnect()
```

Here is another example on how to execute circuits:

```python
import qibo
from qibo import gates, models


# Create circuit and add gates
c = models.Circuit(1)
c.add(gates.H(0))
c.add(gates.RX(0, theta=0.2))
c.add(gates.X(0))
c.add(gates.M(0))


# Simulate the circuit using numpy
qibo.set_backend("numpy")
for _ in range(5):
    result = c(nshots=1024)
    print(result.probabilities())

# Execute the circuit on hardware
qibo.set_backend("qibolab", platform="my_platform")
for _ in range(5):
    result = c(nshots=1024)
    print(result.probabilities())
```

## Citation policy

If you use the package please refer to [the documentation](https://qibo.science/qibo/stable/appendix/citing-qibo.html#publications) for citation instructions.

