Riferimento all'API di Quantum Elements Orbit

Tipo: Iterable[SamplerPubLike] or Iterable[EstimatorPubLike]

Uno o più PUB corrispondenti alla primitiva selezionata.

• Obbligatorio: sì
• Tipi di input validi: iterabile di oggetti simili a Sampler PUB oppure iterabile di oggetti simili a Estimator PUB

Ogni " PUB " deve corrispondere al contratto di input della primitiva selezionata.

• primitive="sampler"Per: ogni PUB segue la forma del campionatore PUB, ad esempio (circuit, parameter_values, shots).
• Per primitive="estimator" : ogni PUB segue la forma Estimator PUB, come ad esempio (circuit, observables, parameter_values, precision).
• I circuiti non devono necessariamente essere circuiti ISA nel percorso predefinito options.transpilation_mode="optimize" ; Orbit li traspone e li pianifica internamente.

Tipo: str

Seleziona quale primitiva IBM Quantum Orbit utilizza per l'esecuzione.

• Obbligatorio: sì
• Tipi di input validi: str

La primitiva definisce quali elementi deve contenere ogni PUB e quali dati di risultato deve restituire ciascuna PubResult di esse.

• Opzioni: "sampler" / "estimator"
• Utilizzare "sampler" per i dati sotto forma di stringhe di bit campionate.
• Utilizzare "estimator" per i valori attesi e gli errori standard.

Tipo: str or None

Valore predefinito: None

Nome del backend di IBM Quantum su cui eseguire l'operazione.

• Obbligatorio: No

• Valore predefinito: None

• Tipi di input validi: str o None

• Se omesso o None, Orbit individua un backend operativo idoneo (non simulatore) tramite least_busy().

• Esempio: "ibm_boston"

Tipo: dict or None

Valore predefinito: None

Opzioni specifiche per ciascuna funzione che regolano il comportamento di esecuzione di Orbit.

• Obbligatorio: No
• Valore predefinito: None
• Tipi di input validi: dict o None

Le opzioni consentono di gestire la transpilazione, l'inserimento di DD, le opzioni di Quantum Compute, la modalità di anteprima, la modalità simulatore, l'esportazione delle informazioni sul backend e la mitigazione degli errori di misurazione.

• I tasti di opzione sconosciuti vengono ignorati.
• Inserire None, {}, oppure omettere options per utilizzare tutte le impostazioni predefinite.
• Esempio:

