BindingsArray

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

Grundlagen: ShapedMixin

Speichert Parameter-Bindungswertsätze für ein qiskit.QuantumCircuit.

Ein einzelner Parameterbindungssatz liefert numerische Werte, die an einen Schaltkreis mit freien qiskit.circuit.Parameters gebunden werden. Eine Instanz dieser Klasse speichert eine als Array dargestellte Sammlung solcher Mengen. Das einfachste Beispiel ist ein 0-d-Array, das aus einem einzigen Parameterbindungssatz besteht, während ein n-d-Array aus Parameterbindungssätzen einen n-d-Durchlauf über Werte darstellt.

Das Speicherformat ist ein Wörterbuch aus Arrays, die an Parameter {params_0: values_0,...} angehängt sind. Es wird eine Konvention verwendet, bei der die letzte Dimension jedes Arrays (eine Teilmenge von) Schaltungsparametern indiziert. Wenn beispielsweise die letzte Dimension von values_0 25 ist, dann stellt dies ein Array möglicher Bindungswerte für die 25 verschiedenen Parameter dar params_0, wobei seine führende Form das Array shape seines Bindungsarrays ist. Dies ermöglicht Flexibilität hinsichtlich der Frage, ob die Werte für verschiedene Parameter in einem großen Array oder in mehreren kleineren Arrays gespeichert werden.

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

Initialisiere ein BindingsArray.

Das shape Argument muss nicht angegeben werden, wenn es eindeutig aus den angegebenen Arrays abgeleitet werden kann. Eine Mehrdeutigkeit entsteht immer dann, wenn der Schlüssel eines Eintrags data nur einen Parameter enthält und die Form des entsprechenden Arrays auf eine Eins endet. In diesem Fall lässt sich nicht entscheiden, ob es sich dabei um einen Index über Parameter handelt oder ob er in … integriert shapewerden sollte.

Da Parameter Objekte nur Float-Werte darstellen dürfen, wandelt diese Klasse alle übergebenen Werte in Float-Werte um. Wird ein inkompatibler Datentyp angegeben, wie beispielsweise komplexe Zahlen, wird TypeError eine Ausnahme ausgelöst.

Parameter

• data (BindingsArrayLike | None) – Eine Abbildung von einem oder mehreren Parametern auf Werte-Arrays, an die sie gebunden werden sollen, wobei die letzte Achse die Parameter umfasst.
• shape (ShapeInput | None) – Die führende Form jedes Arrays in diesen Bindungen.

Erhöhungen

• ValueError – Wenn alle Eingaben None.
• ValueError – Wenn die Form nicht automatisch aus den Arrays abgeleitet werden kann oder wenn die Form der angegebenen Arrays Unstimmigkeiten aufweist.
• TypeError – Wenn einige der Werte nicht in den Typ „float“ umgewandelt werden können.

Attribute

data

ndim

num_parameters

shape

size

Methoden

as_array

bind

bind_all

coerce

ravel

reshape

validate