z ipSrSSKJr SSKJrJrJrJr SSKJ r SSK J r "SS\5r "SS \5r g ) zBoolean AND circuit and gate.) annotations)QuantumRegisterQuantumCircuitAncillaRegisterGate)MCXGate)deprecate_funcc\^\rSrSrSr\"SSSS9S S U4Sjjj5rSrU=r$) ANDaUA circuit implementing the logical AND operation on a number of qubits. For the AND operation the state :math:`|1\rangle` is interpreted as ``True``. The result qubit is flipped, if the state of all variable qubits is ``True``. In this format, the AND operation equals a multi-controlled X gate, which is controlled on all variable qubits. Using a list of flags however, qubits can be skipped or negated. Practically, the flags allow to skip controls or to apply pre- and post-X gates to the negated qubits. The AND gate without special flags equals the multi-controlled-X gate: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import AND from qiskit.visualization.library import _generate_circuit_library_visualization circuit = AND(5) _generate_circuit_library_visualization(circuit) Using flags we can negate qubits or skip them. For instance, if we have 5 qubits and want to return ``True`` if the first qubit is ``False`` and the last two are ``True`` we use the flags ``[-1, 0, 0, 1, 1]``. .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import AND from qiskit.visualization.library import _generate_circuit_library_visualization circuit = AND(5, flags=[-1, 0, 0, 1, 1]) _generate_circuit_library_visualization(circuit) z2.1z+Use qiskit.circuit.library.AndGate instead.z in Qiskit 3.0)sinceadditional_msgremoval_timelinec>XlX l[USS9n[SSS9n[XESS9nU=(d S/U-n[ XB5VVs/sHupxUS:wdM UPM n nn[ XB5VVs/sHupxUS:dM UPM n nn[ R "[U 5US9n U S:a[U S5n URU 5 O [S5n [U 5S:aURU 5 URXS S U S S US9 [U 5S:aURU 5 [T U]4"URS S06 URUR!5UR"S S 9 g s snnfs snnf) a  Args: num_variable_qubits: The qubits of which the AND is computed. The result will be written into an additional result qubit. flags: A list of +1/0/-1 marking negations or omissions of qubits. mcx_mode: The mode to be used to implement the multi-controlled X gate. variablenameresultandr)modeancillaNrT)qubitsinplace)num_variable_qubitsflagsrrziprget_num_ancilla_qubitslenr add_registerxmcxsuper__init__qregscomposeto_gater)selfrrmcx_mode qr_variable qr_resultcircuitqflagcontrol_qubits flip_qubits num_ancillas qr_ancilla __class__s j/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/boolean_logic/quantum_and.pyr$ AND.__init__8sd$$7  &&9 K #AH5  eD2!22+.{+BP+Bdai!+BP),K(?L(?WQ4!8q(? L55c.6IPXY ! (yAJ   ,(+J { a  IIk " NaL*Q-h O { a  IIk " '--4e4 W__&t{{D I)QMs E1E10 E7E7)rr)N noancilla)rintrlist[int] | Noner)strreturnNone) __name__ __module__ __qualname____firstlineno____doc__r r$__static_attributes__ __classcell__r3s@r4r r s_@D(#'# ,J ,J ,J ,J  ,J  ,Jr cZ^\rSrSrSrSS U4SjjjrSrS S SjjrSrSr U=r $) AndGatela2A gate representing the logical AND operation on a number of qubits. For the AND operation the state :math:`|1\rangle` is interpreted as ``True``. The result qubit is flipped, if the state of all variable qubits is ``True``. In this format, the AND operation equals a multi-controlled X gate, which is controlled on all variable qubits. Using a list of flags however, qubits can be skipped or negated. Practically, the flags allow to skip controls or to apply pre- and post-X gates to the negated qubits. The AndGate gate without special flags equals the multi-controlled-X gate: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit import QuantumCircuit from qiskit.circuit.library import AndGate from qiskit.visualization.library import _generate_circuit_library_visualization circuit = QuantumCircuit(6) circuit.append(AndGate(5), [0, 1, 2, 3, 4, 5]) _generate_circuit_library_visualization(circuit) Using flags we can negate qubits or skip them. For instance, if we have 5 qubits and want to return ``True`` if the first qubit is ``False`` and the last two are ``True`` we use the flags ``[-1, 0, 0, 1, 1]``. .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit import QuantumCircuit from qiskit.circuit.library import AndGate from qiskit.visualization.library import _generate_circuit_library_visualization circuit = QuantumCircuit(6) circuit.append(AndGate(5, flags=[-1, 0, 0, 1, 1]), [0, 1, 2, 3, 4, 5]) _generate_circuit_library_visualization(circuit) cF>[TU]SUS-/5 XlX lg)z Args: num_variable_qubits: The qubits of which the AND is computed. The result will be written into an additional result qubit. flags: A list of +1/0/-1 marking negations or omissions of qubits. rrN)r#r$rr)r(rrr3s r4r$AndGate.__init__s'  3a 7<#6  rDc[URSS9n[SSS9nUR=(d S/UR-n[X5VVs/sHupEUS:wdM UPM nnn[X5VVs/sHupEUS:dM UPM nnn[ XSS9n[ U5S:aUR U5 URXbSS5 [ U5S:aUR U5 Xlgs snnfs snnf)Nrrrrrr) rrrrrrr!r" definition) r(r*r+rr-r.r/r0r,s r4_defineAndGate._defines%d&>&>ZP #AH5  r?r@r$rLrPrVrArBrCs@r4rFrFlsH"N#'        "0 =  rDrFN)r@ __future__rqiskit.circuitrrrr%qiskit.circuit.library.standard_gatesrqiskit.utils.deprecationr r rFrDr4r^s8$"QQ93RJ.RJj_ d_ rD