Skip to main contentIBM Quantum Documentation
You are viewing the API reference for an old version of Qiskit SDK. Switch to latest version


circuit_to_gate(circuit, parameter_map=None, equivalence_library=None, label=None)

GitHub(opens in a new tab)

Build a Gate object from a QuantumCircuit.

The gate is anonymous (not tied to a named quantum register), and so can be inserted into another circuit. The gate will have the same string name as the circuit.


  • circuit (QuantumCircuit) – the input circuit.
  • parameter_map (dict) – For parameterized circuits, a mapping from parameters in the circuit to parameters to be used in the gate. If None, existing circuit parameters will also parameterize the Gate.
  • equivalence_library (EquivalenceLibrary) – Optional equivalence library where the converted gate will be registered.
  • label (str) – Optional gate label.


QiskitError – if circuit is non-unitary or if parameter_map is not compatible with circuit


a Gate equivalent to the action of the input circuit. Upon decomposition, this gate will yield the components comprising the original circuit.

Return type


Was this page helpful?
Report a bug or request content on GitHub.