quri_parts.qsub.lib.std.multi_control_gates module

MCX: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCX object>)

Multi-controlled X gate. Applies X gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCY: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCY object>)

Multi-controlled Y gate. Applies Y gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCZ: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCZ object>)

Multi-controlled Z gate. Applies Z gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCS: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCS object>)

Multi-controlled S gate. Applies S gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCSdag: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCSdag object>)

Multi-controlled S† gate. Applies S† gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCT: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCT object>)

Multi-controlled T gate. Applies T gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCTdag: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCTdag object>)

Multi-controlled T† gate. Applies T† gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCSqrtX: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCSqrtX object>)

Multi-controlled √X gate. Applies √X gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCSqrtXdag: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCSqrtXdag object>)

Multi-controlled √X† gate. Applies √X† gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCSqrtY: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCSqrtY object>)

Multi-controlled √Y gate. Applies √Y gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCSqrtYdag: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCSqrtYdag object>)

Multi-controlled √Y† gate. Applies √Y† gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCH: OpFactory[(<class 'int'>,)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCH object>)

Multi-controlled Hadamard gate. Applies H gate to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCRZ: OpFactory[(<class 'int'>, <class 'float'>)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCRZ object>)

Multi-controlled RZ rotation gate. Applies RZ(angle) to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCRX: OpFactory[(<class 'int'>, <class 'float'>)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCRX object>)

Multi-controlled RX rotation gate. Applies RX(angle) to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCRY: OpFactory[(<class 'int'>, <class 'float'>)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCRY object>)

Multi-controlled RY rotation gate. Applies RY(angle) to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MCPhase: OpFactory[(<class 'int'>, <class 'float'>)] = _ParamOpFactory(op_def=<quri_parts.qsub.lib.std.multi_control_gates._MCPhase object>)

Multi-controlled Phase gate. Applies Phase(angle) to target qubit when all control qubits are in |1⟩ state.

Parameters:

params (Params.args)

Return type:

Op

MultiControlledNamedMCGatesSub(target_op, control_bits, control_value)

Resolves MultiControlled operations using named multi-controlled gates.

Maps known target operations to their corresponding named MC gate variants (MCX, MCY, MCZ, MCS, etc.) when available. For unknown operations, returns None to allow the system to fall back to the standard MultiControlledSub resolver.

Please use generate_multicontrolled_to_mc_sub_resolver() instead, which also resolves MultiControlled gates, generating known MC? gates and fallback with unknown ops.

Parameters:

• target_op (Op)

• control_bits (int)

• control_value (int)

Return type:

Sub | None

generate_multicontrolled_to_mc_sub_resolver(s_and=<function scoped_and>)

Generates a resolver that expands MultiControlled to named MC operations when possible.

This resolver is useful when you expect named MC gates as final primitives, especially when converting circuits to SimulatorBasicSet. In other cases, it may emit redundant Toffoli (or s_and) chains during the compilation process.

From the end-user perspective, all MultiControlled operations work: known operations use optimized named gates, while unknown operations use the standard decomposition.

Algorithm: 1. Evaluate MultiControlledNamedMCGatesSub to try converting the MultiControlled

operation to a named MC gate.

2. If that fails, try to resolve the target operation. If successful, wrap each operation in the sub with MultiControlled.

3. If that also fails, decompose the MultiControlled using Toffoli or s_and (default behavior).

During expansion, adds MultiControlled Phase gates according to the global phase of the operation.

Example

>>> new_repo = default_repository().copy()
>>> new_repo.register_sub_resolver(
...     MultiControlled, generate_multicontrolled_to_mc_sub_resolver()
... )

Parameters:

s_and (Callable[[SubBuilder, Qubit, Qubit], AbstractContextManager[Qubit]])

Return type:

SubResolver

mcx_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcy_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcz_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcs_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcsdag_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mct_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mctdag_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcsqrtx_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcsqrtxdag_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcsqrty_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcsqrtydag_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mch_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcphase_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcrz_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcrx_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub

mcry_resolver(op, repository)

Parameters:

• op (Op)

• repository (SubRepository)

Return type:

Sub