{
"cells": [
{
"cell_type": "markdown",
"id": "7acdb263-fde4-4ff3-a13d-c499a2ba77e4",
"metadata": {},
"source": [
"---\n",
"title: \"Specificare le opzioni dell'esecutore\"\n",
"description: \"Specificare le opzioni durante la compilazione con la primitiva Executor.\"\n",
"---\n",
"\n",
"\n",
"\n",
"# Specificare le opzioni dell'esecutore\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "73e3d6f4",
"metadata": {
"tags": [
"version-info"
]
},
"source": [
"{/*\n",
" DO NOT EDIT THIS CELL!!!\n",
" This cell's content is generated automatically by a script. Anything you add\n",
" here will be removed next time the notebook is run. To add new content, create\n",
" a new cell before or after this one.\n",
" */}\n",
"\n",
"\n",
" \n",
" Il codice presente in questa pagina è stato sviluppato sulla base dei seguenti requisiti.\n",
" Si consiglia di utilizzare queste versioni o quelle più recenti.\n",
"\n",
" ```\n",
" qiskit-ibm-runtime~=0.46.1\n",
" ```\n",
" \n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "513837ac-8853-4f45-8d8f-1a8297d5ab68",
"metadata": {},
"source": [
"È 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.\n",
"\n",
"\n",
" * È possibile visualizzare le opzioni disponibili e aggiornare i valori delle opzioni durante o dopo l'inizializzazione delle primitive.\n",
" * Utilizza il `update()` metodo per applicare le modifiche all'attributo `options` .\n",
" * `options` L'attributo è di `dataclass` tipo Python. È possibile utilizzare il metodo integrato `asdict` per convertirlo in un dizionario.\n",
" * Executor può elaborare solo le informazioni codificate nei samplex. Per conoscere le restrizioni, consultare le [guide](https://qiskit.github.io/samplomatic/guides/index) di Samplomatic.\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"## Imposta le opzioni di Executor\n",
"\n",
"Se un'opzione viene specificata sia durante che dopo l'inizializzazione della primitiva, viene utilizzato il valore impostato dopo l'inizializzazione della primitiva.\n",
"\n",
"\n",
"\n",
"### Inizializzazione primitiva\n",
"\n",
"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.\n",
"\n",
"\n",
"\n",
"#### Corso sulle opzioni\n",
"\n",
"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`.\n",
"\n",
"Esempio:\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "948f4e75-3079-4c18-ba38-ce536b3f99b5",
"metadata": {},
"outputs": [],
"source": [
"from qiskit_ibm_runtime import QiskitRuntimeService, Executor\n",
"from qiskit_ibm_runtime.options import ExecutorOptions\n",
"\n",
"service = QiskitRuntimeService()\n",
"backend = service.least_busy(operational=True, simulator=False)\n",
"\n",
"options = ExecutorOptions(\n",
" environment={\"log_level\": \"INFO\"},\n",
" execution={\"init_qubits\": True},\n",
")\n",
"\n",
"# or use the following instead:\n",
"\n",
"options = ExecutorOptions()\n",
"options.environment.log_level = \"INFO\"\n",
"options.execution.init_qubits = True\n",
"\n",
"executor = Executor(mode=backend, options=options)"
]
},
{
"cell_type": "markdown",
"id": "ba2f5146-2781-49da-9fa2-8a22647225d0",
"metadata": {},
"source": [
"\n",
"\n",
"#### Dizionario\n",
"\n",
"È possibile specificare le opzioni sotto forma di dizionario al momento dell'inizializzazione di Executor.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "cf4359c2-c97a-475c-998d-518dc05a445e",
"metadata": {},
"outputs": [],
"source": [
"from qiskit_ibm_runtime import QiskitRuntimeService, Executor\n",
"\n",
"service = QiskitRuntimeService()\n",
"backend = service.least_busy(operational=True, simulator=False)\n",
"\n",
"# Setting options during primitive initialization\n",
"executor = Executor(\n",
" backend,\n",
" options={\n",
" \"environment\": {\"log_level\": \"INFO\"},\n",
" \"execution\": {\"init_qubits\": True},\n",
" },\n",
")"
]
},
{
"cell_type": "markdown",
"id": "b981eda7-bd9b-4d1e-959a-12cfc35fc2a1",
"metadata": {},
"source": [
"\n",
"\n",
"\n",
"\n",
"## Opzioni disponibili\n",
"\n",
"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](/docs/api/qiskit-ibm-runtime) e seleziona una versione precedente.\n",
"\n",
"\n",
" \n",
" [`environment` Documentazione API](/docs/api/qiskit-ibm-runtime/options-sampler-options#environment)\n",
"\n",
" \n",
" \n",
" Elenco dei tag.\n",
"\n",
" **Opzioni** : Nessuna\n",
"\n",
" **Impostazione predefinita** : Nessuna\n",
" \n",
"\n",
" \n",
" **Opzioni** : DEBUG, INFO, AVVISO, ERRORE, CRITICO\n",
"\n",
" **Impostazione predefinita** : AVVISO\n",
" \n",
"\n",
" \n",
" **Opzioni** : `True`, `False`\n",
"\n",
" **Impostazione predefinita** : `False`\n",
" \n",
"\n",
" \n",
" **Opzioni** : numero intero di secondi compreso tra \\[1 e 10800]\n",
"\n",
" **Impostazione predefinita** : 10800 (3 ore)\n",
" \n",
" \n",
" \n",
"\n",
" \n",
" [`execution` Documentazione API](/docs/api/qiskit-ibm-runtime/options-sampler-options#execution)\n",
"\n",
" \n",
" \n",
" Se riportare i qubit allo stato fondamentale ad ogni esecuzione.\n",
"\n",
" **Opzioni** : `True`, `False`\n",
"\n",
" **Impostazione predefinita** : `True`\n",
" \n",
"\n",
" \n",
" Il ritardo tra una misurazione e il successivo circuito quantistico.\n",
"\n",
" **Opzioni** : Valore compreso nell'intervallo fornito da `backend.rep_delay_range`\n",
"\n",
" **Impostazione predefinita** : specificata da `backend.default_rep_delay`\n",
" \n",
"\n",
" \n",
" **Opzioni** : `classified`, `kerneled`, `avg_kerneled`\n",
"\n",
" **Impostazione predefinita** : `classified`\n",
" \n",
" \n",
" \n",
"\n",
" \n",
" Opzioni sperimentali, se disponibili.\n",
" \n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "9b86001b-718a-4d72-b3b5-4a67eabf0a45",
"metadata": {},
"source": [
"\n",
"\n",
"## Passi successivi\n",
"\n",
"\n",
" * Consulta la documentazione dell'API di [ExecutionOptionsV2](/docs/api/qiskit-ibm-runtime/options-execution-options-v2).\n",
" * Consulta la documentazione dell'API di [EnvironmentOptions](/docs/api/qiskit-ibm-runtime/options-environment-options).\n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"id": "a1b8767d",
"source": "© IBM Corp., 2017-2026"
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3"
}
},
"nbformat": 4,
"nbformat_minor": 4
}