qiskit-documentation/docs/api/qiskit/0.26/qiskit.converters.circuit_t...

38 lines
1.7 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: circuit_to_gate (v0.26)
description: API reference for qiskit.converters.circuit_to_gate in qiskit v0.26
in_page_toc_min_heading_level: 1
python_api_type: function
python_api_name: qiskit.converters.circuit_to_gate
---
<span id="qiskit-converters-circuit-to-gate" />
# qiskit.converters.circuit\_to\_gate
<Function id="qiskit.converters.circuit_to_gate" isDedicatedPage={true} github="https://github.com/qiskit/qiskit/tree/stable/0.17/qiskit/converters/circuit_to_gate.py" signature="circuit_to_gate(circuit, parameter_map=None, equivalence_library=None, label=None)">
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.
**Parameters**
* **circuit** ([*QuantumCircuit*](qiskit.circuit.QuantumCircuit "qiskit.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*](qiskit.circuit.EquivalenceLibrary "qiskit.circuit.EquivalenceLibrary")) Optional equivalence library where the converted gate will be registered.
* **label** (*str*) Optional gate label.
**Raises**
**QiskitError** if circuit is non-unitary or if parameter\_map is not compatible with circuit
**Returns**
a Gate equivalent to the action of the input circuit. Upon decomposition, this gate will yield the components comprising the original circuit.
**Return type**
[Gate](qiskit.circuit.Gate "qiskit.circuit.Gate")
</Function>