Qiskit/fr

Qiskit est une bibliothèque de programmation quantique à code source ouvert développée en Python par IBM. Comme PennyLane et Snowflurry, elle permet de construire, simuler et exécuter des circuits quantiques.

Installation¶

Chargez les dépendances de Qiskit.

module load StdEnv/2023 gcc python/3.11 symengine/0.11.2

Créez et activez un environnement virtuel Python.

virtualenv --no-download --clear ~/ENV && source ~/ENV/bin/activate

Installez une version spécifique de Qiskit.
```
(ENV) [name@server ~]$ pip install --no-index --upgrade pip
(ENV) [name@server ~]$ pip install --no-index qiskit==X.Y.Z qiskit_aer==X.Y.Z
```
où X.Y.Z représente le numéro de la version, par exemple 1.4.0. Pour installer la plus récente version disponible sur nos grappes, n'indiquez pas de version. Ici, nous n'avons importé que qiskit et qiskit_aer. Vous pouvez ajouter d'autres logiciels Qiskit en fonction de vos besoins en suivant la structure qiskit_package==X.Y.Z où qiskit_package représente le logiciel voulu, par exemple qiskit-finance. Les wheels présentement disponibles sont listés sur la page Wheels Python.

Validez l’installation de Qiskit.

(ENV)[name@server ~]$ python -c 'import qiskit'

Gelez l'environnement et les dépendances.

(ENV)[name@server ~]$ pip freeze --local > ~/qiskit_requirements.txt

Exécuter Qiskit sur une grappe¶

script.sh
#!/bin/bash
#SBATCH --account=def-someuser #indiquez le nom de votre compte
#SBATCH --time=00:15:00        #modifiez s'il y a lieu
#SBATCH --cpus-per-task=1      #modifiez s'il y a lieu
#SBATCH --mem-per-cpu=1G       #modifiez s'il y a lieu

# Chargez les dépendances des modules.
module load StdEnv/2023 gcc python/3.11 symengine/0.11.2

# Générez l'environnement virtuel dans $SLURM_TMPDIR.
virtualenv --no-download ${SLURM_TMPDIR}/env
source ${SLURM_TMPDIR}/env/bin/activate

# Installez Qiskit et ses dépendances.
pip install --no-index --upgrade pip
pip install --no-index --requirement ~/qiskit_requirements.txt

#Modifiez le programme Qiskit.
python qiskit_example.py

Vous pouvez ensuite soumettre votre tâche à l'ordonnanceur.

Utiliser Qiskit avec MonarQ¶

Il est possible d’utiliser directement MonarQ avec Qiskit via le plugiciel qiskit-calculquebec. Ce plugiciel permet de développer et d'exécuter des circuits Qiskit sur l’infrastructure de Calcul Québec.

Installation des dépendances¶

Étape 1 : Installer les dépendances

module load python/3.11
virtualenv --no-download --clear ~/ENV && source ~/ENV/bin/activate
pip install --no-index --upgrade pip
pip install --no-index qiskit-calculquebec
pip install --no-index qiskit-ibm-runtime
python -c "import qiskit; import qiskit_calculquebec"

Note

qiskit-calculquebec installe automatiquement Qiskit.

Initialisation du backend MonarQ et exécution du circuit¶

Étape 2 : Configurer vos identifiants et le backend
- Créez un client avec vos identifiants. Votre jeton est disponible via le portail Thunderhead.
- Le host est https://monarq.calculquebec.ca.
- Initialisez ensuite le backend MonarQ.

Étape 3 : Transpiler et exécuter le circuit

qiskit_example.py
import qiskit
from qiskit import QuantumCircuit
from qiskit_calculquebec.API.client import CalculQuebecClient
from qiskit_calculquebec.backends import MonarQBackend

# Identifiants
user = "username"
access_token = "token"
host = "https://monarq.calculquebec.ca"
project_id = "project_id"

# Création du client et du backend
my_client = CalculQuebecClient(host, user, access_token, project_id=project_id)
backend = MonarQBackend("monarq", my_client)

# Circuit simple
qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

from qiskit_ibm_runtime import SamplerV2 as Sampler
from qiskit.transpiler.preset_passmanagers import generate_preset_pass_manager

# Transpilation adaptée au backend
pm = generate_preset_pass_manager(optimization_level=3, backend=backend)
transpiled_qc = pm.run(qc)

# Exécution
sampler = Sampler(mode=backend)
job = sampler.run([transpiled_qc], shots=1000)

result = job.result()
print(result[0].data.meas.get_counts())

Notes¶

Info

La transpilation est nécessaire pour adapter le circuit à la connectivité et aux portes natives de MonarQ.
Le nombre de shots peut être ajusté selon les besoins (maximum : 1024).
L’utilisation de SamplerV2 est recommandée pour l’exécution de circuits avec mesures.