Mise en route#

Installation#

Commençons à utiliser Qiskit ! La première chose à faire est de choisir comment vous allez exécuter et installer les paquets. Il y a trois façons principales de le faire:

Qiskit supporte Python 3.7 ou une version supérieure. Cependant, Python et Qiskit sont des écosystèmes évolutifs, et parfois quand de nouvelles versions sont disponibles pour l’un ou l’autre, il peut y avoir des problèmes de compatibilité.

Vous aurez besoin de ` télécharger Python <https://wiki.python.org/moin/BeginnersGuide/Download>` __ sur votre système local pour commencer. ` Jupyter <https://jupyter.org/install>` __ est recommandé pour interagir avec Qiskit.

Nous recommandons d’utiliser des environnements virtuels Python <https://docs.python.org/3.10/tutorial/venv.html> __ pour séparer correctement Qiskit d’autres applications et améliorer votre expérience.

Créez un environnement minimal avec seulement Python installé.

python3 -m venv /path/to/virtual/environment

Activez votre nouvel environnement.

source /path/to/virtual/environment/bin/activate

Remarque : si vous utilisez Windows, utilisez les commandes suivantes dans PowerShell.

python3 -m venv c:\path\to\virtual\environment
c:\path\to\virtual\environment\Scripts\Activate.ps1

Ensuite, installez le package Qiskit.

pip install qiskit

Si les paquets se sont installés correctement, vous pouvez lancer la commande pip list pour voir les paquets actifs de votre environnement virtuel.

Si vous prévoyez d’utiliser la fonctionnalité de visualisation ou Jupyter notebooks il est recommandé d’installer qiskit avec les options supplémentaires de visualisation :

pip install qiskit[visualization]

Il est utile de préciser que si vous êtes un utilisateur de zsh (qui est le shell par défaut dans les nouvelles versions de macOS) que vous devrez mettre qiskit[visualization] entre guillemets :

pip install 'qiskit[visualization]'

Installing Qiskit from source allows you to access the current development version, instead of using the version in the Python Package Index (PyPI) repository. This will give you the ability to inspect and extend the latest version of the Qiskit code more efficiently.

Begin by making a new virtual environment and activating it:

python3 -m venv QiskitDevenv
source QiskitDevenv/bin/activate

L’installation à partir de la source nécessite que vous disposiez du compilateur Rust sur votre système. Pour installer le compilateur Rust, il est recommandé d’utiliser rustup, qui est un programme d’installation de Rust. Pour ce faire, vous pouvez aller à :

https://rustup.rs/

qui fournira des instructions pour installer rust sur votre plate-forme. En plus de rustup, il y a d’autres méthodes d’installation également disponibles.

Once the Rust compiler is installed, you are ready to install Qiskit.

  1. Clone the Qiskit repository.

    git clone https://github.com/Qiskit/qiskit-terra.git
    
  2. Le clonage du dépôt crée un dossier local appelé qiskit-terra.

    cd qiskit-terra
    
  3. Si vous souhaitez réaliser des tests ou faire de l’analyse de code source (linting), installez les pré-requis du développeur.

    pip install -r requirements-dev.txt
    
  4. Installez qiskit-terra.

    pip install .
    

Pour une installation en mode éditable (les changements dans le code sont alors pris en compte sans besoin de réinstaller le projet), vous pouvez choisir cette commande :

pip install -e .

L’installation en mode modifiable construira les extensions compilées en mode débogage et sans optimisation. Cela affectera les performances d’exécution du code compilé. Si vous souhaitez utiliser le mode modifiable et construire le code compilé avec des optimisations activées, vous pouvez exécuter :

python setup.py build_rust --release --inplace

après avoir exécuté pip et qui reconstruira le binaire en mode release. Si vous travaillez sur le code Rust dans Qiskit, vous devrez recompiler le code d’extension chaque fois que vous faites un changement local. pip install -e . ` ne construira l'extension Rust que lorsqu'il sera appelé, donc toutes les modifications locales que vous apportez au code Rust après l'exécution de pip ne seront pas reflétées dans le paquet installé, à moins que vous ne reconstruisiez l'extension. Vous pouvez utiliser la commande ``build_rust ci-dessus pour faire cela (avec ou sans --release selon que vous voulez construire en mode débogage ou en mode release).

You can then run the code examples after installing Qiskit. You can run the example with the following command.

python examples/python/using_qiskit_terra_level_0.py

Plateformes prises en charge#

Qiskit s’efforce de prendre en charge autant de plateformes que possible, mais en raison des limitations des ressources de test disponibles et de la disponibilité de la plateforme, toutes les plateformes ne peuvent pas être prises en charge. Le support de plateforme pour Qiskit est divisé en 3 niveaux avec différents niveaux de support pour chaque niveau. Pour les plateformes en dehors de celles-ci, Qiskit est probablement toujours installable, mais il n’est pas testé et vous aurez à construire Qiskit (et probablement les dépendances de Qiskit) à partir de la source.

De plus, Qiskit ne prend en charge que CPython. L’exécution avec d’autres interprèteur Python n’est pas prise en charge actuellement.

Niveau 1#

Les plates-formes prises en charge par le niveau 1 sont entièrement testées en amont dans le cadre des processus de développement pour s’assurer que tout changement proposé fonctionnera correctement. Les binaires pré-compilés sont construits, testés et publiés dans PyPI dans le cadre du processus de publication. Ces plates-formes sont censées être installables avec un environnement Python fonctionnel, car toutes les dépendances sont disponibles sur ces plates-formes.

Les plateformes de niveau 1 sont actuellement:

  • Linux x86_64 (distributions compatibles avec la spécification manylinux 2014).

  • macOS x86_64 (10.9 ou plus récent)

  • Windows 64 bits

Niveau 2#

Les plateformes de niveau 2 ne sont pas testées en amont dans le cadre du processus de développement. Cependant, les binaires pré-compilés sont construits, testés et publiés dans PyPI dans le cadre du processus de libération et ces paquets peuvent être installés avec un environnement Python fonctionnel.

Les plateformes de niveau 2 sont actuellement:

  • Linux i686 (distributions compatibles avec les spécifications d’empaquetage manylinux 2014) pour Python < 3.10

  • Windows 32 bits pour Python < 3.10

  • Linux aarch64 (distributions compatibles avec la spécification manylinux 2014)

Niveau 3#

Les plateformes de niveau 3 ne sont pas testées en amont dans le cadre du processus de développement. Les binaires pré-compilés sont construits et publiés dans PyPI dans le cadre du processus de publication, sans aucun test du tout. Ils peuvent ne pas être installables uniquement avec un environnement Python fonctionnel et peuvent nécessiter un compilateur C/C++ ou des programmes supplémentaires pour construire des dépendances à partir des sources dans le cadre du processus d’installation. La prise en charge de ces plates-formes est le meilleur effort possible.

Les plateformes de niveau 3 sont actuellement:

  • Linux ppc64le (distributions compatibles avec la spécification manylinux 2014)

  • Linux s390x (distributions compatibles avec la spécification manylinux 2014)

  • macOS arm64 (10.15 ou plus récent)

  • Linux i686 (distributions compatibles avec les spécifications d’empaquetage manylinux 2014) pour Python >= 3.10

  • Windows 32 bits pour Python > = 3.10

Prêt à y aller ?…#

Qiskit from the ground up

Learn how to build, execute, and post-process quantum circuits with Qiskit.

Start learning Qiskit

Dive into the tutorials

Find out how to leverage Qiskit for everything from single-circuits to full quantum application development.

Qiskit tutorials