> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qbraid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cirq conversions

## Example Usage

Convert a `Cirq` circuit to `QIR` code:

<CodeGroup>
  ```python Code theme={null}
  import cirq
  from qbraid_qir import dumps
  from qbraid_qir.cirq import cirq_to_qir

  # create a test circuit

  q0, q1 = cirq.LineQubit.range(2)
  circuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1))

  # convert to QIR

  module = cirq_to_qir(circuit, name="bell")

  # saves to .ll and .bc files in working directory

  dumps(module)

  print(module)

  ```

  ```output Output theme={null}
  ; ModuleID = 'bell'
  source_filename = "bell"

  %Qubit = type opaque
  %Result = type opaque

  define void @main() #0 {
  entry:
    call void @__quantum__qis__h__body(%Qubit* inttoptr (i64 0 to %Qubit*))
    call void @__quantum__qis__cnot__body(%Qubit* inttoptr (i64 0 to %Qubit*), %Qubit* inttoptr (i64 1 to %Qubit*))
    call void @__quantum__qis__mz__body(%Qubit* inttoptr (i64 0 to %Qubit*), %Result* inttoptr (i64 0 to %Result*))
    call void @__quantum__qis__mz__body(%Qubit* inttoptr (i64 1 to %Qubit*), %Result* inttoptr (i64 1 to %Result*))
    ret void
  }

  declare void @__quantum__qis__h__body(%Qubit*)
  declare void @__quantum__qis__cnot__body(%Qubit*, %Qubit*)
  declare void @__quantum__qis__mz__body(%Qubit*, %Result* writeonly) #1

  attributes #0 = { "entry_point" "output_labeling_schema" "qir_profiles"="custom" "required_num_qubits"="2" "required_num_results"="2" }
  attributes #1 = { "irreversible" }

  !llvm.module.flags = !{!0, !1, !2, !3}
  !0 = !{i32 1, !"qir_major_version", i32 1}
  !1 = !{i32 7, !"qir_minor_version", i32 0}
  !2 = !{i32 1, !"dynamic_qubit_management", i1 false}
  !3 = !{i32 1, !"dynamic_result_management", i1 false}
  ```
</CodeGroup>

### Note

Circuits constructed using qubits of type `cirq.NameQubit` or `cirq.GridQubit` will be transformed to type `cirq.LineQubit` before conversion to QIR.

Execute the QIR program using the [qir-runner](https://github.com/qir-alliance/qir-runner) command line tool:

```bash theme={null}
$ qir-runner -f bell.bc
```

[https://github.com/qBraid/qbraid-qir/tree/main/test-containers](https://github.com/qBraid/qbraid-qir/tree/main/test-containers)