BindingsArray

class qiskit.primitives.BindingsArray(data=None, shape=None)

Bases: ShapedMixin

Almacena conjuntos de valores de enlace de parámetros para un qiskit.QuantumCircuit.

Un único conjunto de enlaces de parámetros proporciona valores numéricos para vincular a un circuito con s qiskit.circuit.Parameterlibres. Una instancia de esta clase almacena una colección de conjuntos de este tipo, representada como una matriz. El ejemplo más sencillo es una matriz de dimensión 0 formada por un único conjunto de asignaciones de parámetros, mientras que una matriz de dimensión n de conjuntos de asignaciones de parámetros representa un barrido de dimensión n sobre los valores.

El formato de almacenamiento es un diccionario de matrices asociadas a los parámetros. {params_0: values_0,...} Se utiliza una convención según la cual la última dimensión de cada matriz indexa (un subconjunto de) los parámetros del circuito. Por ejemplo, si la última dimensión de values_0 es 25, entonces representa una matriz de posibles valores de enlace para los 25 parámetros distintos params_0, donde su forma inicial es la matriz shape de su matriz de enlace. Esto permite decidir con flexibilidad si los valores de los distintos parámetros se almacenan en una sola matriz grande o en varias matrices más pequeñas.

import numpy as np
from qiskit.primitives import BindingsArray

# 0-d array (i.e. only one binding)
BindingsArray({"a": 4, ("b", "c"): [5, 6]})

# single array, last index is parameters
parameters = tuple(f"a{idx}" for idx in range(100))
BindingsArray({parameters: np.ones((10, 10, 100))})

# multiple arrays, where each last index is parameters. notice that it's smart enough to
# figure out that a missing last dimension corresponds to a single parameter.
BindingsArray(
    {("c", "a"): np.zeros((10, 10, 2)), "b": np.ones((10, 10))}
)

Inicializar un BindingsArray.

No es necesario proporcionar el shape argumento siempre que pueda deducirse sin ambigüedad a partir de las matrices proporcionadas. La ambigüedad surge siempre que la clave de una entrada de data contiene un solo parámetro y la forma de la matriz correspondiente termina en uno. En este caso, no se puede determinar si se trata de un índice sobre los parámetros o si debería incorporarse en shape.

Dado que Parameter los objetos solo pueden representar valores de tipo float, esta clase convierte todos los valores proporcionados a float. Si se especifica un tipo de datos incompatible, como números complejos, se TypeError generará un error.

Parámetros

• data (BindingsArrayLike | None) – Una correspondencia entre uno o varios parámetros y matrices de valores a los que se van a asociar, en la que el último eje corresponde a los parámetros.
• shape (ShapeInput | None) – La forma inicial de cada matriz en estas definiciones.

Subidas

• ValueError – Si todas las entradas son None.
• ValueError – Si la forma no se puede deducir automáticamente a partir de las matrices, o si existe alguna inconsistencia en la forma de las matrices proporcionadas.
• TypeError – Si algunos de los valores no se pueden convertir al tipo float.

Atributos

data

ndim

num_parameters

shape

size

Métodos

as_array

bind

bind_all

coerce

ravel

reshape

validate