{
    "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

Valore predefinito: False

Se Orbit restituisce un report di inserimento DD senza inviare un’attività di calcolo quantistico.

• Obbligatorio: No

• Valore predefinito: False

• Tipi di input validi: bool

• TrueIn questo caso, non viene impiegato alcun tempo di elaborazione della QPU; Orbit si limita a pre-elaborare i circuiti in pubs e fornisce un rapporto di inserimento.

• Quando False (valore predefinito), viene inviato ed elaborato un lavoro di calcolo quantistico con circuiti modificati da Orbit.

• Se sia preview che simulator sono True, la modalità anteprima ha la precedenza e l'esecuzione del simulatore viene ignorata.

Tipo: bool

Valore predefinito: False

Se la modalità di anteprima include il circuito post-Orbit predisposto per ciascun PUB nei metadati.

• Obbligatorio: No

• Valore predefinito: False

• Tipi di input validi: bool

• Si usa solo quando preview=True.

• debugCircuit.circuitOgni report PUB include il numero di True, debugCircuit.usedQubits, e operazioni. Include inoltre la modalità "best-effort debugCircuit.qasm " quando Qiskit è in grado di esportare il circuito.

• Lasciare questa opzione disattivata durante le esecuzioni normali, poiché i carichi utili dei circuiti possono essere di grandi dimensioni.

Tipo: string

Valore predefinito: optimize

Come Orbit prepara i circuiti " PUB " prima dell'inserimento del DD.

• Obbligatorio: No

• Valore predefinito: "optimize"

• Valori di input validi: "optimize", "prepare", oppure "validate"

• "optimize" esegue ripetutamente la transpilazione con Qiskit optimization_level=2 e seleziona il candidato con la profondità a due qubit più bassa sia per i circuiti statici che per quelli dinamici.

• "prepare" gestisce la preparazione di Qiskit optimization_level=0 e la pianificazione di ALAP. Se physical_layout viene specificato, Orbit materializza innanzitutto il circuito su tali indici di cavi fisici e utilizza il metodo di layout "trivial" di Qiskit.

• "validate" considera il circuito di ingresso come già fisicamente predisposto. Orbit verifica la compatibilità del backend ove possibile, non esegue rimappature, reindirizzamenti, ottimizzazioni né riparazioni della pianificazione prima dell'inserimento del DD, e ignora physical_layout l'operazione emettendo un avviso.

Tipo: object or null

Valore predefinito: None

Mappatura opzionale da qubit logici a qubit fisici.

• Obbligatorio: No
• Valore predefinito: None
• Tipi di input validi: oggetto con chiavi e valori interi non negativi, oppure None

Esempio: {"0": 85, "1": 89} associa il qubit logico 0 al qubit fisico 85 e il qubit logico 1 al qubit fisico 89. Python Chi effettua la chiamata può utilizzare chiavi intere; le chiavi degli oggetti JSON sono stringhe.

• In "optimize" questa modalità, questo valore viene passato come seme iniziale del layout e la mappatura finale potrebbe subire variazioni durante l'ottimizzazione/il routing.
• In "prepare" questa modalità, Orbit materializza il circuito su questi indici di fili fisici, quindi utilizza una preparazion level-0 a con layout_method="trivial". Gli SWAP di instradamento esplicito possono comunque spostare lo stato quantistico durante l'esecuzione.
• In "validate" modalità, i cavi del circuito forniti sono quelli di riferimento, pertanto physical_layout viene ignorato con un avviso.

Tipo: int

Valore predefinito: 300

Numero di semi di transpilazione stocastica e di tentativi Orbit in transpilation_mode="optimize".

• Obbligatorio: No
• Valore predefinito: 300
• Tipi di input validi: numero intero positivo

Tipo: bool or None

Valore predefinito: None

Se Orbit applica la mitigazione degli errori di misurazione esclusivamente tramite Sampler utilizzando l' M3.

• Obbligatorio: No

• Valore predefinito: None

• Tipi di input validi: bool o None

• Quando Truesi applica la riduzione dell'errore di misurazione ai scatti provenienti da sampler.

• Quando False, non esegue la post-elaborazione delle immagini.

• NoneQuando è attiva la modalità Orbit, la funzione MEM viene abilitata per i PUB del Sampler in esecuzione, mentre le modalità raw e custom ignorano la funzione MEM, salvo diversa configurazione.

• Explicit True richiede primitive="sampler", preview=False, e simulator=False.

• I conteggi grezzi del campionatore vengono conservati, mentre i conteggi corretti vengono allegati ai metadati di Orbit.

• Se la mitigazione fallisce durante la post-elaborazione, Orbit conserva il risultato grezzo e registra il fallimento della mitigazione nei metadati.

Tipo: list[dict] or None

Valore predefinito: None

Modalità di esecuzione e impostazioni di override per " PUB ".

• Obbligatorio: No

• Valore predefinito: None

• Tipi di input validi: list[dict] o None

• Una voce viene trasmessa a tutti i PUB; in caso contrario, inviare una voce per ogni PUB.

• {"mode": "raw"} utilizza un unico ciclo di transpilazione e pianificazione di Qiskit optimization_level=0 per i circuiti statici o dinamici, tralasciando l'ottimizzazione Orbit, Orbit DD, DD dinamico e MEM.

• {"mode": "orbit"} utilizza le impostazioni predefinite di Orbit.

• {"mode": "custom"} può sovrascrivere transpilation_mode, physical_layout, dd_qubits, dd_strategy, dynamic_dd_seq, e mem per quell' PUB e.

• La modalità Raw utilizza transpilation_mode="prepare" sempre con physical_layout=None, salta Orbit DD e ignora le opzioni di preparazione globali.

• Orbit e i PUB personalizzati ereditano le impostazioni globali transpilation_mode e physical_layout a meno che non le sovrascrivano tramite PUB.

• Utilizza i PUB duplicati con pub_options per confrontare i dati grezzi, le impostazioni predefinite di Orbit e una strategia DD personalizzata in un unico lavoro di calcolo quantistico. Per un modello di riferimento CPMG semplice, utilizzare {"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1} all’interno del file. PUB personalizzato dd_strategy.

Per i circuiti predisposti dal chiamante, utilizzare transpilation_mode="validate" per i PUB compatibili 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]]

