TwoQubitAnsatzBlock
class TwoQubitAnsatzBlock(params)
Bases: AnsatzBlock
Bloco ansatz de dois qubits.
Inicializar o bloco ansatz.
Parâmetros
params (Sequence[Parameter]) – Sequência de parâmetros.
Atributos
ansatz_num_qubits
Valor Padrão: 2
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 distingui-la 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
TrueEm geral, não se deve confiar na classe precisa de uma instrução; em um determinado circuito, espera-se que Instruction.name seja um discriminador mais adequado na maioria das situações.
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
Os parâmetros do site Instruction. O ideal é que sejam ângulos de portão.
Métodos
add_decomposition
add_decomposition(decomposition)
Adicione uma decomposição da instrução ao site SessionEquivalenceLibrary.
broadcast_arguments
broadcast_arguments(qargs, cargs)
Validação e manipulação dos argumentos e seu relacionamento.
Por exemplo, cx([q[0],q[1]], q[2]) significa cx(q[0], q[2]); cx(q[1], q[2]). Esse método produz os argumentos no agrupamento correto. No exemplo dado:
in: [[q[0],q[1]], q[2]],[]
outs: [q[0], q[2]], []
[q[1], q[2]], []As regras gerais de transmissão são:
Se len(qargs) == 1:
[q[0], q[1]] -> [q[0]],[q[1]]Se len(qargs) == 2:
[[q[0], q[1]], [r[0], r[1]]] -> [q[0], r[0]], [q[1], r[1]] [[q[0]], [r[0], r[1]]] -> [q[0], r[0]], [q[0], r[1]] [[q[0], q[1]], [r[0]]] -> [q[0], r[0]], [q[1], r[0]]Se len(qargs) >= 3:
[q[0], q[1]], [r[0], r[1]], ...] -> [q[0], r[0], ...], [q[1], r[1], ...]
Parâmetros
- qargs (
list) – Lista de argumentos de bits quânticos. - cargs (
list) – Lista de argumentos clássicos de bits.
Tipo de retorno
Retorna
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.
control
control(num_ctrl_qubits=1, label=None, ctrl_state=None, annotated=None)
Retorna a versão controlada de si mesmo.
A porta controlada é implementada como ControlledGate quando annotated é False, e como AnnotatedOperation quando annotated é True.
qiskit.circuit.gate.Gate.control()O argumento annotated está obsoleto a partir do Qiskit 2.3. Ele será removido no Qiskit 3.0. O método Gate.control () não aceita mais annotated=None. O novo valor padrão é annotated=True, o que representa o portão controlado como um AnnotatedOperation (a menos que já exista uma classe dedicada para portões controlados). Você pode definir explicitamente annotated=False para manter o comportamento anterior. No entanto, recomenda-se o uso de annotated=True, pois isso transfere a construção do circuito controlado para o transpiler e, além disso, permite otimizações adicionais de portas controladas (o que normalmente resulta em circuitos de melhor qualidade).
Parâmetros
- num_ctrl_qubits (
int) – Número de controles a serem adicionados. Padroniza para1. - label (
str|None) – Etiqueta opcional para o portão. Padroniza paraNone. É ignorado se o portão controlado for implementado como uma operação anotada. - ctrl_state (
int|str|None) – O estado de controle da porta, especificado como um número inteiro ou uma sequência de bits (por exemplo,"110").2**num_ctrl_qubits - 1SeNone, o valor padrão é o estado em que todos os bits são 1. - annotated (
bool|None) – Indica se a porta controlada deve ser implementada como uma porta controlada ou como uma operação anotada. SeNone, considerado comoFalse.
Retorna
Uma versão controlada dessa porta.
Aumentos
QiskitError – inválido num_ctrl_qubits ou ctrl_state.
copy
copy(name=None)
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
inverse
inverse(annotated=False)
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 AnnotatedOperation, e corresponderá à 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()
Retorna se o site Instruction contém parâmetros de tempo de compilação.
power
power(exponent, annotated=False)
Eleve esse portão ao poder de exponent.
Implementado como uma porta unitária (ref. UnitaryGate) ou como uma operação anotada (ref. AnnotatedOperation). No caso de várias portas padrão, como RXGate, quando a potência de uma porta pode ser expressa em termos de outra porta padrão, isso é retornado diretamente.
Parâmetros
- exponent (float) – o poder de elevar o portão para
- annotated (bool) – indica se o power gate pode ser implementado como uma operação anotada. No caso de várias portas padrão, como
RXGate, esse argumento é ignorado quando a potência de uma porta pode ser expressa em termos de outra porta padrão.
Retorna
Uma operação que implementa gate^exponent
Aumentos
CircuitError - Se a porta não for unitária
repeat
repeat(n)
self Cria uma instrução repetida vezes.
Parâmetros
n (int) – Número de vezes para repetir a instrução
Retorna
Contendo a definição.
Tipo de retorno
Aumentos
CircuitError - Se n < 1.
reverse_ops
reverse_ops()
Para 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
soft_compare
soft_compare(other)
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 conta.
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
to_matrix
to_matrix()
Retorna um Numpy.array para a matriz unitária da porta.
Retorna
se a subclasse Gate tiver uma definição de matriz.
Tipo de retorno
np.ndarray
Aumentos
CircuitError - Se uma subclasse do Gate não implementar esse método, será gerada uma exceção quando esse método da classe base for chamado.
to_mutable
to_mutable()
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, será uma cópia profunda dessa instância.
validate_parameter
validate_parameter(parameter)
Os parâmetros do gate devem ser int, float ou ParameterExpression