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)
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
boolde 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
probabilitiesdebe ser igual al número de filas debitstring_matrix. - ValueError - Las muestras por lote y el número de lotes deben ser números enteros positivos.
Tipo de retorno
postselect_and_subsample
postselect_and_subsample(bitstring_matrix, probabilities, *, hamming_right, hamming_left, samples_per_batch, num_batches, rand_seed=None)
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.
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
boolde 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
probabilitiesdebe ser igual al número de filas debitstring_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
postselect_by_hamming_right_and_left
postselect_by_hamming_right_and_left(bitstring_matrix, probabilities, *, hamming_right, hamming_left)
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
boolde 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_matrixdebe ser par. - ValueError - El número de elementos de
probabilitiesdebe ser igual al número de filas debitstring_matrix.
Tipo de retorno