Skip to main content
IBM Quantum Platform

Sous-échantillonnage

qiskit_addon_sqd.subsampling

Fonctions permettant de créer des lots d'échantillons à partir d'une matrice de chaînes de bits.

subsample

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

GitHub

Sous-échantillonnage de lots de tableaux de bits à partir d'une entrée bitstring_matrix.

Chaque lot individuel sera échantillonné sans remplacement à partir de l'entrée bitstring_matrix. Les échantillons seront remplacés après la création de chaque lot, de sorte que des lots différents peuvent contenir des échantillons identiques.

Paramètres

  • bitstring_matrix (ndarray) – Un tableau 2D de représentations bool de valeurs binaires, de sorte que chaque ligne représente une chaîne de bits unique.
  • probabilities (ndarray) – Un tableau 1D spécifiant une distribution de probabilité sur les chaînes de bits
  • samples_per_batch (int) – Le nombre d'échantillons à prélever pour chaque lot
  • num_batches (int) – Le nombre de lots à générer
  • rand_seed (Generator |int | None) – Une graine pour contrôler le comportement aléatoire

Retours

Une liste de matrices de chaînes de bits sous-échantillonnées à partir de la matrice de chaînes de bits d'entrée.

Augmentations

  • ValueError - Le nombre d'éléments dans probabilities doit être égal au nombre de lignes dans bitstring_matrix.
  • ValueError - Les échantillons par lot et le nombre de lots doivent être des nombres entiers positifs.

Type de retour

liste [*ndarray* ]

postselect_and_subsample

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

GitHub

Sous-échantillonner des lots de tableaux de bits avec un poids de hamming correct à partir d'une entrée bitstring_matrix.

Les échantillons de chaînes de bits dont le poids de hamming est incorrect, que ce soit dans leur moitié gauche ou droite, ne seront pas échantillonnés.

Chaque lot individuel sera échantillonné sans remplacement à partir de l'entrée bitstring_matrix. Les échantillons seront remplacés après la création de chaque lot, de sorte que des lots différents peuvent contenir des échantillons identiques.

Déclassé depuis la version 0.12.0

La fonction qiskit_addon_sqd.subsampling.postselect_and_subsample() est obsolète depuis qiskit-addon-sqd 0.12.0. Il sera retiré au plus tôt à l'adresse suivante : v0.13.0. Utilisez plutôt les fonctions postselect_by_hamming_right_and_left et subsample .

Paramètres

  • bitstring_matrix (ndarray) – Un tableau 2D de représentations bool de valeurs binaires, de sorte que chaque ligne représente une chaîne de bits unique.
  • probabilities (ndarray) – Un tableau 1D spécifiant une distribution de probabilité sur les chaînes de bits
  • hamming_right (int) – Le poids de hamming cible pour la moitié droite des chaînes de bits échantillonnées
  • hamming_left (int) – Le poids de hamming cible pour la moitié gauche des chaînes de bits échantillonnées
  • samples_per_batch (int) – Le nombre d'échantillons à prélever pour chaque lot
  • num_batches (int) – Le nombre de lots à générer
  • rand_seed (Generator |int | None) – Une graine pour contrôler le comportement aléatoire

Retours

Une liste de matrices de chaînes de bits avec le poids de hamming correct, sous-échantillonnées à partir de la matrice de chaînes de bits d'entrée

Augmentations

  • ValueError - Le nombre d'éléments dans probabilities doit être égal au nombre de lignes dans bitstring_matrix.
  • ValueError - Les poids de Hamming doivent être des nombres entiers non négatifs.
  • ValueError - Les échantillons par lot et le nombre de lots doivent être des nombres entiers positifs.

Type de retour

liste [*ndarray* ]

postselect_by_hamming_right_and_left

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

GitHub

Post-sélectionner les chaînes de bits en fonction du poids de Hamming souhaité sur les moitiés droite et gauche.

Paramètres

  • bitstring_matrix (ndarray) – Un tableau 2D de représentations bool de valeurs binaires, de sorte que chaque ligne représente une chaîne de bits unique.
  • probabilities (ndarray) – Un tableau 1D spécifiant une distribution de probabilité sur les chaînes de bits
  • hamming_right (int) – Le poids de hamming cible pour la moitié droite des chaînes de bits échantillonnées
  • hamming_left (int) – Le poids de hamming cible pour la moitié gauche des chaînes de bits échantillonnées

Retours

Matrice de chaînes de bits post-sélectionnées et probabilités. La nouvelle matrice de chaînes de bits ne contient que les chaînes de bits de la matrice originale qui ont le poids de Hamming souhaité sur les moitiés droite et gauche, et les nouvelles probabilités sont construites en prenant les probabilités originales correspondant aux chaînes de bits post-sélectionnées et en les remettant à l'échelle pour que la somme soit égale à un.

Augmentations

  • ValueError - Les poids de Hamming doivent être des nombres entiers non négatifs.
  • ValueError - Le nombre de colonnes dans bitstring_matrix doit être pair.
  • ValueError - Le nombre d'éléments dans probabilities doit être égal au nombre de lignes dans bitstring_matrix.

Type de retour

tuple [*ndarray*, ndarray ]

Cette page a-t-elle été utile ?
Signaler un bogue, une coquille ou proposer du contenu sur GitHub.