Skip to main content
IBM Quantum Platform

Unterabtastung

qiskit_addon_sqd.subsampling

Funktionen zur Erstellung von Stapeln von Proben aus einer Bitstring-Matrix.

subsample

subsample(bitstring_matrix, probabilities, samples_per_batch, num_batches, rand_seed=None)

GitHub

Teilstapel von Bitfeldern aus einer Eingabe bitstring_matrix.

Jede einzelne Charge wird ersatzlos aus der Eingabe bitstring_matrix entnommen. Die Proben werden nach der Erstellung jeder Partie ersetzt, so dass verschiedene Partien identische Proben enthalten können.

Parameter

  • bitstring_matrix (ndarray) – Ein 2D Array mit bool Darstellungen von Bitwerten, wobei jede Zeile einen einzelnen Bitstring darstellt.
  • probabilities (ndarray) – Ein 1D Array, das eine Wahrscheinlichkeitsverteilung über die Bitstrings angibt
  • samples_per_batch (int) – Die Anzahl der Proben, die für jede Charge zu ziehen sind
  • num_batches (int) – Die Anzahl der zu erzeugenden Chargen
  • rand_seed (Generator |int | None) – Ein Saatgut zur Kontrolle zufälligen Verhaltens

Rückgabe

Eine Liste von Bitstring-Matrizen, die aus der Eingabe-Bitstring-Matrix subsampled wurden.

Erhöht

  • ValueError - Die Anzahl der Elemente in probabilities muss der Anzahl der Zeilen in bitstring_matrix entsprechen.
  • ValueError - Proben pro Charge und Anzahl der Chargen müssen positive ganze Zahlen sein.

Rückgabetyp

list [*ndarray* ]

postselect_and_subsample

postselect_and_subsample(bitstring_matrix, probabilities, *, hamming_right, hamming_left, samples_per_batch, num_batches, rand_seed=None)

GitHub

Teilstichproben von Bit-Arrays mit korrektem Hamming-Gewicht aus einer Eingabe bitstring_matrix.

Bitstring-Samples mit falschem Hamming-Gewicht in der linken oder rechten Hälfte werden nicht gesampelt.

Jede einzelne Charge wird ersatzlos aus der Eingabe bitstring_matrix entnommen. Die Proben werden nach der Erstellung jeder Partie ersetzt, so dass verschiedene Partien identische Proben enthalten können.

Veraltet seit Version 0.12.0

Die Funktion qiskit_addon_sqd.subsampling.postselect_and_subsample() ist ab qiskit-addon-sqd 0.12.0 veraltet. Sie wird frühestens auf v0.13.0 entfernt. Verwenden Sie stattdessen die Funktionen postselect_by_hamming_right_and_left und subsample .

Parameter

  • bitstring_matrix (ndarray) – Ein 2D Array mit bool Darstellungen von Bitwerten, wobei jede Zeile einen einzelnen Bitstring darstellt.
  • probabilities (ndarray) – Ein 1D Array, das eine Wahrscheinlichkeitsverteilung über die Bitstrings angibt
  • hamming_right (int) – Das Ziel-Hamming-Gewicht für die rechte Hälfte der abgetasteten Bitstrings
  • hamming_left (int) – Das Ziel-Hamming-Gewicht für die linke Hälfte der abgetasteten Bitstrings
  • samples_per_batch (int) – Die Anzahl der Proben, die für jede Charge zu ziehen sind
  • num_batches (int) – Die Anzahl der zu erzeugenden Chargen
  • rand_seed (Generator |int | None) – Ein Saatgut zur Kontrolle zufälligen Verhaltens

Rückgabe

Eine Liste von Bitstring-Matrizen mit korrektem Hamming-Gewicht, die aus der Eingabe-Bitstring-Matrix subsampled wurden

Erhöht

  • ValueError - Die Anzahl der Elemente in probabilities muss der Anzahl der Zeilen in bitstring_matrix entsprechen.
  • ValueError - Die Hamming-Gewichte müssen nichtnegative ganze Zahlen sein.
  • ValueError - Proben pro Charge und Anzahl der Chargen müssen positive ganze Zahlen sein.

Rückgabetyp

list [*ndarray* ]

postselect_by_hamming_right_and_left

postselect_by_hamming_right_and_left(bitstring_matrix, probabilities, *, hamming_right, hamming_left)

GitHub

Nachselektion von Bitstrings basierend auf dem gewünschten Hamming-Gewicht auf der rechten und linken Hälfte.

Parameter

  • bitstring_matrix (ndarray) – Ein 2D Array mit bool Darstellungen von Bitwerten, wobei jede Zeile einen einzelnen Bitstring darstellt.
  • probabilities (ndarray) – Ein 1D Array, das eine Wahrscheinlichkeitsverteilung über die Bitstrings angibt
  • hamming_right (int) – Das Ziel-Hamming-Gewicht für die rechte Hälfte der abgetasteten Bitstrings
  • hamming_left (int) – Das Ziel-Hamming-Gewicht für die linke Hälfte der abgetasteten Bitstrings

Rückgabe

Nachgewählte Bitstring-Matrix und Wahrscheinlichkeiten. Die neue Bitstring-Matrix enthält nur die Bitstrings aus der ursprünglichen Matrix, die das gewünschte Hamming-Gewicht auf der rechten und linken Hälfte haben, und die neuen Wahrscheinlichkeiten werden konstruiert, indem man die ursprünglichen Wahrscheinlichkeiten nimmt, die den nachselektierten Bitstrings entsprechen, und sie so umskaliert, dass die Summe eins ergibt.

Erhöht

  • ValueError - Die Hamming-Gewichte müssen nichtnegative ganze Zahlen sein.
  • ValueError - Die Anzahl der Spalten in bitstring_matrix muss gerade sein.
  • ValueError - Die Anzahl der Elemente in probabilities muss der Anzahl der Zeilen in bitstring_matrix entsprechen.

Rückgabetyp

tupel [*ndarray*, ndarray ]

War diese Seite hilfreich?
Melden Sie auf GitHub einen Fehler, einen Tippfehler oder fordern Sie Inhalte an.