Referência da API do Quantum Elements Orbit

Tipo: Iterable[SamplerPubLike] or Iterable[EstimatorPubLike]

Um ou mais PUBs que correspondem à primitiva selecionada.

• Necessário: sim
• Tipos de entrada válidos: iterável de objetos do tipo Sampler PUB ou iterável de objetos do tipo Estimator PUB

Cada PUB deve corresponder ao contrato de entrada da primitiva selecionada.

• Para primitive="sampler" Cada PUB segue o formato PUB Sampler, como por exemplo: (circuit, parameter_values, shots).
• Para primitive="estimator" Cada PUB segue o formato do Estimator PUB, como por exemplo: (circuit, observables, parameter_values, precision).
• Os circuitos não precisam ser circuitos ISA no caminho padrão options.transpilation_mode="optimize" ; o Orbit os transpila e os agenda internamente.

Tipo: str

Seleciona qual primitiva Qiskit Runtime o Orbit utiliza para execução.

• Necessário: sim
• Tipos de entrada válidos: str

A primitiva determina o que cada PUB de deve conter e quais dados de resultado cada uma PubResult retorna.

• Opções: "sampler" / "estimator"
• Use "sampler" para dados em forma de cadeia de bits amostrados.
• Use "estimator" para valores esperados e erros-padrão.

Tipo: str or None

Valor Padrão: None

Nome do backend do IBM Quantum no qual será executado.

• Obrigatório: Não

• Valor padrão: None

• Tipos de entrada válidos: str ou None

• Quando omitido ou None, o Orbit determina um backend operacional elegível que não seja um simulador com least_busy().

• Exemplo:"ibm_boston"

Tipo: dict or None

Valor Padrão: None

Opções específicas de função que controlam o comportamento de execução do Orbit.

• Obrigatório: Não
• Valor padrão: None
• Tipos de entrada válidos: dict ou None

As opções controlam a transpilagem, a inserção de DD, as opções de “ Qiskit Runtime ”, o modo de visualização, o modo simulador, a exportação de informações do backend e a mitigação de erros de medição.

• Chaves de opção desconhecidas são rejeitadas.
• Insira None, {}, ou não insira nada options para usar todos os valores padrão.
• Exemplo:

