Referencia de la API de Quantum Elements Orbit

Tipo: Iterable[SamplerPubLike] or Iterable[EstimatorPubLike]

Uno o varios PUB que coincidan con la primitiva seleccionada.

• Obligatorio: Sí
• Tipos de entrada válidos: iterable de objetos similares a Sampler PUB o iterable de objetos similares a Estimator PUB

Cada « PUB » debe coincidir con el contrato de entrada de la primitiva seleccionada.

• primitive="sampler"Para cada PUB, se sigue la forma del Sampler PUB, como por ejemplo (circuit, parameter_values, shots).
• primitive="estimator"Para cada PUB, se sigue la forma del estimador PUB, como por ejemplo (circuit, observables, parameter_values, precision).
• No es necesario que los circuitos sean circuitos ISA en la ruta predeterminada options.transpilation_mode="optimize" ; Orbit los transpilúa y los programa internamente.

Tipo: str

Selecciona qué primitiva de « IBM Quantum » utiliza Orbit para la ejecución.

• Obligatorio: Sí
• Tipos de entrada válidos: str

La primitiva determina qué debe contener cada « PUB » y qué datos de resultado devuelve cada PubResult una de ellas.

• Opciones: "sampler" / "estimator"
• Utilízalo "sampler" para datos de cadenas de bits muestreadas.
• Utiliza "estimator" para los valores esperados y los errores estándar.

Tipo: str or None

Valor predeterminado: None

Nombre del backend de « IBM Quantum » en el que se va a ejecutar.

• Obligatorio: No

• Valor predeterminado: None

• Tipos de entrada válidos: str o None

• Cuando se omite o None, Orbit determina un backend operativo válido que no sea un simulador mediante least_busy().

• Ejemplo:"ibm_boston"

Tipo: dict or None

Valor predeterminado: None

Opciones específicas de cada función que controlan el comportamiento de ejecución de Orbit.

• Obligatorio: No
• Valor predeterminado: None
• Tipos de entrada válidos: dict o None

Las opciones controlan la transpilación, la inserción de DD, las opciones de Quantum Compute, el modo de vista previa, el modo de simulador, la exportación de información del backend y la mitigación de errores de medición.

• Las teclas de opción desconocidas se rechazan.
• Introduce None, {}, u omite options para utilizar todos los valores predeterminados.
• Ejemplo:

