Subamostragem
qiskit_addon_sqd.subsampling
Funções para criar lotes de amostras a partir de uma matriz de bitstring.
subsample
subsample(bitstring_matrix, probabilities, samples_per_batch, num_batches, rand_seed=None)
Subamostragem de lotes de matrizes de bits de uma entrada bitstring_matrix.
Cada lote individual será amostrado sem substituição da entrada bitstring_matrix. As amostras serão substituídas após a criação de cada lote, portanto, lotes diferentes podem conter amostras idênticas.
Parâmetros
- bitstring_matrix (ndarray) – Uma matriz 2D de
boolrepresentações de valores de bits, de modo que cada linha representa uma única cadeia de bits. - probabilities (ndarray) – Uma matriz 1D que especifica uma distribuição de probabilidade sobre as cadeias de bits
- samples_per_batch (int) – O número de amostras a serem retiradas para cada lote
- num_batches (int) – O número de lotes a serem gerados
- rand_seed (Generator |int | None) – Uma semente para controlar o comportamento aleatório
Retorna
Uma lista de matrizes de bitstring subamostradas da matriz de bitstring de entrada.
Aumentos
- ValueError - O número de elementos em
probabilitiesdeve ser igual ao número de linhas embitstring_matrix. - ValueError - As amostras por lote e o número de lotes devem ser números inteiros 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)
Subamostragem de lotes de matrizes de bits com peso hamming correto a partir de uma entrada bitstring_matrix.
Amostras de bitstring com peso hamming incorreto na metade esquerda ou direita não serão amostradas.
Cada lote individual será amostrado sem substituição da entrada bitstring_matrix. As amostras serão substituídas após a criação de cada lote, portanto, lotes diferentes podem conter amostras idênticas.
A função qiskit_addon_sqd.subsampling.postselect_and_subsample() está obsoleta desde o qiskit-addon-sqd 0.12.0. Ele não será removido antes de v0.13.0. Em vez disso, use as funções postselect_by_hamming_right_and_left e subsample .
Parâmetros
- bitstring_matrix (ndarray) – Uma matriz 2D de
boolrepresentações de valores de bits, de modo que cada linha representa uma única cadeia de bits. - probabilities (ndarray) – Uma matriz 1D que especifica uma distribuição de probabilidade sobre as cadeias de bits
- hamming_right (int) – O peso hamming alvo para a metade direita das cadeias de bits amostradas
- hamming_left (int) – O peso hamming alvo para a metade esquerda das cadeias de bits amostradas
- samples_per_batch (int) – O número de amostras a serem retiradas para cada lote
- num_batches (int) – O número de lotes a serem gerados
- rand_seed (Generator |int | None) – Uma semente para controlar o comportamento aleatório
Retorna
Uma lista de matrizes de bitstring com peso hamming correto subamostrado da matriz de bitstring de entrada
Aumentos
- ValueError - O número de elementos em
probabilitiesdeve ser igual ao número de linhas embitstring_matrix. - ValueError - Os pesos de Hamming devem ser inteiros não negativos.
- ValueError - As amostras por lote e o número de lotes devem ser números inteiros positivos.
Tipo de retorno
postselect_by_hamming_right_and_left
postselect_by_hamming_right_and_left(bitstring_matrix, probabilities, *, hamming_right, hamming_left)
Faça a pós-seleção das cadeias de bits com base no peso de Hamming desejado nas metades direita e esquerda.
Parâmetros
- bitstring_matrix (ndarray) – Uma matriz 2D de
boolrepresentações de valores de bits, de modo que cada linha representa uma única cadeia de bits. - probabilities (ndarray) – Uma matriz 1D que especifica uma distribuição de probabilidade sobre as cadeias de bits
- hamming_right (int) – O peso hamming alvo para a metade direita das cadeias de bits amostradas
- hamming_left (int) – O peso hamming alvo para a metade esquerda das cadeias de bits amostradas
Retorna
Matriz de bitstring pós-selecionada e probabilidades. A nova matriz de cadeias de bits contém apenas as cadeias de bits da matriz original que têm o peso de Hamming desejado nas metades direita e esquerda, e as novas probabilidades são construídas pegando as probabilidades originais correspondentes às cadeias de bits pós-selecionadas e redimensionando-as para somar um.
Aumentos
- ValueError - Os pesos de Hamming devem ser inteiros não negativos.
- ValueError - O número de colunas em
bitstring_matrixdeve ser par. - ValueError - O número de elementos em
probabilitiesdeve ser igual ao número de linhas embitstring_matrix.
Tipo de retorno