BindingsArray

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

Bases: ShapedMixin

Armazena conjuntos de valores de ligação de parâmetros para um qiskit.QuantumCircuit.

Um único conjunto de ligações de parâmetros fornece valores numéricos para serem associados a um circuito com variáveis qiskit.circuit.Parameter livres. Uma instância desta classe armazena uma coleção, do tipo matriz, desses conjuntos. O exemplo mais simples é uma matriz de dimensão 0 composta por um único conjunto de ligações de parâmetros, enquanto uma matriz de dimensão n de conjuntos de ligações de parâmetros representa uma varredura de n dimensões sobre os valores.

O formato de armazenamento é um dicionário de matrizes associadas a parâmetros. {params_0: values_0,...} Utiliza-se uma convenção em que a última dimensão de cada matriz indexa (um subconjunto de) parâmetros do circuito. Por exemplo, se a última dimensão de values_0 for 25, isso representa uma matriz de valores de ligação possíveis para os 25 parâmetros distintos params_0, em que sua forma inicial é a matriz shape da sua matriz de ligação. Isso permite flexibilidade quanto à forma de armazenamento dos valores dos diferentes parâmetros: em uma única matriz grande ou em várias matrizes menores.

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 um BindingsArray.

Não é necessário fornecer o shape argumento sempre que ele possa ser deduzido de forma inequívoca a partir das matrizes fornecidas. Surge ambiguidade sempre que a chave de uma entrada do data contém apenas um parâmetro e a forma da matriz correspondente termina em um. Nesse caso, não é possível determinar se trata-se de um índice sobre os parâmetros ou se deve ser incorporado em shape.

Como Parameter os objetos só podem representar valores do tipo float, esta classe converte todos os valores fornecidos para o tipo float. Se for especificado um tipo de dados incompatível, como números complexos, será gerada TypeError uma exceção.

Parâmetros

• data (BindingsArrayLike | None) – Um mapeamento de um ou mais parâmetros para matrizes de valores aos quais eles serão vinculados, em que o último eixo corresponde aos parâmetros.
• shape (ShapeInput | None) – A forma inicial de cada matriz nessas ligações.

Aumentos

• ValueError – Se todas as entradas forem None.
• ValueError – Se a forma não puder ser inferida automaticamente a partir das matrizes, ou se houver alguma inconsistência na forma das matrizes fornecidas.
• TypeError – Se alguns dos valores não puderem ser convertidos para o tipo float.

Atributos

data

ndim

num_parameters

shape

size

Métodos

as_array

bind

bind_all

coerce

ravel

reshape

validate