docs: def allclose_up_to_global_phase(
          a: np.ndarray,
          b: np.ndarray,
          *,
          rtol: float = 1.e-5,
          atol: float = 1.e-8,
          equal_nan: bool = False
  ) -> bool:
      """Determines if a ~= b * exp(i t) for some t.
  
      Args:
          a: A numpy array.
          b: Another numpy array.
          rtol: Relative error tolerance.
          atol: Absolute error tolerance.
          equal_nan: Whether or not NaN entries should be considered equal to
              other NaN entries.
      """
  
      a, b = transformations.match_global_phase(a, b)
  
      # Should now be equivalent.
      return np.allclose(a=a, b=b, rtol=rtol, atol=atol, equal_nan=equal_nan)