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)
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
boolde 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
probabilitiesdoit être égal au nombre de lignes dansbitstring_matrix. - ValueError - Les échantillons par lot et le nombre de lots doivent être des nombres entiers positifs.
Type de retour
postselect_and_subsample
postselect_and_subsample(bitstring_matrix, probabilities, *, hamming_right, hamming_left, samples_per_batch, num_batches, rand_seed=None)
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.
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
boolde 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
probabilitiesdoit être égal au nombre de lignes dansbitstring_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
postselect_by_hamming_right_and_left
postselect_by_hamming_right_and_left(bitstring_matrix, probabilities, *, hamming_right, hamming_left)
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
boolde 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_matrixdoit être pair. - ValueError - Le nombre d'éléments dans
probabilitiesdoit être égal au nombre de lignes dansbitstring_matrix.
Type de retour