{
    "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 Padrão: False

Se o Orbit retorna um relatório de inserção de DD sem enviar um trabalho de “ Qiskit Runtime ”.

• Obrigatório: Não

• Valor padrão: False

• Tipos de entrada válidos: bool

• TrueNesse caso, não é utilizado tempo da QPU; o orbit simplesmente faz o pré-processamento dos circuitos em pubs e fornece um relatório de inserção.

• Quando False (valor padrão), uma tarefa do tipo “ Qiskit Runtime ” com circuitos modificados pelo Orbit é enviada e processada.

• Se tanto preview quanto simulator forem True, o modo de visualização tem prioridade e a execução do simulador é ignorada.

Tipo: bool

Valor Padrão: False

Se o modo de visualização inclui o circuito pós-Orbit preparado para cada PUB nos metadados.

• Obrigatório: Não

• Valor padrão: False

• Tipos de entrada válidos: bool

• Usado apenas quando preview=True.

• TrueQuando isso ocorre, cada relatório do PUB inclui debugCircuit.circuit, debugCircuit.usedQubits, e as contagens de operações. Isso também inclui o princípio do “melhor esforço” debugCircuit.qasm quando o Qiskit consegue exportar o circuito.

• Deixe essa opção desativada para execuções normais, pois as cargas úteis do circuito podem ser grandes.

Tipo: string

Valor Padrão: optimize

Como a Orbit prepara os circuitos d PUB e antes da inserção do DD.

• Obrigatório: Não

• Valor padrão: "optimize"

• Valores válidos para a entrada: "optimize", "prepare", ou "validate"

• "optimize" executa repetidamente a transpilação do Qiskit optimization_level=2 e mantém o candidato com a menor profundidade de dois qubits para circuitos estáticos e dinâmicos.

• "prepare" executa a preparação do Qiskit optimization_level=0 e o agendamento do ALAP. Se physical_layout for fornecido, o Orbit primeiro materializa o circuito nesses índices de fios físicos e utiliza o método de layout trivial do Qiskit.

• "validate" considera que o circuito de entrada já está fisicamente preparado. O Orbit verifica a compatibilidade do backend sempre que possível, não realiza remapeamento, roteamento, otimização nem correção de programação antes da inserção do DD e ignora physical_layout a operação, exibindo um aviso.

Tipo: object or null

Valor Padrão: None

Mapeamento opcional de qubits lógicos para físicos.

• Obrigatório: Não
• Valor padrão: None
• Tipos de entrada válidos: objeto com chaves e valores inteiros não negativos, ou None

Exemplo: {"0": 85, "1": 89} mapeia o qubit lógico 0 para o qubit físico 85 e o qubit lógico 1 para o qubit físico 89. Python Os chamadores podem usar chaves inteiras; as chaves dos objetos JSON são cadeias de caracteres.

• No "optimize" modo, isso é passado como uma semente inicial do layout, e o mapeamento final pode sofrer alterações durante a otimização/roteamento.
• No "prepare" modo, o Orbit materializa o circuito nesses índices de fios físicos e, em seguida, utiliza uma preparaçã level-0 a com layout_method="trivial". Os SWAPs de roteamento explícito ainda podem alterar o estado quântico durante a execução.
• No "validate" modo, os fios do circuito fornecidos são os que prevalecem; portanto, physical_layout é ignorado e gera um aviso.

Tipo: int

Valor Padrão: 300

Número de tentativas de Orbit com sementes de transpilação estocástica em transpilation_mode="optimize".

• Obrigatório: Não
• Valor padrão: 300
• Tipos de entrada válidos: inteiro positivo

Tipo: bool or None

Valor Padrão: None

Se o Orbit aplica a mitigação de erros de medição exclusivamente por meio do Sampler, utilizando o recurso “ M3 ”.

• Obrigatório: Não

• Valor padrão: None

• Tipos de entrada válidos: bool ou None

• Quando True, aplica a mitigação de erros de medição às imagens provenientes de sampler.

• Quando False, não realiza o pós-processamento das imagens.

• NoneQuando o modo Orbit está ativado, o MEM é habilitado para os PUBs do Sampler executados; já os modos raw e custom ignoram o MEM, a menos que estejam configurados para o contrário.

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

• As contagens brutas do Sampler são preservadas, e as contagens mitigadas são anexadas aos metadados do Orbit.

• Caso a mitigação falhe durante o pós-processamento, o Orbit preserva o resultado bruto e registra a falha na mitigação nos metadados.

Tipo: list[dict] or None

Valor Padrão: None

Modos de execução e substituições do per- PUB .

• Obrigatório: Não

• Valor padrão: None

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

• Uma entrada é transmitida para todos os PUBs; caso contrário, passe uma entrada por PUB.

• {"mode": "raw"} utiliza uma única etapa de transpilação e agendamento do Qiskit optimization_level=0 para circuitos estáticos ou dinâmicos e ignora a otimização do Orbit, o Orbit DD, o DD dinâmico e o MEM.

• {"mode": "orbit"} usa as configurações padrão do Orbit.

• {"mode": "custom"} pode substituir transpilation_mode, physical_layout, dd_qubits, dd_strategy dynamic_dd_seq,, e mem para esse PUB o.

• O modo Raw sempre usa transpilation_mode="prepare" com physical_layout=None, ignora o Orbit DD e desconsidera as opções globais de preparação.

• O Orbit e os PUBs personalizados herdam as variáveis globais transpilation_mode e physical_layout , a menos que as substituam conforme PUB.

• Use PUBs duplicados com pub_options para comparar os dados brutos, as configurações padrão do Orbit e uma estratégia DD personalizada em um único trabalho do Qiskit Runtime. Para uma linha de base CPMG simples, use {"dd_sequence": "CPMG", "pulse_density": 1.00, "dd_reps": 1} dentro do arquivo dd_strategy. PUB personalizado.

Para circuitos preparados pelo chamador, use transpilation_mode="validate" para os PUBs habilitados para 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]]

Estratégias de DD ordenadas a serem aplicadas aos circuitos d PUB.

• Obrigatório: Não

• Valor padrão: [[{"dd_sequence": "auto", "pulse_density": 0.25, "dd_reps": 1}]]

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

• Opções: Lista externa não vazia de listas de estratégias não vazias.

• A lista externa indexa PUBs ou circuitos. Se for fornecida apenas uma estratégia, o Orbit a transmite para todos os PUBs.

• Cada lista interna é aplicada, rodada por rodada, ao mesmo circuito.

• Cada rodada requer dd_sequence; pulse_density o valor padrão é 0.25; dd_reps o valor padrão é 1.

Tipo: str or dict or list or None

Valor Padrão: XY8

Sequência DD utilizada para a inserção DD de alimentação direta de circuito dinâmico do Orbit.

• Obrigatório: Não

• Valor padrão: "XY8"

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

• Opções: As mesmas formas de sequência que dd_strategy[].dd_sequence, ou None para desativar o estágio de inserção dinâmica de alimentação direta.

• Aplica-se quando o Orbit detecta lógica condicional ou fluxo de controle e utiliza o pipeline DD de circuito dinâmico.

• Primeiro é executada a passagem normal dd_strategy ; em seguida, o Orbit aplica essa sequência às regiões dinâmicas de feedforward identificadas.

Tipo: list[int] or None

Valor Padrão: None

Lista global de permissões padrão de índices de qubits elegíveis para inserção no Orbit DD.

• Obrigatório: Não

• Valor padrão: None

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

• Opções: None ou uma lista de números inteiros >= 0

