Instalar la API de C

Requisitos previos

Antes de empezar, debes asegurarte de haber instalado la cadena de herramientas de Rust y el compilador clang.

Ahora, clona el repositorio qiskit-fermions.

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

A continuación, también debes compilar la API de C de Qiskit. Puedes hacerlo en cualquier ubicación, pero para empezar rápidamente, sigue estos pasos:

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

Sugerencia

Solo en Windows, debes copiar archivos de biblioteca adicionales:

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

Ahora puedes seguir los pasos de la siguiente sección para compilar la API de C de qiskit-fermions.

Compilar desde el código fuente

Para empezar, configura el entorno de tu shell con las ubicaciones de la biblioteca de la API de C de Qiskit compilada y de su directorio de inclusión.

Importante

La API de C se enlaza con la biblioteca C de Qiskit, por lo que QISKIT_LIB y QISKIT_INCLUDE deben apuntar a ella. Si no se definen, la compilación intenta inferirlas a partir de cualquier paquete qiskit de Python instalado que incluya sus artefactos de C (qiskit.capi.get_lib()/get_include()); defínelas explícitamente, como se muestra a continuación, para compilar contra una API de C de Qiskit compilada por separado, como el clon build/qiskit anterior.

Sugerencia

Este código usa la ruta build/qiskit del código que aparece al principio de esta página. Ajusta las rutas según tu configuración.

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

Ahora, compila la API de C de qiskit-fermions:

make cext

Si quieres probar tu instalación, ahora debes instalar también CMake. Luego puedes probar tu compilación ejecutando las pruebas unitarias de C:

make testc

Por último, verifica que ves estos archivos relevantes:

• dist/c/lib/libqiskit_fermions.so (El sufijo puede variar según tu sistema operativo)

• dist/c/include/qiskit_fermions.h