{ "cells": [ { "cell_type": "markdown", "id": "7acdb263-fde4-4ff3-a13d-c499a2ba77e4", "metadata": {}, "source": [ "---\n", "title: \"Especificar opções do Executor\"\n", "description: \"Especifique as opções ao compilar com a primitiva Executor.\"\n", "---\n", "\n", "\n", "\n", "# Especificar opções do Executor\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", " O código desta página foi desenvolvido com base nos seguintes requisitos.\n", " Recomendamos o uso dessas versões ou versões mais recentes.\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": [ "Você pode usar opções para personalizar a primitiva Executor. Ao contrário do Sampler e do Estimator, o Executor possui pouquíssimas opções, já que a maior parte das intenções de projeto está codificada no samplex.\n", "\n", "\n", " * Você pode ver as opções disponíveis e atualizar os valores das opções durante ou após a inicialização da primitiva.\n", " * Use o `update()` método para aplicar alterações ao `options` atributo.\n", " * O `options` atributo é do `dataclass` tipo Python. Você pode usar o método integrado `asdict` para convertê-lo em um dicionário.\n", " * O Executor só pode processar informações codificadas em samplexes. Consulte os [guias](https://qiskit.github.io/samplomatic/guides/index) do Samplomatic para entender as restrições.\n", "\n", "\n", "\n", "\n", "\n", "\n", "## Definir opções do Executor\n", "\n", "Se uma opção for especificada tanto durante quanto após a inicialização da primitiva, será utilizado o valor definido após a inicialização da primitiva.\n", "\n", "\n", "\n", "### Inicialização primitiva\n", "\n", "É possível passar uma instância da classe de opções ou um dicionário ao inicializar o Executor, que então cria uma cópia dessas opções. Portanto, alterar o dicionário original ou a instância de opções não afeta as opções associadas à primitiva.\n", "\n", "\n", "\n", "#### Classe de opções\n", "\n", "Ao criar uma instância da `Executor` classe, você pode passar uma instância da classe de opções. Essas opções são aplicadas quando você usa `run()` para realizar o cálculo. Especifique as opções neste formato: `options.option.sub-option.sub-sub-option = choice`. Por exemplo: `options.environment.log_level = INFO`.\n", "\n", "Exemplo:\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", "#### Dicionário\n", "\n", "É possível especificar opções na forma de um dicionário ao inicializar o 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", "## Opções disponíveis\n", "\n", "A tabela a seguir apresenta as opções da versão mais recente do `qiskit-ibm-runtime`. Para ver versões anteriores das opções, acesse a [`qiskit-ibm-runtime` referência da API](/docs/api/qiskit-ibm-runtime) e selecione uma versão anterior.\n", "\n", "\n", " \n", " [`environment` Documentação da API](/docs/api/qiskit-ibm-runtime/options-sampler-options#environment)\n", "\n", " \n", " \n", " Lista de tags.\n", "\n", " **Opções** : Nenhuma\n", "\n", " **Padrão** : Nenhum\n", " \n", "\n", " \n", " **Opções** : DEBUG, INFO, WARNING, ERROR, CRITICAL\n", "\n", " **Padrão** : AVISO\n", " \n", "\n", " \n", " **Opções** : `True`, `False`\n", "\n", " **Padrão** : `False`\n", " \n", "\n", " \n", " **Opções** : Número inteiro de segundos no intervalo \\[de] 1 a 10.800\n", "\n", " **Padrão** : 10800 (3 horas)\n", " \n", " \n", " \n", "\n", " \n", " [`execution` Documentação da API](/docs/api/qiskit-ibm-runtime/options-sampler-options#execution)\n", "\n", " \n", " \n", " Se os qubits devem ser reinicializados para o estado fundamental a cada disparo.\n", "\n", " **Opções** : `True`, `False`\n", "\n", " **Padrão** : `True`\n", " \n", "\n", " \n", " O intervalo entre uma medição e o circuito quântico subsequente.\n", "\n", " **Opções** : Valor na faixa fornecida por `backend.rep_delay_range`\n", "\n", " **Padrão** : Definido por `backend.default_rep_delay`\n", " \n", "\n", " \n", " **Opções** : `classified`, `kerneled`, `avg_kerneled`\n", "\n", " **Padrão** : `classified`\n", " \n", " \n", " \n", "\n", " \n", " Opções experimentais, quando disponíveis.\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "9b86001b-718a-4d72-b3b5-4a67eabf0a45", "metadata": {}, "source": [ "\n", "\n", "## Próximas etapas\n", "\n", "\n", " * Consulte a documentação da API do [ExecutionOptionsV2](/docs/api/qiskit-ibm-runtime/options-execution-options-v2).\n", " * Consulte a documentação da API do [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 }