CutWire

Obtiene la clase base de esta instrucción. Está garantizado que se encuentra en el árbol de herencia de self.

La "clase base" de una instrucción es la clase más baja en su árbol de herencia con la que el objeto debe considerarse totalmente compatible para aplicaciones de circuito _all_. Por lo general, esto significa que la subclase se define únicamente para ofrecer algún tipo de comodidad al programador con respecto a la clase base, y la clase base es la "verdadera" clase desde el punto de vista del comportamiento. En particular, no debe anular base_class si estás definiendo una versión personalizada de una instrucción que será implementada de forma diferente por el hardware, como una estrategia de medida alternativa, o una versión de una puerta parametrizada con un conjunto particular de parámetros con el propósito de distinguirla en Target de la puerta parametrizada completa.

Esto suele ser exactamente equivalente a type(obj), excepto en el caso de instancias únicas de instrucciones de biblioteca estándar. Estas instancias singleton son subclases especiales de su clase base, y esta propiedad devolverá esa base. Por ejemplo:

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

En general, no se debe confiar en la clase precisa de una instrucción; dentro de un circuito determinado, se espera que Instruction.name sea un discriminador más adecuado en la mayoría de las situaciones.

La condición clásica en la instrucción.

Obtener Clbits en condiciones.

Obtenga las descomposiciones de la instrucción de la SessionEquivalenceLibrary.

Definición de retorno en términos de otras puertas básicas.

Consigue la duración.

Etiqueta de instrucciones de devolución

Esta instancia es una instancia única mutable o no.

Si este atributo es False la instancia de la puerta es un singleton compartido y no es mutable.

Devuelve el nombre.

Devuelve el número de clbits.

Devuelve el número de qubits.

Los parámetros de este Instruction. Lo ideal es que sean ángulos de puerta.

Obtener la unidad de tiempo de duración.

add_decomposition(decomposition)

Añade una descomposición de la instrucción a la SessionEquivalenceLibrary.

assemble()

Montar un QasmQobjInstruction

broadcast_arguments(qargs, cargs)

Validación y tratamiento de los argumentos y su relación.

Por ejemplo, cx([q[0],q[1]], q[2]) significa cx(q[0], q[2]); cx(q[1], q[2]). Este método devuelve los argumentos en la agrupación correcta. En el ejemplo dado:

in: [[q[0],q[1]], q[2]],[]
outs: [q[0], q[2]], []
      [q[1], q[2]], []

Las normas generales de difusión son:

• Si len(qargs) == 1:

  [q[0], q[1]] -> [q[0]],[q[1]]

• Si 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]]

• Si 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 cuánticos.
• cargs (list) – Lista de argumentos clásicos de bits.

Tipo de retorno

Iterable[tuple[list, list]]

Devuelve

Una tupla con argumentos únicos.

Eleva

CircuitError - Si la entrada no es válida. Por ejemplo, el número de argumentos no coincide con las expectativas de la puerta.

c_if(classical, val)

Establece una condición de igualdad clásica en esta instrucción entre el registro o cbit classical y el valor val.

control(num_ctrl_qubits=1, label=None, ctrl_state=None, annotated=None)

Devuelve la versión controlada de sí mismo.

Implementado como una puerta controlada (ref. ControlledGate) o como una operación anotada (ref. AnnotatedOperation).

Parámetros

• num_ctrl_qubits (int) – número de controles que se añadirán a la puerta (por defecto: 1)
• label (str | None) – etiqueta de puerta opcional. Se ignora si se implementa como una operación anotada.
• ctrl_state (int | str | None) – el estado de control en decimal o como una cadena de bits (por ejemplo, '111'). Si None, utilice 2**num_ctrl_qubits-1.
• annotated (bool | None) – indica si la puerta controlada se implementa como una puerta anotada. Si None, se establece en False si la puerta controlada puede construirse directamente, y en caso contrario se establece en True. Esto permite aplazar el proceso de construcción en caso de que la síntesis de la puerta controlada requiera más información (por ejemplo, valores de parámetros no vinculados).

Devuelve

Versión controlada de la operación dada.

Eleva

QiskitError - modo no reconocido o ctrl_state no válido

