XSlowGate

Obtén la clase base de esta instrucción. Esto formará parte, sin duda, del árbol genealógico de self.

La «clase base» de una instrucción es la clase más baja de su árbol de herencia con la que el objeto debe considerarse totalmente compatible para _todas_ las aplicaciones de circuitos. Esto suele significar que la subclase se define únicamente para facilitar el trabajo del programador con respecto a la clase base, y que la clase base es la «verdadera» clase desde el punto de vista del comportamiento. En concreto, no debes anular base_class si estás definiendo una versión personalizada de una instrucción que el hardware implementará de forma diferente, como una estrategia de medición alternativa o una versión de una puerta parametrizada con un conjunto concreto de parámetros con el fin de distinguirla en un Target de la puerta parametrizada completa.

A menudo, esto es exactamente equivalente a type(obj), salvo en el caso de las instancias únicas de las instrucciones de la biblioteca estándar. Estas instancias singleton son subclases especiales de su clase base, y esta propiedad devolverá dicha clase base. Por ejemplo:

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

En general, no debes basarte en la clase concreta de una instrucción; dentro de un circuito determinado, cabe esperar que Instruction.name sea un criterio de distinción más adecuado en la mayoría de los casos.

Consulta las descomposiciones de la instrucción en SessionEquivalenceLibrary.

Define la función «return» en términos de otras puertas lógicas básicas.

Etiqueta con instrucciones de devolución

¿Es esta instancia una instancia única mutable o no?

Si este atributo está presente, la False 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 sería que fueran ángulos de compuerta.

add_decomposition(decomposition)

Añade un desglose de la instrucción a la página « SessionEquivalenceLibrary ».

broadcast_arguments(qargs, cargs)

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

Por ejemplo, significa cx([q[0],q[1]], q[2]) cx(q[0], q[2]); cx(q[1], q[2]). Este método devuelve los argumentos agrupados correctamente. En el ejemplo que se ofrece:

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

Las normas generales de emisión son las siguientes:

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

Devuelve

Una tupla con un único argumento.

Subidas

CircuitError – Si la entrada no es válida. Por ejemplo, el número de argumentos no coincide con lo que cabría esperar de la puerta lógica.

Tipo de retorno

Iterable [tupla[list, list]]

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

Devuelve la versión controlada de sí misma.

La puerta controlada se implementa como ControlledGate cuando annotated es False, y como AnnotatedOperation cuando es annotated True.

Parámetros

• num_ctrl_qubits (int) – Número de controles que se deben añadir. El valor predeterminado es 1.
• label (str | None) – Etiqueta opcional para la puerta. El valor predeterminado es None. Se ignora si la puerta controlada se implementa como una operación anotada.
• ctrl_state (int | str | None) – El estado de control de la puerta, especificado como un número entero o como una cadena de bits (p. ej., "110"). Si None, se establece por defecto en el estado en el que todos los bits son unos 2**num_ctrl_qubits - 1.
• annotated (bool | None) – Indica si la puerta controlada debe implementarse como una puerta controlada o como una operación anotada. Si None, se considera como False.

Devuelve

Una versión controlada de esta puerta.

Subidas

QiskitError – no válido o num_ctrl_qubits ctrl_state.

copy(name=None)

Copia de las instrucciones.

Parámetros

name (str) – nombre que se le dará al circuito copiado; si entonces None el nombre sigue siendo el mismo.

Devuelve

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

Tipo de retorno

qiskit.circuit.Instruction

inverse(annotated=False)

Invierte esta instrucción.

Si «annotated» es «False», la instrucción inversa se implementa como una nueva instrucción con la definición invertida de forma recursiva.

Si «annotated» es «True», la instrucción inversa se implementa como AnnotatedOperation, y se corresponde con la instrucción dada, a la que se le ha añadido el «modificador inverso».

Las instrucciones especiales que heredan de «Instruction» pueden implementar su propia inversa (p. ej., T y Tdg, Barrier, etc.) En concreto, pueden elegir cómo gestionar el argumento, lo que annotated puede incluir ignorarlo y devolver siempre una clase de puerta concreta si la inversa está definida 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.

Subidas

CircuitError – si la instrucción no es compuesta y no se ha implementado su inversa.

is_parameterized()

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

power(exponent, annotated=False)

Eleva esta puerta a la potencia de exponent.

Se implementa como una puerta unitaria (ref. UnitaryGate) o como una operación comentada (véase AnnotatedOperation). En el caso de varias puertas lógicas estándar, como, por ejemplo RXGate, cuando la potencia de una puerta se puede expresar en términos de otra puerta lógica estándar que se devuelve directamente.

Parámetros

• exponent (float) – la capacidad de levantar la verja para
• annotated (bool) – indica si la puerta de potencia se puede implementar como una operación anotada. En el caso de varias puertas estándar, como por ejemplo 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 que implementa gate^exponent

Subidas

CircuitError – Si la puerta no es unitaria

repeat(n)

Crea una instrucción que se repite $n$self veces.

Parámetros

n (int) – Número de veces que hay que repetir la instrucción

Devuelve

Que contiene la definición.

Tipo de retorno

qiskit.circuit.Instruction

Subidas

CircuitError – Si n < 1.

reverse_ops()

En el caso de una instrucción compuesta, invierte el orden de las subinstrucciones.

Esto se consigue invirtiendo de forma recursiva todas las subinstrucciones. No invierte ninguna puerta lógica.

Devuelve

una nueva instrucción con

subinstrucciones invertidas.

Tipo de retorno

qiskit.circuit.Instruction

soft_compare(other)

Comparación suave entre puertas. Sus nombres, el número de qubits y el número de bits clásicos deben coincidir. El número de parámetros debe coincidir. Se comparan todos los parámetros. Si se es « ParameterExpression », entonces no se tiene en cuenta.

Parámetros

other (instruction) – otras instrucciones.

Devuelve

«self» y «other» son iguales en las expresiones de parámetros.

Tipo de retorno

bool

to_matrix()

Devuelve un objeto Numpy.array que representa la matriz unitaria de la puerta.

Devuelve

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

Tipo de retorno

np.ndarray

Subidas

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

to_mutable()

Devuelve una copia modificable de esta puerta.

Este método devolverá una nueva copia modificable de esta instancia de puerta. Si se utiliza una instancia singleton, se creará una nueva instancia única que podrá modificarse. Si la instancia ya es mutable, se creará una copia profunda de dicha instancia.

validate_parameter(parameter)

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