• None visa apenas qubits ativos/tocados.

• Uma lista pode incluir apenas qubits inativos e exclui os qubits que não constam nela.

• pub_options[i].dd_qubits É possível substituir esse valor nas orbit entradas ou custom PUB.

• Listas de permissão explícitas só podem ser fornecidas para PUBs habilitados para Orbit cujo endereço resolvido transpilation_mode seja "validate", de modo que o chamador seja o proprietário dos índices dos qubits físicos. Os PUBs Raw ignoram o Orbit DD e não aceitam dd_qubits.

Tipo: bool

Valor Padrão: False

Se o Orbit salva as propriedades de calibração do backend após a execução de uma tarefa do tipo “ Qiskit Runtime ”.

• Obrigatório: Não

• Valor padrão: False

• Tipos de entrada válidos: bool

• Opções: True / False

• service.job(job_id).properties()Quando ativado, o Orbit consulta, grava as propriedades serializadas do backend em /datae informa o caminho salvo nos metadados do Orbit.

• As falhas são relatadas como avisos e não invalidam os resultados das primitivas que foram bem-sucedidos.

Tipo: int

Valor Padrão: 4096

Imagens padrão utilizadas para PUBs do Sampler que não especificam imagens explicitamente.

• Obrigatório: Não

• Valor padrão: 4096

• Tipos de entrada válidos: int

• Opções: Número inteiro > 0

• Aplica-se apenas a primitive="sampler".

Tipo: float

Valor Padrão: 0.015625

Precisão padrão utilizada para PUBs do Estimador que não especificam a precisão explicitamente.

• Obrigatório: Não

• Valor padrão: 0.015625

• Tipos de entrada válidos: float ou int

• Opções: Float > 0

• Aplica-se apenas a primitive="estimator".

Tipo: dict

Qiskit Runtime opções primitivas passadas para a primitiva subjacente SamplerV2 ou EstimatorV2.

• Obrigatório: Não

• Valor padrão: {"resilience_level": 0, "dynamical_decoupling": {"enable": false}}

• Tipos de entrada válidos: dict

• São aceitos dicionários de opções aninhados, incluindo opções avançadas e experimentais do Qiskit Runtime para a primitiva selecionada.

• O desacoplamento dinâmico em tempo de execução está desativado por padrão; portanto, a inserção de DD do Orbit é a única etapa de DD, a menos que o usuário opte por ativá-la.

Por exemplo, usuários avançados do Sampler podem ativar campos de depuração de circuitos dinâmicos:

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

• Aviso: Portanto, deve-se alterar esse valor com cuidado, ativando manualmente abordagens específicas, como o “twirling”, sem deixar de excluir o DD.

Tipo: int or None

Valor Padrão: None

Limite flexível para o tempo máximo de execução da tarefa Qiskit Runtime.

• Obrigatório: Não
• Valor padrão: None
• Tipos de entrada válidos: int ou None

O valor é especificado em segundos.

• Opções: None ou um número inteiro > 0
• Quando None, é utilizado o padrão do Runtime.

Tipo: bool

Valor Padrão: False

Se o Orbit executa a carga de trabalho em um simulador Aer local, em vez de em uma QPU real.

• Obrigatório: Não
• Valor padrão: False
• Tipos de entrada válidos: bool

O simulador é executado dentro do contêiner de funções.

• Opções: True / False
• É ignorado quando preview é True.
• É retornado um objeto normal PrimitiveResult com os metadados do Orbit anexados.

Tipo: str

Valor Padrão: backend

Modelo de ruído utilizado quando simulator é True.

• Obrigatório: Não

• Valor padrão: "backend"

• Tipos de entrada válidos: str

• Opções: "backend" / "ideal"

• "backend" utiliza AerSimulator.from_backend(backend) , sempre que possível.

• AerSimulator``"ideal" usa um arquivo simples e sem ruído.

Tipo: int or None

Valor Padrão: None

Duração de um gate ou pulso DD.

• Obrigatório: Não

• Valor padrão: None

• Tipos de entrada válidos: int ou None

• Aviso: Utilize um valor explícito apenas para testes controlados ou quando houver um motivo específico e comprovado relacionado ao backend.

• O valor utiliza as mesmas unidades que o backend usa para atrasos, normalmente dt.

• Opções: None ou um número inteiro > 0

• Quando Noneo Orbit determina um valor compatível com o backend a partir de backend.target utilizando a duração mais longa calibrada do gate X ou sqrt(X).

Tipo: PrimitiveResult

Resultado padrão de uma primitiva do Qiskit com metadados do Orbit anexados.

• primitive="sampler"Para cada PubResult.data , há dados de resultados do Sampler, como matrizes de bits de registro clássico.
• primitive="estimator"Para cada PubResult.data , há dados de resultados do estimador, como valores esperados e erros-padrão.
• No modo de visualização, cada um PubResult.data está vazio porque nenhuma primitiva Qiskit Runtime foi enviada.