Strategie DD ordinate da applicare ai circuiti di tipo “ PUB ”.

• Obbligatorio: No

• Valore predefinito: [[{"dd_sequence": "auto", "pulse_density": 0.25, "dd_reps": 1}]]

• Tipi di input validi: list[list[dict]]

• Scelte: lista esterna non vuota di liste di strategie non vuote.

• L'elenco esterno indicizza i PUB o i circuiti. Se viene fornita una sola strategia, Orbit la trasmette a tutti i PUB.

• Ogni lista interna viene applicata, ciclo dopo ciclo, allo stesso circuito.

• Ogni round richiede dd_sequence; pulse_density il valore predefinito è 0.25; dd_reps il valore predefinito è 1.

Tipo: str or dict or list or None

Valore predefinito: XY8

Sequenza DD utilizzata per l'inserimento DD con feedforward a circuito dinamico di Orbit.

• Obbligatorio: No

• Valore predefinito: "XY8"

• listTipi di input validi: str, dict, gruppo di impulsi personalizzato, oppure None

• Opzioni: la stessa sequenza si presenta come dd_strategy[].dd_sequence, oppure None per disabilitare la fase di inserimento dinamico a feedforward.

• Si applica quando Orbit rileva una logica condizionale o un flusso di controllo e utilizza la pipeline DD a circuito dinamico.

• Viene eseguito prima il passaggio normale dd_strategy , poi Orbit applica questa sequenza alle regioni dinamiche di feedforward etichettate.

Tipo: list[int] or None

Valore predefinito: None

Elenco globale degli indici di qubit ammessi all'inserimento nell'Orbit DD.

• Obbligatorio: No

• Valore predefinito: None

• Tipi di input validi: list[int] o None

• Opzioni: None oppure un elenco di numeri interi >= 0

• None si applica solo ai qubit attivi/toccati.

• Un elenco può includere solo i qubit in stato di riposo ed esclude i qubit non presenti nell'elenco.

• pub_options[i].dd_qubits È possibile sovrascrivere questo valore all'interno orbit delle voci o custom PUB.

• È possibile fornire liste di autorizzazione esplicite solo per i PUB abilitati per Orbit il cui risolto transpilation_mode sia "validate", in modo che il chiamante possieda gli indici dei qubit fisici. I PUB Raw ignorano Orbit DD e non accettano dd_qubits.

Tipo: bool

Valore predefinito: False

Se Orbit salva le proprietà di calibrazione del backend dopo l'esecuzione di un processo di calcolo quantistico.

• Obbligatorio: No

• Valore predefinito: False

• Tipi di input validi: bool

• Opzioni: True / False

• service.job(job_id).properties()Quando è abilitata, Orbit esegue le query, scrive le proprietà del backend serializzate in /datae riporta il percorso di salvataggio nei metadati di Orbit.

• Gli errori vengono segnalati come avvisi e non invalidano i risultati delle primitive che sono andate a buon fine.

Tipo: int

Valore predefinito: 4096

