mimiqcircuits.operations.power

Power operation.

Functions

canonical_power(inner_gate_type, exponent)	Decorator to register a canonical Power subclass.
register_power_alias(exponent, gate_type, name)	Register an alias for a power gate definition
register_power_decomposition(exponent, gate_type)	Decorator to register a decomposition function for a gate type

Classes

Power([operation, exponent])

Power operation.

class mimiqcircuits.operations.power.Power(operation=None, exponent=None, *args, **kwargs)

Bases: Gate

Power operation.

Represents a Power operation raised to a specified exponent.

When a canonical subclass is registered (e.g., GateS for Power(GateZ(), 1/2)), constructing Power with matching arguments will return an instance of that subclass. This enables isinstance() checks to work correctly:

Examples

>>> from mimiqcircuits import *
>>> isinstance(Power(GateZ(), 0.5), GateS)
True
>>> c= Circuit()
>>> c.push(Power(GateX(),1/2),1)
2-qubit circuit with 1 instruction:
└── SX @ q[1]

>>> c.push(Power(GateX(),5),1)
2-qubit circuit with 2 instructions:
├── SX @ q[1]
└── X**5 @ q[1]

>>> c.decompose()
2-qubit circuit with 9 instructions:
├── U(0, 0, (-1/2)*pi, 0.0) @ q[1]
├── U((1/2)*pi, 0, pi, 0.0) @ q[1]
├── U(0, 0, (-1/2)*pi, 0.0) @ q[1]
├── U(0, 0, 0, (1/4)*pi) @ q[1]
├── U(pi, 0, pi, 0.0) @ q[1]
├── U(pi, 0, pi, 0.0) @ q[1]
├── U(pi, 0, pi, 0.0) @ q[1]
├── U(pi, 0, pi, 0.0) @ q[1]
└── U(pi, 0, pi, 0.0) @ q[1]

static __new__(cls, operation=None, exponent=None, *args, **kwargs)

Create a Power instance, returning canonical subclass if registered.

If a canonical subclass is registered for (type(operation), exponent), an instance of that subclass is returned instead of a plain Power.

Parameters:

• operation (Type[Gate] | Gate) – Gate operation or gate class to raise to a power

• exponent (Any) – The exponent value

• *args – Arguments to pass to operation constructor if a class is provided

• **kwargs – Keyword arguments to pass to operation constructor

Returns:

Instance of Power or a registered canonical subclass

__init__(operation, exponent, *args, **kwargs)

property op

property exponent

iswrapper()

Check if the operator is a wrapper around another operator.

This method should be overridden in subclasses to return True if the operator is acting as a wrapper around another operation or object, and False otherwise.

Returns:

Always returns False in the base class. Subclasses should override this method to provide the appropriate logic.

Return type:

bool

power(*args)

Raise an error, as powers of non-unitary operators are not supported.

This method is not implemented for non-unitary operators and will raise a NotImplementedError if called.

Parameters:

n (int) – The exponent to which the operator would be raised.

Raises:

NotImplementedError – If the method is called.

inverse()

Raise an error, as non-unitary operators cannot be inverted.

This method is not implemented for non-unitary operators and will raise a NotImplementedError if called.

Raises:

NotImplementedError – If the method is called.

control(*args)

parallel(*args)

getparams()

isopalias()

evaluate(d)

Substitute the symbolic parameters of the operator with numerical values.

This method evaluates the operator’s symbolic parameters using the values provided in the dictionary d. If the operator has no parameters, it returns the same instance. Otherwise, it creates a new instance of the operator with updated numerical parameters.

Parameters:

d (dict) – A dictionary where keys are symbolic parameter names and values are values for substitution.

Example

>>> from symengine import *
>>> from mimiqcircuits import *
>>> theta = symbols('theta')
>>> op = GateRX(theta)
>>> evaluated_op = op.evaluate({'theta': 0.5})
>>> print(evaluated_op)
RX(0.5)

gettypekey()

decompose()

mimiqcircuits.operations.power.canonical_power(inner_gate_type, exponent)

Decorator to register a canonical Power subclass.

When Power(inner_gate_type(), exponent) is called, it will return an instance of the decorated subclass instead.

Parameters:

• inner_gate_type (Type) – Type of the inner gate

• exponent (Any) – The exponent value

Returns:

Decorator that registers the class

Example

>>> from mimiqcircuits import *
>>> @canonical_power(GateZ, Fraction(1, 2))
... class GateS(Power):
...     pass
>>> isinstance(Power(GateZ(), 0.5), GateS)
True