# qiskit.extensions.UnitaryGate¶

class UnitaryGate(data, label=None)[ソース]

Class for representing unitary gates

Create a gate from a numeric unitary matrix.

パラメータ
• data (matrix or Operator) – unitary operator.

• label (str) – unitary name for backend [Default: None].

ExtensionError – if input data is not an N-qubit unitary operator.

__init__(data, label=None)[ソース]

Create a gate from a numeric unitary matrix.

パラメータ
• data (matrix or Operator) – unitary operator.

• label (str) – unitary name for backend [Default: None].

ExtensionError – if input data is not an N-qubit unitary operator.

Methods

 __init__(data[, label]) Create a gate from a numeric unitary matrix. add_decomposition(decomposition) Add a decomposition of the instruction to the SessionEquivalenceLibrary. Return the adjoint of the unitary. Assemble a QasmQobjInstruction broadcast_arguments(qargs, cargs) Validation and handling of the arguments and its relationship. c_if(classical, val) Add classical condition on register classical and value val. Return the conjugate of the unitary. control([num_ctrl_qubits, label, ctrl_state]) Return controlled version of gate copy([name]) Copy of the instruction. Return the adjoint of the unitary. Return True .IFF. DEPRECATED: use instruction.reverse_ops(). power(exponent) Creates a unitary gate as gate^exponent. The qasm for a custom unitary gate This is achieved by adding a custom gate that corresponds to the definition of this gate. Creates an instruction with gate repeated n amount of times. For a composite instruction, reverse the order of sub-instructions. soft_compare(other) Soft comparison between gates. Return a Numpy.array for the gate unitary matrix. Return the transpose of the unitary. validate_parameter(parameter) Unitary gate parameter has to be an ndarray.

Attributes

 decompositions Get the decompositions of the instruction from the SessionEquivalenceLibrary. definition Return definition in terms of other basic gates. duration Get the duration. label Return gate label params return instruction params. unit Get the time unit of duration.
add_decomposition(decomposition)

Add a decomposition of the instruction to the SessionEquivalenceLibrary.

adjoint()[ソース]

Return the adjoint of the unitary.

assemble()

Assemble a QasmQobjInstruction

Instruction

broadcast_arguments(qargs, cargs)

Validation and handling of the arguments and its relationship.

For example, cx([q[0],q[1]], q[2]) means cx(q[0], q[2]); cx(q[1], q[2]). This method yields the arguments in the right grouping. In the given example:

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


• If len(qargs) == 1:

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

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

• If len(qargs) >= 3:

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

パラメータ
• qargs (List) – List of quantum bit arguments.

• cargs (List) – List of classical bit arguments.

Tuple[List, List]

A tuple with single arguments.

CircuitError – If the input is not valid. For example, the number of arguments does not match the gate expectation.

c_if(classical, val)

Add classical condition on register classical and value val.

conjugate()[ソース]

Return the conjugate of the unitary.

control(num_ctrl_qubits=1, label=None, ctrl_state=None)[ソース]

Return controlled version of gate

パラメータ
• num_ctrl_qubits (int) – number of controls to add to gate (default=1)

• label (str) – optional gate label

• ctrl_state (int or str or None) – The control state in decimal or as a bit string (e.g. 『1011』). If None, use 2**num_ctrl_qubits-1.

controlled version of gate.

UnitaryGate

• QiskitError – Invalid ctrl_state.

• ExtensionError – Non-unitary controlled unitary.

copy(name=None)

Copy of the instruction.

パラメータ

name (str) – name to be given to the copied circuit, if None then the name stays the same.

a copy of the current instruction, with the name

updated if it was provided

qiskit.circuit.Instruction

property decompositions

Get the decompositions of the instruction from the SessionEquivalenceLibrary.

property definition

Return definition in terms of other basic gates.

property duration

Get the duration.

inverse()[ソース]

Return the adjoint of the unitary.

is_parameterized()

Return True .IFF. instruction is parameterized else False

property label

Return gate label

str

mirror()

DEPRECATED: use instruction.reverse_ops().

a new instruction with sub-instructions

reversed.

qiskit.circuit.Instruction

property params

return instruction params.

power(exponent)

Creates a unitary gate as gate^exponent.

パラメータ

exponent (float) – Gate^exponent

To which to_matrix is self.to_matrix^exponent.

qiskit.extensions.UnitaryGate

CircuitError – If Gate is not unitary

qasm()[ソース]

The qasm for a custom unitary gate This is achieved by adding a custom gate that corresponds to the definition of this gate. It gives the gate a random name if one hasn’t been given to it.

repeat(n)

Creates an instruction with gate repeated n amount of times.

パラメータ

n (int) – Number of times to repeat the instruction

Containing the definition.

qiskit.circuit.Instruction

CircuitError – If n < 1.

reverse_ops()

For a composite instruction, reverse the order of sub-instructions.

This is done by recursively reversing all sub-instructions. It does not invert any gate.

a new instruction with

sub-instructions reversed.

qiskit.circuit.Instruction

soft_compare(other)

Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.

パラメータ

other (instruction) – other instruction.

are self and other equal up to parameter expressions.

bool

to_matrix()

Return a Numpy.array for the gate unitary matrix.

if the Gate subclass has a matrix definition.

np.ndarray

CircuitError – If a Gate subclass does not implement this method an exception will be raised when this base class method is called.

transpose()[ソース]

Return the transpose of the unitary.

property unit

Get the time unit of duration.

validate_parameter(parameter)[ソース]

Unitary gate parameter has to be an ndarray.