Immagini predefinite utilizzate per i PUB di Sampler che non specificano esplicitamente le immagini.

• Obbligatorio: No

• Valore predefinito: 4096

• Tipi di input validi: int

• Opzioni: numero intero > 0

• Si applica solo a primitive="sampler".

Tipo: float

Valore predefinito: 0.015625

Precisione predefinita utilizzata per i PUB dell'Estimator che non specificano esplicitamente la precisione.

• Obbligatorio: No

• Valore predefinito: 0.015625

• Tipi di input validi: float o int

• Opzioni: Float > 0

• Si applica solo a primitive="estimator".

Tipo: dict

IBM Quantum opzioni primitive trasmesse alla primitiva sottostante SamplerV2 o EstimatorV2.

• Obbligatorio: No

• Valore predefinito: {"resilience_level": 0, "dynamical_decoupling": {"enable": false}}

• Tipi di input validi: dict

• Sono ammessi dizionari di opzioni annidati, comprese le opzioni avanzate e sperimentali relative alla primitiva selezionata.

• Il disaccoppiamento dinamico in fase di esecuzione è disabilitato per impostazione predefinita, pertanto l'inserimento DD di Orbit costituisce l'unico passaggio DD, a meno che l'utente non scelga di attivarlo.

Ad esempio, gli utenti esperti di Sampler possono abilitare i campi di debug dei circuiti dinamici:

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

• Attenzione: è quindi opportuno modificare questo valore con cautela, attivando manualmente alcune funzionalità specifiche, come il "twirling", pur continuando a escludere il DD.

Tipo: int or None

Valore predefinito: None

Limite flessibile al tempo massimo di esecuzione del processo Quantum Compute.

• Obbligatorio: No
• Valore predefinito: None
• Tipi di input validi: int o None

Il valore è specificato in secondi.

• Opzioni: None oppure un numero intero > 0
• NoneIn tal caso, viene utilizzato il valore predefinito di Runtime.

Tipo: bool

Valore predefinito: False

Se Orbit esegue il carico di lavoro su un simulatore Aer locale anziché su una QPU reale.

• Obbligatorio: No
• Valore predefinito: False
• Tipi di input validi: bool

Il simulatore viene eseguito all'interno del contenitore delle funzioni.

• Opzioni: True / False
• Viene ignorato quando preview è True.
• Viene restituito un valore normale PrimitiveResult con i metadati di Orbit allegati.

Tipo: str

Valore predefinito: backend

Modello di rumore utilizzato quando simulator è True.

• Obbligatorio: No

• Valore predefinito: "backend"

• Tipi di input validi: str

• Opzioni: "backend" / "ideal"

• "backend" utilizza AerSimulator.from_backend(backend) , quando possibile.

• AerSimulator``"ideal" utilizza un file semplice e privo di rumore.

Tipo: int or None

Valore predefinito: None

Durata di un gate o di un impulso DD.

• Obbligatorio: No

• Valore predefinito: None

• Tipi di input validi: int o None

• Avvertenza: utilizzare un valore esplicito solo per test controllati o quando si ha una motivazione specifica e ben definita relativa al backend.

• Il valore utilizza le stesse unità impiegate dal backend per i ritardi, in genere dt.

• Opzioni: None oppure un numero intero > 0

• NoneQuando Orbit risolve un valore "backend-aware" da backend.target utilizzando la durata più lunga calibrata del gate X o di sqrt(X).

Tipo: PrimitiveResult

Standard PrimitiveResult con metadati Orbit allegati.

• primitive="sampler"Infatti, ciascuno di essi PubResult.data contiene i dati dei risultati del campionatore, quali gli array di bit del registro classico.
• primitive="estimator"Infatti, ciascuno di essi PubResult.data contiene i dati relativi ai risultati degli stimatori, quali i valori attesi e gli errori standard.
• In modalità anteprima, ogni campo è PubResult.data vuoto poiché non è stata inviata alcuna primitiva IBM Quantum.