# pytket.utils

```{eval-rst}
.. automodule:: pytket.utils
    :members: expectation_from_shots, expectation_from_counts, get_pauli_expectation_value, get_operator_expectation_value, append_pauli_measurement, counts_from_shot_table, probs_from_counts, probs_from_state, permute_qubits_in_statevector, permute_rows_cols_in_unitary, permute_basis_indexing, gen_term_sequence_circuit, readout_counts, compare_statevectors, compare_unitaries, prepare_circuit
```

```{eval-rst}
.. automodule:: pytket.utils.outcomearray
```

```{eval-rst}
.. autoclass:: pytket.utils.outcomearray.OutcomeArray
    :special-members: __init__
    :members:
```

```{eval-rst}
.. autofunction:: pytket.utils.outcomearray.readout_counts
```

```{eval-rst}
.. automodule:: pytket.utils.operators
```

```{eval-rst}
.. autoclass:: pytket.utils.operators.QubitPauliOperator
    :special-members: __init__
    :members:
```

```{eval-rst}
.. automodule:: pytket.utils.graph
```

```{eval-rst}
.. autoclass:: pytket.utils.graph.Graph
    :special-members: __init__
    :members:
```

## pytket.utils.distribution

```{eval-rst}
.. autoclass:: pytket.utils.distribution.EmpiricalDistribution
    :special-members: __eq__, __getitem__, __add__
    :members:
```

```{eval-rst}
.. autoclass:: pytket.utils.distribution.ProbabilityDistribution
    :special-members: _eq__, __getitem__, __add__, __mul__
    :members:
```

```{eval-rst}
.. automodule:: pytket.utils.distribution
    :members: convex_combination
```

## pytket.utils.expectations

```{eval-rst}
.. automodule:: pytket.utils.expectations
    :members:
```

## pytket.utils.measurements

```{eval-rst}
.. automodule:: pytket.utils.measurements
    :members:
```

## pytket.utils.prepare

```{eval-rst}
.. automodule:: pytket.utils.prepare
    :members:
```

## pytket.utils.results

```{eval-rst}
.. automodule:: pytket.utils.results
    :members:
```

## pytket.utils.serialization.migration

```{eval-rst}
.. automodule:: pytket._tket.utils_serialization
```

```{eval-rst}
.. automodule:: pytket.utils.serialization
```

```{eval-rst}
.. automodule:: pytket.utils.serialization.migration
    :members: circuit_dict_from_pytket1_dict
```

## pytket.utils.spam

```{eval-rst}
.. automodule:: pytket.utils.spam
    :members: compress_counts
```

```{eval-rst}
.. autoclass:: pytket.utils.spam.SpamCorrecter
    :special-members: __init__
    :members:
```

## pytket.utils.stats

```{eval-rst}
.. automodule:: pytket.utils.stats
    :members: gate_counts
```

## pytket.utils.symbolic

```{eval-rst}
.. automodule:: pytket.utils.symbolic
    :members:
    :special-members: SymGateFunc
```

## pytket.utils.term_sequence

```{eval-rst}
.. automodule:: pytket.utils.term_sequence
    :members:
```