SamplerV2
class SamplerV2(mode=None, options=None)
Bases: BasePrimitiveV2[SamplerOptions], Sampler, BaseSamplerV2
SamplerV2 primitiva para IBM Quantum Compute (antes Qiskit Runtime ).
Esta clase es compatible con la versión 2 de la interfaz Sampler, que utiliza formatos de entrada y salida diferentes a los de la versión 1.
IBM Quantum Compute La primitiva «Sampler» devuelve el resultado muestreado según el tipo de salida especificado. Por ejemplo, devuelve una cadena de bits para cada disparo si se solicita el nivel de medición 2 (bits).
El método run() puede utilizarse para enviar circuitos y parámetros a la primitiva Sampler.
Parámetros
-
mode (BackendV2 | Session |Batch | None) –
El modo de ejecución utilizado para realizar la consulta primitiva. Puede ser:
- A
Backendsi está utilizando el modo trabajo. - A
Sessionsi está utilizando el modo de ejecución de sesión. - A
Batchsi está utilizando el modo de ejecución por lotes.
Consulte el IBM Quantum Compute documentación para obtener más información sobre el
Execution modes. - A
-
options (dict | options.SamplerOptions | None) – Opciones del muestreador: consulta
qiskit_ibm_runtime.options.SamplerOptionspara obtener una descripción detallada.
Atributos
mode
Devuelve el modo de ejecución utilizado por esta primitiva.
Devuelve
Modo utilizado por esta primitiva, o None si no se utiliza un modo de ejecución.
options
Opciones de devolución.
version
Valor predeterminado: 2
Métodos
backend
run
run(pubs, *, shots=None, dry_run=False)
Envíe una solicitud al primitivo muestreador.
Parámetros
- pubs (Iterable[SamplerPubLike]) – Un iterable de objetos similares a «pub».
(circuit, parameter_values)Por ejemplo, una lista de circuitos o tuplas. - shots (int | None) – El número total de disparos a muestrear para cada pub muestreador que no especifique sus propios disparos. Si
None, se utilizará el valor de disparos por defecto de la primitiva, que puede variar según la implementación. - dry_run (bool) – Si
True, realiza una simulación sin ejecutar el trabajo en una QPU. Este modo permite validar el trabajo, calcular el consumo y recuperar metadatos sobre la sincronización de los circuitos. Los resultados devueltos conservan el esquema esperado, pero contienen datos ficticios aleatorios en lugar de resultados de medición reales o simulados. A diferencia de los backends falsos, el procesamiento de esta simulación se lleva a cabo en el lado del servidor, por lo que es posible que la tarea no finalice de inmediato y que el acceso a esta función esté restringido.
Devuelve
Trabajo presentado. El resultado del trabajo es una instancia de qiskit.primitives.containers.PrimitiveResult.
Eleva
ValueError - Se han dado argumentos no válidos.
Tipo de retorno