cirq.testing.random_unitary

Returns a random unitary matrix distributed with Haar measure.

Main aliases

cirq.testing.lin_alg_utils.random_unitary

cirq.testing.random_unitary(
    dim: int, *, random_state: cirq.RANDOM_STATE_OR_SEED_LIKE = None
) -> np.ndarray

Used in the tutorials
Circuit optimization, gate alignment, and spin echoes

Args
`dim`	The width and height of the matrix.
`random_state`	A seed to use for random number generation.

Returns
The sampled unitary matrix.

References
'How to generate random matrices from the classical compact groups' http://arxiv.org/abs/math-ph/0609050

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-06-30 UTC.

Args