BindingsArray

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

Basi: ShapedMixin

Memorizza i set di valori di associazione dei parametri per un qiskit.QuantumCircuit.

Un singolo set di associazioni di parametri fornisce valori numerici da associare a un circuito con variabili qiskit.circuit.Parameter libere. Un oggetto di questa classe memorizza una collezione di tali insiemi, rappresentata come un array. L'esempio più semplice è un array a 0 dimensioni costituito da un unico insieme di associazioni di parametri, mentre un array a n dimensioni di insiemi di associazioni di parametri rappresenta una scansione a n dimensioni dei valori.

Il formato di memorizzazione è un dizionario di array associati ai parametri. {params_0: values_0,...} Si parla di convenzione quando l'ultima dimensione di ciascun array indica (un sottoinsieme di) parametri del circuito. Ad esempio, se l'ultima dimensione di values_0 è 25, allora rappresenta una matrice di possibili valori di associazione per i 25 parametri params_0distinti, dove la sua forma iniziale è la matrice shape della sua matrice di associazione. Ciò consente di scegliere se memorizzare i valori dei diversi parametri in un unico grande array o in diversi array più piccoli.

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))}
)

Inizializza un BindingsArray.

Non è necessario specificare shape l'argomento se può essere dedotto in modo univoco dagli array forniti. Si verifica un'ambiguità ogni volta che la chiave di una voce di data contiene un solo parametro e la dimensione dell'array corrispondente termina con un 1. In questo caso, non è possibile stabilire se si tratti di un indice sui parametri o se debba essere incorporato in shape.

Poiché Parameter gli oggetti possono rappresentare solo valori di tipo float, questa classe converte tutti i valori forniti in float. Se viene specificato un tipo di dati incompatibile, come i numeri complessi, verrà generata TypeError un'eccezione.

Parametri

• data (BindingsArrayLike | None) – Una mappatura da uno o più parametri a matrici di valori a cui associarli, in cui l'ultimo asse è costituito dai parametri.
• shape (ShapeInput | None) – La forma principale di ogni array in questi binding.

Aumenti

• ValueError – Se tutti gli input sono None.
• ValueError – Se la forma non può essere dedotta automaticamente dagli array, oppure se vi è qualche incongruenza nella forma degli array forniti.
• TypeError – Se alcuni valori non possono essere convertiti in un tipo float.

Attributi

data

ndim

num_parameters

shape

size

Metodi

as_array

bind

bind_all

coerce

ravel

reshape

validate