Specificare le opzioni dell'esecutore

Il codice presente in questa pagina è stato sviluppato sulla base dei seguenti requisiti. Si consiglia di utilizzare queste versioni o quelle più recenti.
```
qiskit-ibm-runtime~=0.46.1
```

È possibile utilizzare le opzioni per personalizzare la primitiva Executor. A differenza di Sampler ed Estimator, Executor dispone di pochissime opzioni, poiché la maggior parte delle intenzioni di progettazione è codificata nel samplex.

Note

È possibile visualizzare le opzioni disponibili e aggiornare i valori delle opzioni durante o dopo l'inizializzazione delle primitive.
Utilizza il update() metodo per applicare le modifiche all'attributo options .
options L'attributo è di dataclass tipo Python. È possibile utilizzare il metodo integrato asdict per convertirlo in un dizionario.
Executor può elaborare solo le informazioni codificate nei samplex. Per conoscere le restrizioni, consultare le guide di Samplomatic.

Imposta le opzioni di Executor

Se un'opzione viene specificata sia durante che dopo l'inizializzazione della primitiva, viene utilizzato il valore impostato dopo l'inizializzazione della primitiva.

Inizializzazione primitiva

Durante l'inizializzazione di Executor è possibile passare un'istanza della classe delle opzioni o un dizionario; Executor provvederà quindi a crearne una copia. Pertanto, la modifica del dizionario originale o dell'istanza delle opzioni non influisce sulle opzioni associate alla primitiva.

Corso sulle opzioni

Quando si crea un'istanza della Executor classe, è possibile passare un'istanza della classe delle opzioni. Queste opzioni vengono quindi applicate quando si utilizza run() per eseguire il calcolo. Specificare le opzioni nel seguente formato: options.option.sub-option.sub-sub-option = choice. Ad esempio: options.environment.log_level = INFO.

Esempio:

from qiskit_ibm_runtime import QiskitRuntimeService, Executor
from qiskit_ibm_runtime.options import ExecutorOptions

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

options = ExecutorOptions(
    environment={"log_level": "INFO"},
    execution={"init_qubits": True},
)

# or use the following instead:

options = ExecutorOptions()
options.environment.log_level = "INFO"
options.execution.init_qubits = True

executor = Executor(mode=backend, options=options)

Dizionario

È possibile specificare le opzioni sotto forma di dizionario al momento dell'inizializzazione di Executor.

from qiskit_ibm_runtime import QiskitRuntimeService, Executor

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

# Setting options during primitive initialization
executor = Executor(
    backend,
    options={
        "environment": {"log_level": "INFO"},
        "execution": {"init_qubits": True},
    },
)

Opzioni disponibili

La tabella seguente illustra le opzioni disponibili nell'ultima versione di qiskit-ibm-runtime. Per visualizzare le versioni precedenti delle opzioni, visita la qiskit-ibm-runtime documentazione dell'API e seleziona una versione precedente.

environment Documentazione API
- Elenco dei tag.
  Opzioni : Nessuna
  Impostazione predefinita : Nessuna
- Opzioni : DEBUG, INFO, AVVISO, ERRORE, CRITICO
  Impostazione predefinita : AVVISO
- Opzioni : True, False
  Impostazione predefinita : False
- Opzioni : numero intero di secondi compreso tra [1 e 10800]
  Impostazione predefinita : 10800 (3 ore)
execution Documentazione API
- Se riportare i qubit allo stato fondamentale ad ogni esecuzione.
  Opzioni : True, False
  Impostazione predefinita : True
- Il ritardo tra una misurazione e il successivo circuito quantistico.
  Opzioni : Valore compreso nell'intervallo fornito da backend.rep_delay_range
  Impostazione predefinita : specificata da backend.default_rep_delay
- Opzioni : classified, kerneled, avg_kerneled
  Impostazione predefinita : classified
Opzioni sperimentali, se disponibili.

Passi successivi

Suggerimenti

Consulta la documentazione dell'API di ExecutionOptionsV2.
Consulta la documentazione dell'API di EnvironmentOptions.

Questa pagina è stata utile?

Segnala un bug, un errore di battitura o richiedi contenuti su GitHub.