Skip to main content
IBM Quantum Platform

IfElseOp

class qiskit.circuit.IfElseOp(condition, true_body, false_body=None, label=None)

GitHub

Bases: ControlFlowOp

Uma operação de circuito que executa um programa (true_body) se uma condição fornecida (condition) for avaliada como verdadeira e, opcionalmente, avalia outro programa (false_body) caso contrário.

Se fornecido, false_body deve ser dos mesmos num_qubits e num_clbits que true_body.

Os bits clássicos usados em condition devem ser um subconjunto daqueles conectados ao circuito no qual esse IfElseOp será anexado.

Parâmetros

  • condition (tuple[ClassicalRegister, int] | tuple[Clbit, int] | expr.Expr) – Uma condição a ser avaliada em tempo real durante a execução do circuito que, se verdadeira, acionará a avaliação de true_body. Pode ser especificado como uma tupla de ClassicalRegister a ser testada quanto à igualdade com um determinado int, ou como uma tupla de Clbit a ser comparada com um bool ou um int.
  • true_body (QuantumCircuit) – Um programa a ser executado se condition for avaliado como verdadeiro.
  • false_body (QuantumCircuit | None) – Um programa opcional a ser executado se condition o resultado for falso.
  • label (str | None) – Um rótulo opcional para identificar a instrução.

Atributos

base_class

Obtém a classe base dessa instrução. É garantido que isso esteja na árvore de herança de self.

A "classe base" de uma instrução é a classe mais baixa em sua árvore de herança com a qual o objeto deve ser considerado totalmente compatível para aplicativos de circuito. Isso normalmente significa que a subclasse é definida apenas para oferecer algum tipo de conveniência ao programador em relação à classe base, e a classe base é a classe "verdadeira" em uma perspectiva comportamental. Em particular, você não deve substituir base_class se estiver definindo uma versão personalizada de uma instrução que será implementada de forma diferente pelo hardware, como uma estratégia de medição alternativa ou uma versão de uma porta parametrizada com um conjunto específico de parâmetros para fins de distinção em um Target da porta parametrizada completa.

Isso geralmente é exatamente equivalente a type(obj), exceto no caso de instâncias únicas de instruções de biblioteca padrão. Essas instâncias singleton são subclasses especiais de sua classe base, e essa propriedade retornará essa base. Por exemplo:

>>> isinstance(XGate(), XGate)
True
>>> type(XGate()) is XGate
False
>>> XGate().base_class is XGate
True

Em geral, você não deve confiar na classe exata de uma instrução; em um determinado circuito, espera-se que Instruction.name seja um discriminador mais adequado na maioria das situações.

blocks

condition

A condição para a operação if else.

decompositions

Obtenha as decomposições da instrução no site SessionEquivalenceLibrary.

definition

Definição de retorno em termos de outros portões básicos.

label

Etiqueta de instruções de devolução

mutable

Essa instância é uma instância única mutável ou não.

Se esse atributo for False , a instância do portão será um singleton compartilhado e não será mutável.

name

Retorna o nome.

num_clbits

Retorna o número de clbits.

num_qubits

Retorna o número de qubits.

params


Métodos

add_decomposition

add_decomposition(decomposition)

GitHub

Adicione uma decomposição da instrução ao site SessionEquivalenceLibrary.

broadcast_arguments

broadcast_arguments(qargs, cargs)

GitHub

Validação dos argumentos.

Parâmetros

  • qargs (List) – Lista de argumentos de bits quânticos.
  • cargs (List) – Lista de argumentos clássicos de bits.

Lucros

Tuple(List, List) - Uma tupla com argumentos únicos.

Aumentos

CircuitError - Se a entrada não for válida. Por exemplo, o número de argumentos não corresponde à expectativa da porta.

copy

copy(name=None)

GitHub

Cópia da instrução.

Parâmetros

name (str) – nome a ser dado ao circuito copiado; se for None , o nome permanecerá o mesmo.

Retorna

uma cópia da instrução atual, com o nome atualizado, caso tenha sido fornecido

Tipo de retorno

qiskit.circuit.Instruction

inverse

inverse(annotated=False)

GitHub

Inverta essa instrução.

Se annotated for False, a instrução inversa será implementada como uma nova instrução com a definição recursivamente invertida.

Se annotated for True, a instrução inversa será implementada como AnnotatedOperatione corresponde à instrução dada anotada com o "modificador inverso".

As instruções especiais herdadas de Instruction podem implementar seu próprio inverso (por exemplo, T e Tdg, Barrier, etc.) Em particular, eles podem escolher como lidar com o argumento annotated , o que pode incluir ignorá-lo e sempre retornar uma classe de porta concreta se o inverso for definido como uma porta padrão.

Parâmetros

annotated (bool) – se definido como True, a porta inversa de saída será retornada como AnnotatedOperation.

Retorna

A operação inversa.

Aumentos

CircuitError - se a instrução não for composta e não tiver sido implementado um inverso para ela.

is_parameterized

is_parameterized()

GitHub

Retorna se o Instruction contém parâmetros de tempo de compilação.

iter_captured_stretches

iter_captured_stretches()

GitHub

Obtém um iterador sobre as variáveis de extensão capturadas exclusivas em todos os blocos dessa construção.

Tipo de retorno

Iterável [ expr.Stretch ]

iter_captured_vars

iter_captured_vars()

GitHub

Obtém um iterador sobre as variáveis capturadas exclusivas em todos os blocos dessa construção.

Tipo de retorno

Iterável [ expr.Var ]

repeat

repeat(n)

GitHub

Cria uma instrução com nnself repetido vezes.

Parâmetros

n (int) – Número de vezes para repetir a instrução

Retorna

Contendo a definição.

Tipo de retorno

qiskit.circuit.Instruction

Aumentos

CircuitError - Se n < 1.

replace_blocks

replace_blocks(blocks)

GitHub

Substitua os blocos e retorne a nova instrução.

Parâmetros

blocks (Iterable[QuantumCircuit]) – Iterável de circuitos para as condições "if" e "else". Se não houver um circuito "else", ele poderá ser definido como None ou omitido.

Retorna

Novo IfElseOp com blocos substituídos.

Tipo de retorno

IfElseOp

reverse_ops

reverse_ops()

GitHub

Em uma instrução composta, inverta a ordem das subinstruções.

Isso é feito por meio da inversão recursiva de todas as subinstruções. Ele não inverte nenhuma porta.

Retorna

uma nova instrução com

subinstruções invertidas.

Tipo de retorno

qiskit.circuit.Instruction

soft_compare

soft_compare(other)

GitHub

Comparação suave entre portões. Seus nomes, número de qubits e números de bits clássicos devem corresponder. O número de parâmetros deve corresponder. Cada parâmetro é comparado. Se a pessoa for um ParameterExpression, isso não será levado em consideração.

Parâmetros

other (instruction) – outras instruções.

Retorna

são iguais a si mesmo e ao outro até as expressões de parâmetro.

Tipo de retorno

bool

to_mutable

to_mutable()

GitHub

Retorna uma cópia mutável desse portão.

Esse método retornará uma nova cópia mutável dessa instância de porta. Se uma instância singleton estiver sendo usada, essa será uma nova instância exclusiva que poderá ser alterada. Se a instância já for mutável, ela será uma cópia profunda dessa instância.

validate_parameter

validate_parameter(parameter)

GitHub

O parâmetro de instrução não tem validação ou normalização.

Esta página foi útil?
Relate um bug, erro de digitação ou solicite conteúdo no GitHub.