SamplerV2
class SamplerV2(mode=None, options=None)
Bases: BasePrimitiveV2[SamplerOptions], Sampler, BaseSamplerV2
Classe para interagir com o serviço primitivo do Qiskit Runtime Sampler.
Essa classe é compatível com a versão 2 da interface do Sampler, que usa formatos de entrada e saída diferentes da versão 1.
Qiskit Runtime A primitiva Sampler retorna o resultado da amostragem de acordo com o tipo de saída especificado. Por exemplo, ele retorna um bitstring para cada disparo se o nível de medição 2 (bits) for solicitado.
O método run() pode ser usado para enviar circuitos e parâmetros para o primitivo Sampler.
Parâmetros
-
mode (BackendV2 | Session |Batch | None) –
O modo de execução usado para fazer a consulta primitiva. Ele pode ser:
- A
Backendse você estiver usando o modo de trabalho. - A
Sessionse você estiver usando o modo de execução de sessão. - A
Batchse você estiver usando o modo de execução em lote.
Consulte a documentação Qiskit Runtime para obter mais informações sobre o
Execution modes. - A
-
options (dict | SamplerOptions | None) – Opções do amostrador; consulte
qiskit_ibm_runtime.options.SamplerOptionspara obter uma descrição detalhada.
Atributos
mode
Retorna o modo de execução usado por essa primitiva.
Retorna
Modo usado por essa primitiva, ou None se um modo de execução não for usado.
options
Tipo: SamplerOptions
Opções de devolução.
version
Valor Padrão: 2
Métodos
backend
run
run(pubs, *, shots=None)
Envie uma solicitação para o sampler primitivo.
Parâmetros
- pubs (Iterable[SamplerPubLike]) – Um iterável de objetos do tipo “pub”.
(circuit, parameter_values)Por exemplo, uma lista de circuitos ou tuplas. - shots (int | None) – O número total de disparos a serem amostrados para cada pub de amostrador que não especifica seus próprios disparos. Se
None, será usado o valor padrão de disparos da primitiva, que pode variar de acordo com a implementação.
Retorna
Trabalho enviado. O resultado do trabalho é uma instância de qiskit.primitives.containers.PrimitiveResult.
Aumentos
ValueError - São fornecidos argumentos inválidos.
Tipo de retorno