copy(name=None)

Copia de la instrucción.

Parámetros

name (str) – nombre que se dará al circuito copiado, si None entonces el nombre permanece igual.

Devuelve

una copia de la instrucción actual, con el nombre actualizado si se proporcionó

Tipo de retorno

qiskit.circuit.Instruction

inverse(annotated=False)

Invierta esta instrucción.

Si annotated es False, la instrucción inversa se implementa como una instrucción nueva con la definición invertida recursivamente.

Si annotated es True, la instrucción inversa se implementa como AnnotatedOperation, y corresponde a la instrucción dada anotada con el "modificador inverso".

Las instrucciones especiales que heredan de Instruction pueden implementar su propia inversa (por ejemplo, T y Tdg, Barrier, etc.) En particular, pueden elegir cómo manejar el argumento annotated que puede incluir ignorarlo y devolver siempre una clase de puerta concreta si la inversa se define como una puerta estándar.

Parámetros

annotated (bool) – si se establece en True la puerta inversa de salida se devolverá como AnnotatedOperation.

Devuelve

La operación inversa.

Eleva

CircuitError - si la instrucción no es compuesta y no se ha implementado una inversa para ella.

is_parameterized()

Devuelve si Instruction contiene parámetros de compilación.

power(exponent, annotated=False)

Eleva esta puerta al poder de exponent.

Implementado como puerta unitaria (ref. UnitaryGate) o como una operación anotada (ref. AnnotatedOperation). En el caso de varias puertas estándar, como RXGate, cuando la potencia de una puerta se puede expresar en términos de otra puerta estándar que se devuelve directamente.

Parámetros

• exponent (float) – el poder de elevar la puerta a
• annotated (bool) – indica si la puerta de alimentación puede implementarse como una operación anotada. En el caso de varias puertas estándar, como RXGate, este argumento se ignora cuando la potencia de una puerta puede expresarse en términos de otra puerta estándar.

Devuelve

Una operación de aplicación gate^exponent

Eleva

CircuitError - Si la puerta no es unitaria

repeat(n)

Crea una instrucción con self repetida :math`n` veces.

Si esta operación tiene un condicional, la instrucción de salida tendrá el mismo condicional y las operaciones internas repetidas serán incondicionales; las instrucciones dentro de una definición compuesta no pueden ser condicionadas en registros dentro del modelo de datos de Qiskit. Esto significa que no es válido aplicar una instrucción repetida a un clbit que tanto escribe como lee en su condición.

Parámetros

n (int) – Número de veces que se repite la instrucción

Devuelve

Contiene la definición.

Tipo de retorno

qiskit.circuit.Instruction

Eleva

CircuitError - Si n < 1.

reverse_ops()

Para una instrucción compuesta, invierta el orden de las subinstrucciones.

Esto se hace invirtiendo recursivamente todas las subinstrucciones. No invierte ninguna puerta.

Devuelve

una nueva instrucción con

subinstrucciones invertidas.

Tipo de retorno

qiskit.circuit.Instruction

soft_compare(other)

Comparación suave entre puertas. Sus nombres, número de qubits y números de bits clásicos deben coincidir. El número de parámetros debe coincidir. Se compara cada parámetro. Si uno es un ParameterExpression entonces no se tiene en cuenta.

Parámetros

other (instruction) – otras instrucciones.

Devuelve

son auto y otros iguales hasta expresiones de parámetros.

Tipo de retorno

bool

to_matrix()

Devuelve un Numpy.array para la matriz unitaria de la puerta.

Devuelve

si la subclase Gate tiene una definición de matriz.

Tipo de retorno

np.ndarray

Eleva

CircuitError - Si una subclase de Gate no implementa este método, se producirá una excepción cuando se llame a este método de la clase base.

to_mutable()

Devuelve una copia mutable de esta puerta.

Este método devolverá una nueva copia mutable de esta instancia de puerta. Si se utiliza una instancia singleton, ésta será una nueva instancia única que puede mutar. Si la instancia ya es mutable será una deepcopy de esa instancia.

validate_parameter(parameter)

Los parámetros de la puerta deben ser int, float o ParameterExpression