{
    "pub_options": [
        {"mode": "raw"},
        {"mode": "orbit"},
        {
            "mode": "custom",
            "dd_strategy": [[{"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1}]],
            "transpilation_mode": "optimize",
            "mem": True
        }
    ]
}

Tipo: bool

Valor predeterminado: False

Si Orbit devuelve un informe de inserción de DD sin enviar un trabajo de computación cuántica.

• Obligatorio: No

• Valor predeterminado: False

• Tipos de entrada válidos: bool

• TrueEn ese caso, no se utiliza tiempo de la QPU; Orbit se limita a preprocesar los circuitos y pubs proporciona un informe de inserción.

• Cuando False (valor por defecto), se envía y se procesa un trabajo de computación cuántica con circuitos modificados por Orbit.

• Si tanto preview como simulator son True, prevalece el modo de vista previa y se ignora la ejecución del simulador.

Tipo: bool

Valor predeterminado: False

Si el modo de vista previa incluye el circuito post-Orbit preparado para cada PUB en los metadatos.

• Obligatorio: No

• Valor predeterminado: False

• Tipos de entrada válidos: bool

• Se utiliza únicamente cuando preview=True.

• Cada informe de True PUB incluye debugCircuit.circuit, debugCircuit.usedQubits, y el recuento de operaciones. También incluye el enfoque de «mejor esfuerzo» debugCircuit.qasm cuando Qiskit puede exportar el circuito.

• Deja esta opción desactivada en las ejecuciones normales, ya que las cargas útiles de los circuitos pueden ser grandes.

Tipo: string

Valor predeterminado: optimize

Cómo prepara Orbit los circuitos de « PUB » antes de la inserción de los dispositivos DD.

• Obligatorio: No

• Valor predeterminado: "optimize"

• Valores válidos: "optimize", "prepare", o "validate"

• "optimize" ejecuta repetidamente la transpilación de Qiskit optimization_level=2 y selecciona la opción con la menor profundidad de dos qubits tanto para circuitos estáticos como dinámicos.

• "prepare" se encarga de la preparación de Qiskit optimization_level=0 y de la programación de ALAP. Si physical_layout se proporciona, Orbit primero materializa el circuito en esos índices de cables físicos y utiliza el método de diseño «trivial» de Qiskit.

• "validate" considera que el circuito de entrada ya está preparado físicamente. Orbit comprueba la compatibilidad del backend siempre que sea posible, no reasigna, redirige, optimiza ni repara la programación antes de la inserción del DD, y lo ignora physical_layout mostrando una advertencia.

Tipo: object or null

Valor predeterminado: None

Asignación opcional de qubits lógicos a físicos.

• Obligatorio: No
• Valor predeterminado: None
• Tipos de entrada válidos: objeto con claves y valores enteros no negativos, o None

Ejemplo: {"0": 85, "1": 89} asigna el qubit lógico 0 al qubit físico 85 y el qubit lógico 1 al qubit físico 89. Python Los usuarios pueden utilizar claves de tipo entero; las claves de los objetos JSON son cadenas de caracteres.

• En "optimize" este modo, esto se pasa como valor inicial de la disposición y la asignación final puede variar durante la optimización o el enrutamiento.
• En "prepare" este modo, Orbit materializa el circuito en estos índices de cables físicos y, a continuación, utiliza una preparación de tipo « level-0 » con layout_method="trivial". Los SWAP de enrutamiento explícito pueden seguir desplazando el estado cuántico durante la ejecución.
• En "validate" el modo, se dan prioridad a los cables del circuito suministrados, por lo que physical_layout se ignora y se muestra una advertencia.

Tipo: int

Valor predeterminado: 300

Número de semillas de transpilación estocástica y de intentos de Orbit en transpilation_mode="optimize".

• Obligatorio: No
• Valor predeterminado: 300
• Tipos de entrada válidos: número entero positivo

Tipo: bool or None

Valor predeterminado: None

Si Orbit aplica la mitigación de errores de medición «solo con muestreador» mediante M3.

• Obligatorio: No

• Valor predeterminado: None

• Tipos de entrada válidos: bool o None

• Cuando Truese aplica la mitigación de errores de medición a las tomas de sampler.

• Cuando False, no realiza el posprocesamiento de las tomas.

• NoneEn el modo Orbit, se activa la función MEM para los PUB del Sampler ejecutados, mientras que en los modos «raw» y «custom» se omite la función MEM, salvo que se haya configurado lo contrario.

• «Explicit» True requiere primitive="sampler", preview=False, y simulator=False.

• Se conservan los recuentos del muestreador sin procesar y los recuentos ajustados se adjuntan a los metadatos de Orbit.

• Si la mitigación falla durante el posprocesamiento, Orbit conserva el resultado sin procesar y registra el fallo de la mitigación en los metadatos.

Tipo: list[dict] or None

Valor predeterminado: None

Modos de ejecución y anulaciones de «per- PUB ».

• Obligatorio: No

• Valor predeterminado: None

• Tipos de entrada válidos: list[dict] o None

• Se transmite una entrada a todos los PUB; en caso contrario, se envía una entrada por cada PUB.

• {"mode": "raw"} utiliza una única pasada de transpilación y programación de Qiskit optimization_level=0 para circuitos estáticos o dinámicos, y omite la optimización de Orbit, Orbit DD, DD dinámico y MEM.

• {"mode": "orbit"} utiliza los valores predeterminados de Orbit.

• {"mode": "custom"} puede anular transpilation_mode, physical_layout, dd_qubits, dd_strategy, dynamic_dd_seq, y mem para ese « PUB ».

• El modo «Raw» siempre utiliza transpilation_mode="prepare" con physical_layout=None, omite Orbit DD e ignora las opciones de preparación globales.

• Orbit y los PUB personalizados heredan los valores globales transpilation_mode y physical_layout a menos que los sobrescriban según PUB.

• Utiliza PUB duplicados con pub_options para comparar los datos sin procesar, los valores predeterminados de Orbit y una estrategia DD personalizada en un mismo trabajo de Quantum Compute. Para una línea de base CPMG sencilla, utilízala dentro {"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1} del archivo « PUB » personalizado dd_strategy.

En el caso de los circuitos preparados por el usuario, utiliza transpilation_mode="validate" para los PUB compatibles con Orbit:

options = {
    "pub_options": [
        {"mode": "raw"},
        {"mode": "orbit", "transpilation_mode": "validate"},
        {
            "mode": "custom",
            "transpilation_mode": "validate",
            "dd_qubits": None,
            "dd_strategy": [[{"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1}]],
            "mem": False,
        },
    ]
}

Tipo: list[list[dict]]

Estrategias de DD ordenadas para aplicarlas a circuitos de tipo « PUB ».

• Obligatorio: No

• Valor predeterminado: [[{"dd_sequence": "auto", "pulse_density": 0.25, "dd_reps": 1}]]

• Tipos de entrada válidos: list[list[dict]]

• Opciones: Lista externa no vacía de listas de estrategias no vacías.

• La lista externa indexa los PUB o circuitos. Si solo se proporciona una estrategia, Orbit la difunde a todos los PUB.

• Cada lista interna se aplica ronda tras ronda al mismo circuito.

• Cada ronda requiere dd_sequence; pulse_density el valor por defecto es 0.25; dd_reps el valor por defecto es 1.

Tipo: str or dict or list or None

Valor predeterminado: XY8

Secuencia DD utilizada para la inserción DD de avance directo de circuito dinámico de Orbit.

• Obligatorio: No

• Valor predeterminado: "XY8"

• Tipos de entrada válidos: str, dict, grupo list de pulsos personalizado o None

• Opciones: Se utilizan las mismas formas de secuencia que dd_strategy[].dd_sequence, o None para desactivar la etapa de inserción dinámica por avance.

• Se aplica cuando Orbit detecta lógica condicional o flujo de control y utiliza la canalización DD de circuito dinámico.

• Primero se ejecuta la pasada normal dd_strategy y, a continuación, Orbit aplica esta secuencia a las regiones dinámicas de alimentación directa etiquetadas.

Tipo: list[int] or None

Valor predeterminado: None

Lista global de índices de qubits admitidos para su inserción en Orbit DD.

• Obligatorio: No

• Valor predeterminado: None

• Tipos de entrada válidos: list[int] o None

• Opciones: None o una lista de números enteros >= 0

• None solo se aplica a los qubits activos o tocados.

• Una lista puede incluir qubits que solo están inactivos y excluye los qubits que no figuran en ella.

• pub_options[i].dd_qubits Se puede anular este valor en orbit las entradas de o custom PUB.

• Solo se pueden proporcionar listas de permitidos explícitas para los PUB compatibles con Orbit cuya dirección resuelta transpilation_mode sea "validate", de modo que el autor de la llamada sea el propietario de los índices de los qubits físicos. Los PUB sin procesar omiten Orbit DD y no aceptan dd_qubits.

Tipo: bool

Valor predeterminado: False

Si Orbit guarda las propiedades de calibración del backend tras la ejecución de un trabajo de Quantum Compute.

• Obligatorio: No

• Valor predeterminado: False

• Tipos de entrada válidos: bool

• Opciones: True / False

• service.job(job_id).properties()Cuando está activada, Orbit consulta las propiedades del backend, las guarda en formato serializado en la ruta /dataindicada e incluye la ruta de almacenamiento en los metadatos de Orbit.

• Los errores se notifican como advertencias y no invalidan los resultados de las primitivas que, por lo demás, se han ejecutado correctamente.

Tipo: int

Valor predeterminado: 4096

Imágenes predeterminadas que se utilizan para los PUB de Sampler en los que no se especifican imágenes de forma explícita.

• Obligatorio: No

• Valor predeterminado: 4096

• Tipos de entrada válidos: int

• Opciones: Número entero > 0

• Se aplica únicamente a primitive="sampler".

Tipo: float

Valor predeterminado: 0.015625

Precisión predeterminada utilizada para los PUB del estimador que no especifican la precisión de forma explícita.

• Obligatorio: No

• Valor predeterminado: 0.015625

• Tipos de entrada válidos: float o int

• Opciones: Float > 0

• Se aplica únicamente a primitive="estimator".

Tipo: dict

IBM Quantum opciones primitivas que se transmiten a la primitiva subyacente SamplerV2 o EstimatorV2.

• Obligatorio: No

• Valor predeterminado: {"resilience_level": 0, "dynamical_decoupling": {"enable": false}}

• Tipos de entrada válidos: dict

• Se admiten diccionarios de opciones anidados, incluidas las opciones avanzadas y experimentales para la primitiva seleccionada.

• El desacoplamiento dinámico en tiempo de ejecución está desactivado por defecto, por lo que la inserción de DD de Orbit es la única pasada de DD, a menos que el usuario decida activarla.

Por ejemplo, los usuarios avanzados de Sampler pueden activar los campos de depuración de circuitos dinámicos:

options = {
    "runtime_options": {
        "experimental": {
            "execution": {
                "scheduler_timing": True,
                "stretch_values": True,
            }
        }
    }
}

• Advertencia: Por lo tanto, hay que modificar este valor con precaución, activando manualmente funciones específicas como el «twirling», sin dejar de excluir DD.

Tipo: int or None

Valor predeterminado: None

Límite flexible del tiempo máximo de ejecución del trabajo de computación cuántica.

• Obligatorio: No
• Valor predeterminado: None
• Tipos de entrada válidos: int o None

El valor se especifica en segundos.

• Opciones: None o un número entero > 0
• Cuando None, se utiliza el valor predeterminado de Runtime.

Tipo: bool

Valor predeterminado: False

Si Orbit ejecuta la carga de trabajo en un simulador Aer local en lugar de en una QPU real.

• Obligatorio: No
• Valor predeterminado: False
• Tipos de entrada válidos: bool

El simulador se ejecuta dentro del contenedor de funciones.

• Opciones: True / False
• Se ignora cuando preview es True.
• Se devuelve un objeto «normal» PrimitiveResult con los metadatos de Orbit adjuntos.

Tipo: str

Valor predeterminado: backend

Modelo de ruido utilizado cuando simulator es True.

• Obligatorio: No

• Valor predeterminado: "backend"

• Tipos de entrada válidos: str

• Opciones: "backend" / "ideal"

• "backend" utiliza AerSimulator.from_backend(backend) , siempre que sea posible.

• AerSimulator``"ideal" utiliza un archivo sin ruido.

Tipo: int or None

Valor predeterminado: None

Duración de una puerta o pulso DD.

• Obligatorio: No

• Valor predeterminado: None

• Tipos de entrada válidos: int o None

• Advertencia: Utiliza un valor explícito únicamente en pruebas controladas o cuando exista una razón específica y justificada relacionada con el backend.

• El valor utiliza las mismas unidades que el backend emplea para los retrasos, normalmente dt.

• Opciones: None o un número entero > 0

• Cuando None Orbit resuelve un valor que tiene en cuenta el backend a partir de backend.target utilizando la duración más larga calibrada de la puerta X o de la puerta sqrt(X).

Tipo: PrimitiveResult

Estándar, PrimitiveResult con metadatos de Orbit adjuntos.

• Cada uno de primitive="sampler" ellos PubResult.data contiene datos de resultados del muestreador, como matrices de bits de registro clásico.
• Cada PubResult.data uno primitive="estimator" de ellos contiene datos de los resultados de los estimadores, como los valores esperados y los errores estándar.
• En el modo de vista previa, cada uno PubResult.data está vacío porque no se ha enviado ninguna primitiva « IBM Quantum ».