Referencia de la API de gestión del rendimiento de Q-CTRL
Qiskit Functions — Herramientas preconfiguradas creadas por organizaciones asociadas — que abstraen partes del flujo de trabajo de desarrollo de software para simplificar y acelerar el descubrimiento de algoritmos y el desarrollo de aplicaciones a escala industrial. Haz clic aquí para ver la guía de esta función de Qiskit.
Guía de funciones de gestión del rendimiento de Qiskit
Fire Opal Performance Management admite circuitos abstractos, a diferencia de las primitivas nativas de « Qiskit Runtime », que solo admiten circuitos escritos en la arquitectura de conjunto de instrucciones (ISA) del backend de destino. Para obtener los mejores resultados, no compile los circuitos antes de enviarlos a través de la función de gestión del rendimiento.
Datos de entrada del estimador
QctrlEstimatorPubLike componentes (según la definición de Qiskit Runtime PUB ):
- Un único circuito definido como
QuantumCircuito en formato de cadena en OpenQASM, 2.0 o 3.0. - Una o varias variables observables que especifican los valores esperados que se van a estimar, en cualquiera de los formatos indicados en la lista «Formatos de variables observables admitidos».
- (Opcional) Una colección de valores de parámetros a los que se va a vincular el circuito, que siguen las mismas reglas de difusión de matrices que las
QiskitRuntimeprimitivas. - (Opcional) Una precisión objetivo para los valores esperados que se van a estimar.
- (Opcional) Un número real que representa la precisión, o un diccionario de opciones de ejecución que contenga el número de intentos. Por ejemplo:
{"shots": <int>}.
Formatos de observables compatibles:
- Cualquiera de los
ObservablesArrayLikeformatos, comoPauli,SparsePauliOp,PauliList, ostr - Una cuerda de Pauli:
"XY" - Un diccionario: cuerdas de Pauli con coeficientes:
{"XY": 0.5, "YZ": 0.3} - Una lista de cuerdas de Pauli:
["XY", "YZ", "ZX"] - Una lista de cuerdas de Pauli con coeficientes:
[("XY", 0.5), ("YZ", 0.3)] - Una lista anidada de cadenas de Pauli:
[["XY", "YZ"], ["ZX", "XX"]] - Una lista anidada de cadenas de Pauli con coeficientes:
[[("XY", 0.1), ("YZ", 0.2)], [("ZX", 0.3), ("XX", 0.4)]]
pubs
Tipo: `QctrlEstimatorPubLike` or `list[QctrlEstimatorPubLike]`
Valor predeterminado: N/A
Una o varias tuplas que contengan los datos de entrada enumerados en EstimatorPubLike «componentes»
- Obligatorio: Sí
- Ejemplo:
(circuit, observables, parameter_values)
backend_name
Tipo: `str`
Valor predeterminado: The least busy backend that your instance has access to
El nombre del backend
- Requisito: No
- Ejemplo:
"ibm_fez"
Opciones
Tipo: `dict`
Valor predeterminado: See Options section for more details
Las opciones de entrada para esta función se especifican como un diccionario anidado. Consulte la lista completa de opciones y sus valores predeterminados.
- Requisito: No
- Ejemplo:
{"default_shots": 2048}
Lista de opciones
session_id
Tipo: `str`
Un ID de sesión de Qiskit Runtime ya existente
- Ejemplo:
"cw4r3je6f0t010870y3g"
default_shots
Tipo: `int`
Valor predeterminado: `2048`
El número de repeticiones que hay que hacer en cada serie
default_precision
Tipo: `float`
La precisión deseada para los valores esperados que se deben estimar para cada circuito
- Ejemplo:
0.015625
job_tags
Tipo: `list[str]`
Valor predeterminado: `[]`
Una lista de etiquetas de empleo
Resultados del estimador
Tipo: `PrimitiveResult`
La lista PrimitiveResult correspondiente a los PUB de entrada
- Ejemplo:
PubResult(data=DataBin(evs=[0.1234], stds=[0.1]))
Entradas del sampler
QctrlSamplerPubLike componentes (según la definición de Qiskit Runtime PUB ):
- Un único circuito definido como
QuantumCircuito en formato de cadena en OpenQASM, 2.0 o 3.0. - (Opcional) Un conjunto de valores de parámetros con los que vincular el circuito.
- (Opcional) Un número entero que representa el número de tomas, o un diccionario de opciones de ejecución que contenga dicho número. Por ejemplo:
(circ, None, 123)o(circ, None, {"shots": 123}).
pubs
Tipo: `QctrlSamplerPubLike` or `list[QctrlSamplerPubLike]`
Una o varias tuplas que contengan los datos de entrada enumerados en SamplerPubLike «componentes»
- Obligatorio: Sí
- Ejemplo:
(circuit, parameter_values)
backend_name
Tipo: `str`
Valor predeterminado: The least busy backend that your instance has access to
El nombre del backend
- Requisito: No
- Ejemplo:
"ibm_fez"
Opciones
Tipo: `dict`
Valor predeterminado: See the Options section for details
Las opciones de entrada para esta función se especifican como un diccionario anidado. Consulte la lista completa de opciones y sus valores predeterminados.
- Requisito: No
- Ejemplo:
{"default_shots": 2048}
Lista de opciones
session_id
Tipo: `str`
Un ID de sesión de Qiskit Runtime ya existente
- Ejemplo:
"cw4r3je6f0t010870y3g"
default_shots
Tipo: `int`
Valor predeterminado: `2048`
El número de repeticiones que hay que hacer en cada serie
job_tags
Tipo: `list[str]`
Valor predeterminado: `[]`
La lista de etiquetas de empleo deseadas
Salidas del sampler
Tipo: `PrimitiveResult`
La lista PrimitiveResult correspondiente a los PUB de entrada
- Ejemplo:
PrimitiveResult([PubResult(data=DataBin(c=BitArray(<shape=(), num_shots=2048, num_bits=35>)), metadata={'shots': 2048})], metadata={provider_job_ids: 1234678})