<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/quantum/blob/v0.7.6/tensorflow_quantum/python/util.py#L263-L333) |

Convert lists of tfq supported primitives to tensor representations.

    tfq.convert_to_tensor(
        items_to_convert, deterministic_proto_serialize=False
    )

### Used in the notebooks

| Used in the tutorials |
|---|
| - [Hello, many worlds](https://www.tensorflow.org/quantum/tutorials/hello_many_worlds) - [Quantum Convolutional Neural Network](https://www.tensorflow.org/quantum/tutorials/qcnn) - [Calculate gradients](https://www.tensorflow.org/quantum/tutorials/gradients) - [MNIST classification](https://www.tensorflow.org/quantum/tutorials/mnist) - [Quantum data](https://www.tensorflow.org/quantum/tutorials/quantum_data) |

Recursively convert a nested lists of [`cirq.PauliSum`](https://quantumai.google/reference/python/cirq/PauliSum) or [`cirq.Circuit`](https://quantumai.google/reference/python/cirq/Circuit)
objects to a [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor) representation. Note that cirq serialization only
supports [`cirq.GridQubit`](https://quantumai.google/reference/python/cirq/GridQubit)s so we also require that input circuits and
pauli sums are defined only on [`cirq.GridQubit`](https://quantumai.google/reference/python/cirq/GridQubit)s.

    my_qubits = cirq.GridQubit.rect(1, 2)
    my_circuits = [cirq.Circuit(cirq.X(my_qubits[0])),
                   cirq.Circuit(cirq.Z(my_qubits[0]))
    ]
    tensor_input = tfq.convert_to_tensor(my_circuits)
    # Now tensor_input can be used as model input etc.
    same_circuits = tfq.from_tensor(tensor_input)
    # same_circuits now holds cirq.Circuit objects once more.
    same_circuits
    [cirq.Circuit([
        cirq.Moment(operations=[
            cirq.X.on(cirq.GridQubit(0, 0)),
        ]),
    ])
     cirq.Circuit([
        cirq.Moment(operations=[
            cirq.Z.on(cirq.GridQubit(0, 0)),
        ]),
    ])]

<br />

<br />

<br />

| ## Args ||
|---|---|
| `items_to_convert` | Python `list` or nested `list` of [`cirq.Circuit`](https://quantumai.google/reference/python/cirq/Circuit) or `cirq.Paulisum` objects. Must be recangular. |
| `deterministic_proto_serialize` | Whether to use a deterministic serialization when calling SerializeToString(). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor) that represents the input items. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `TypeError` | In case of invalid arguments provided in `items_to_convert`. |

<br />