Installer l'API C

Prérequis

Avant de commencer, tu dois t'assurer d'avoir installé la chaîne d'outils Rust ainsi que le compilateur clang.

Maintenant, clone le dépôt qiskit-fermions.

git clone git@github.com:Qiskit/qiskit-fermions.git
cd qiskit-fermions

Ensuite, tu dois aussi compiler l'API C de Qiskit. Tu peux le faire à n'importe quel emplacement, mais pour démarrer rapidement, suis ces étapes :

git clone git@github.com:Qiskit/qiskit.git build/qiskit
cd build/qiskit
## git-checkout the latest stable tag
make c

Astuce

Uniquement sous Windows, tu dois copier des fichiers de bibliothèque supplémentaires :

Windows

cp target/release/qiskit_cext.dll dist/c/lib/qiskit_cext.dll
cp target/release/qiskit_cext.dll.lib dist/c/lib/qiskit_cext.dll.lib
cp target/release/qiskit_cext.dll.lib dist/c/lib/qiskit.dll.lib

Tu peux maintenant suivre les étapes de la section suivante pour compiler l'API C de qiskit-fermions.

Compiler depuis les sources

Pour commencer, configure l'environnement de ton shell avec les emplacements de ta bibliothèque de l'API C de Qiskit compilée et de son répertoire d'inclusion.

Important

L'API C est liée à la bibliothèque C de Qiskit, donc QISKIT_LIB et QISKIT_INCLUDE doivent pointer vers elle. Si elles ne sont pas définies, la compilation tente de les déduire à partir de tout package Python qiskit installé qui embarque ses artefacts C (qiskit.capi.get_lib()/get_include()) ; définis-les explicitement, comme ci-dessous, pour compiler avec une API C de Qiskit compilée séparément, comme le clone build/qiskit ci-dessus.

Astuce

Ce code utilise le chemin build/qiskit du code au début de cette page. Adapte les chemins à ta configuration.

UNIX

export QISKIT_LIB=$(find $(pwd)/build/qiskit/dist/c/lib -name "libqiskit.*")
export QISKIT_INCLUDE=$(pwd)/build/qiskit/dist/c/include

Windows

export QISKIT_LIB=$(find $(pwd)/build/qiskit/dist/c/lib -name "qiskit_cext.dll.lib")
export QISKIT_INCLUDE=$(pwd)/build/qiskit/dist/c/include

Maintenant, compile l'API C de qiskit-fermions :

make cext

Si tu veux tester ton installation, tu dois maintenant aussi installer CMake. Tu peux ensuite tester ta compilation en exécutant les tests unitaires C :

make testc

Enfin, vérifie que tu vois ces fichiers pertinents :

• dist/c/lib/libqiskit_fermions.so (le suffixe peut varier selon ton système d'exploitation)

• dist/c/include/qiskit_fermions.h