No project description provided
Project description
Table of contents
Introduction
The qiskit-symb
package is meant to be a Python tool to enable the symbolic evaluation of parametric quantum states and operators defined in Qiskit by parameterized quantum circuits.
A Parameterized Quantum Circuit (PQC) is a quantum circuit where we have at least one free parameter (e.g. a rotation angle $\theta$). PQCs are particularly relevant in Quantum Machine Learning (QML) models, where the values of these parameters can be learned during training to reach the desired output.
In particular, qiskit-symb
can be used to create a symbolic representation of a parametric quantum statevector, density matrix, or unitary operator directly from the Qiskit quantum circuit. This has been achieved through the re-implementation of some basic classes defined in the qiskit/quantum_info/
module by using sympy as a backend for symbolic expressions manipulation.
Installation
User-mode
pip install qiskit-symb
Dev-mode
git clone https://github.com/SimoneGasperini/qiskit-symb.git
cd qiskit-symb
pip install -r requirements-dev.txt
pip install -e .
Usage examples
Sympify a Qiskit circuit
Let's get started on how to use qiskit-symb
to get the symbolic representation of a given Qiskit circuit. In particular, in this first basic example, we consider the following quantum circuit:
from qiskit import QuantumCircuit
from qiskit.circuit import Parameter, ParameterVector
y = Parameter('y')
p = ParameterVector('p', length=2)
pqc = QuantumCircuit(2)
pqc.ry(y, 0)
pqc.cx(0, 1)
pqc.u(0, *p, 1)
pqc.draw('mpl')
To get the sympy representation of the unitary matrix corresponding to the parameterized circuit, we just have to create the symbolic Operator
instance and call the to_sympy()
method:
from qiskit_symb.quantum_info import Operator
op = Operator(pqc)
op.to_sympy()
\left[\begin{matrix}\cos{\left(\frac{y}{2} \right)} & - \sin{\left(\frac{y}{2} \right)} & 0 & 0\\0 & 0 & \sin{\left(\frac{y}{2} \right)} & \cos{\left(\frac{y}{2} \right)}\\0 & 0 & e^{i \left(p[0] + p[1]\right)} \cos{\left(\frac{y}{2} \right)} & - e^{i \left(p[0] + p[1]\right)} \sin{\left(\frac{y}{2} \right)}\\e^{i \left(p[0] + p[1]\right)} \sin{\left(\frac{y}{2} \right)} & e^{i \left(p[0] + p[1]\right)} \cos{\left(\frac{y}{2} \right)} & 0 & 0\end{matrix}\right]
If you want then to assign a value to some specific parameter, you can use the subs(<dict>)
method passing a dictionary that maps each parameter to the desired corresponding value:
params2value = {p: [-1, 2]}
new_op = op.subs(params2value)
new_op.to_sympy()
\left[\begin{matrix}\cos{\left(\frac{y}{2} \right)} & - \sin{\left(\frac{y}{2} \right)} & 0 & 0\\0 & 0 & \sin{\left(\frac{y}{2} \right)} & \cos{\left(\frac{y}{2} \right)}\\0 & 0 & e^{i} \cos{\left(\frac{y}{2} \right)} & - e^{i} \sin{\left(\frac{y}{2} \right)}\\e^{i} \sin{\left(\frac{y}{2} \right)} & e^{i} \cos{\left(\frac{y}{2} \right)} & 0 & 0\end{matrix}\right]
Lambdify a Qiskit circuit
Given a Qiskit circuit, qiskit-symb
also allows to generate a Python lambda function with actual arguments matching the Qiskit unbounded parameters.
Let's consider the following example starting from a ZZFeatureMap
circuit, commonly used as a data embedding ansatz in QML applications:
from qiskit.circuit.library import ZZFeatureMap
pqc = ZZFeatureMap(feature_dimension=3, reps=1)
pqc.draw('mpl')
To get the Python lambda function representing, for instance, the final parameterized statevector, we just have to create the symbolic Statevector
instance and call the to_lambda()
method:
from qiskit_symb.quantum_info import Statevector
sv = Statevector(pqc)
sv_func = sv.to_lambda()
We can now call the generated lambda function passing the actual values we want to assign to each free parameter (in alphabetical order, same convention used in qiskit-terra
). The returned object will be a numpy 2D-array (with shape=(8,1)
in this case) representing the final output statevector.
values = [1.24, 2.27, 0.29]
statevec = sv_func(*values)
REMARK
When the PQC has to be evaluated on a large number of different sets of parameters values (typical case in QML), this qiskit-symb
feature can help to significantly improve the (full-statevector) simulation performace. Indeed, the symbolic evalutation of the circuit and the lambda generation take place only once; then, the simulation only consists in executing multiple times the returned function passing a different set of parameters values for each iteration. For relatively shallow PQCs with a limilted number of qubits (e.g. Quantum Kernels evaluation), this can reduce the execution time up to two order of magnitudes (depending on the number of iterations) compared to the standard Qiskit simulation based on the Aer Simulators or the Sampler primitive.
Contributors
Simone Gasperini |
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for qiskit_symb-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 342f29d7798adca37e1b2dbfb387c2ee676e7a025d3678fd80d109b44413d555 |
|
MD5 | 3184fe99a41d4e25f7057f87dd10079b |
|
BLAKE2b-256 | 934bb28b22a5b3eb08e5dd34f485b290ad1457d013200f37dfdd40265778471c |