Skip to main content
IBM Quantum Platform

Submuestreo

qiskit_addon_sqd.subsampling

Funciones para crear lotes de muestras a partir de una matriz de cadenas de bits.

subsample

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

GitHub

Submuestreo de lotes de matrices de bits a partir de una entrada bitstring_matrix.

Cada lote individual se muestreará sin sustitución a partir de la entrada bitstring_matrix. Las muestras se sustituirán tras la creación de cada lote, por lo que distintos lotes pueden contener muestras idénticas.

Parámetros

  • bitstring_matrix (ndarray) – Una matriz 2D de representaciones bool de valores de bits de forma que cada fila representa una única cadena de bits.
  • probabilities (ndarray) – Una matriz 1D que especifica una distribución de probabilidad sobre las cadenas de bits
  • samples_per_batch (int) – El número de muestras a extraer por cada lote
  • num_batches (int) – El número de lotes a generar
  • rand_seed (Generator |int | None) – Una semilla para controlar el comportamiento aleatorio

Devuelve

Una lista de matrices de cadenas de bits submuestreadas a partir de la matriz de cadenas de bits de entrada.

Eleva

  • ValueError - El número de elementos de probabilities debe ser igual al número de filas de bitstring_matrix.
  • ValueError - Las muestras por lote y el número de lotes deben ser números enteros positivos.

Tipo de retorno

list [*ndarray* ]

postselect_and_subsample

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

GitHub

Submuestreo de lotes de matrices de bits con el peso hamming correcto a partir de una entrada bitstring_matrix.

Las muestras de cadenas de bits con un peso hamming incorrecto en su mitad izquierda o derecha no se muestrearán.

Cada lote individual se muestreará sin sustitución a partir de la entrada bitstring_matrix. Las muestras se sustituirán tras la creación de cada lote, por lo que distintos lotes pueden contener muestras idénticas.

Obsoleto desde la versión 0.12.0

La función qiskit_addon_sqd.subsampling.postselect_and_subsample() está obsoleta a partir de qiskit-addon-sqd 0.12.0. Se retirará no antes de v0.13.0. En su lugar, utilice las funciones postselect_by_hamming_right_and_left y subsample .

Parámetros

  • bitstring_matrix (ndarray) – Una matriz 2D de representaciones bool de valores de bits de forma que cada fila representa una única cadena de bits.
  • probabilities (ndarray) – Una matriz 1D que especifica una distribución de probabilidad sobre las cadenas de bits
  • hamming_right (int) – El peso hamming objetivo para la mitad derecha de las cadenas de bits muestreadas
  • hamming_left (int) – El peso hamming objetivo para la mitad izquierda de las cadenas de bits muestreadas
  • samples_per_batch (int) – El número de muestras a extraer por cada lote
  • num_batches (int) – El número de lotes a generar
  • rand_seed (Generator |int | None) – Una semilla para controlar el comportamiento aleatorio

Devuelve

Una lista de matrices de cadenas de bits con el peso hamming correcto submuestreadas a partir de la matriz de cadenas de bits de entrada

Eleva

  • ValueError - El número de elementos de probabilities debe ser igual al número de filas de bitstring_matrix.
  • ValueError - Los pesos Hamming deben ser enteros no negativos.
  • ValueError - Las muestras por lote y el número de lotes deben ser números enteros positivos.

Tipo de retorno

list [*ndarray* ]

postselect_by_hamming_right_and_left

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

GitHub

Posselección de cadenas de bits en función del peso Hamming deseado en las mitades derecha e izquierda.

Parámetros

  • bitstring_matrix (ndarray) – Una matriz 2D de representaciones bool de valores de bits de forma que cada fila representa una única cadena de bits.
  • probabilities (ndarray) – Una matriz 1D que especifica una distribución de probabilidad sobre las cadenas de bits
  • hamming_right (int) – El peso hamming objetivo para la mitad derecha de las cadenas de bits muestreadas
  • hamming_left (int) – El peso hamming objetivo para la mitad izquierda de las cadenas de bits muestreadas

Devuelve

Matriz de cadenas de bits postseleccionadas y probabilidades. La nueva matriz de cadenas de bits contiene sólo aquellas cadenas de bits de la matriz original que tienen el peso Hamming deseado en las mitades derecha e izquierda, y las nuevas probabilidades se construyen tomando las probabilidades originales correspondientes a las cadenas de bits postseleccionadas y reescalándolas para que sumen uno.

Eleva

  • ValueError - Los pesos Hamming deben ser enteros no negativos.
  • ValueError - El número de columnas en bitstring_matrix debe ser par.
  • ValueError - El número de elementos de probabilities debe ser igual al número de filas de bitstring_matrix.

Tipo de retorno

tuple [*ndarray*, ndarray ]

¿Le ha resultado útil esta página?
Informe de un error, de una errata o solicite contenido en GitHub.