🎨 optype 0.8 simplifications (#382)

Author: jorenham

scipy-stubs/linalg/_matfuncs.pyi

@@ -3,7 +3,6 @@ from typing import Any, Literal, TypeAlias, overload
 
 import numpy as np
 import optype.numpy as onp
-import optype.typing as opt
 from ._expm_frechet import expm_cond, expm_frechet
 from ._matfuncs_sqrtm import sqrtm
 
@@ -52,7 +51,7 @@ def fractional_matrix_power(A: onp.ToFloat2D, t: onp.ToInt) -> _Real2D: ...
 @overload  # complex, int
 def fractional_matrix_power(A: onp.ToComplex2D, t: onp.ToInt) -> _Numeric2D: ...
 @overload  # complex, float
-def fractional_matrix_power(A: onp.ToComplex2D, t: opt.Just[float] | np.floating[Any]) -> _Complex2D: ...
+def fractional_matrix_power(A: onp.ToComplex2D, t: onp.ToJustFloat) -> _Complex2D: ...
 
 # NOTE: return dtype depends on the sign of the values
 @overload  # disp: True = ...

scipy-stubs/linalg/_sketches.pyi

@@ -1,39 +1,28 @@
-from collections.abc import Sequence
-from typing import Any, TypeAlias, TypeVar, overload
+from typing import overload
 
 import numpy as np
 import optype.numpy as onp
-import optype.typing as opt
-import scipy._typing as spt
+from scipy._typing import ToRNG
 from scipy.sparse import csc_matrix
 
 __all__ = ["clarkson_woodruff_transform"]
 
-_ST = TypeVar("_ST", bound=np.generic)
-_VT = TypeVar("_VT")
-
-_ToJust2D: TypeAlias = onp.CanArrayND[_ST] | Sequence[onp.CanArrayND[_ST]] | Sequence[Sequence[opt.Just[_VT] | _ST]]
-
 ###
 
-def cwt_matrix(n_rows: onp.ToInt, n_columns: onp.ToInt, rng: spt.ToRNG = None) -> csc_matrix: ...
+def cwt_matrix(n_rows: onp.ToInt, n_columns: onp.ToInt, rng: ToRNG = None) -> csc_matrix: ...
 
 #
 @overload
-def clarkson_woodruff_transform(
-    input_matrix: onp.ToInt2D,
-    sketch_size: onp.ToInt,
-    rng: spt.ToRNG = None,
-) -> onp.Array2D[np.int_]: ...
+def clarkson_woodruff_transform(input_matrix: onp.ToInt2D, sketch_size: onp.ToInt, rng: ToRNG = None) -> onp.Array2D[np.int_]: ...
 @overload
 def clarkson_woodruff_transform(
-    input_matrix: _ToJust2D[np.floating[Any], float],
+    input_matrix: onp.ToJustFloat2D,
     sketch_size: onp.ToInt,
-    rng: spt.ToRNG = None,
+    rng: ToRNG = None,
 ) -> onp.Array2D[np.float64 | np.longdouble]: ...
 @overload
 def clarkson_woodruff_transform(
-    input_matrix: _ToJust2D[np.complexfloating[Any, Any], complex],
+    input_matrix: onp.ToJustComplex2D,
     sketch_size: onp.ToInt,
-    rng: spt.ToRNG = None,
+    rng: ToRNG = None,
 ) -> onp.Array2D[np.complex64 | np.clongdouble]: ...

scipy-stubs/linalg/_special_matrices.pyi

@@ -25,7 +25,6 @@ from ._typing import (
     Float,
     Index1D,
     Int,
-    Matrix,
     Scalar,
     Shape,
     ShapeCOO,
@@ -161,12 +160,12 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # dense array-like int
     def __init__(self: _spbase[np.int_], /, arg1: _ToSparseFromPy[opt.JustInt], *, maxprint: int | None = 50) -> None: ...
     @overload  # dense array-like float
-    def __init__(self: _spbase[np.float64], /, arg1: _ToSparseFromPy[opt.Just[float]], *, maxprint: int | None = 50) -> None: ...
+    def __init__(self: _spbase[np.float64], /, arg1: _ToSparseFromPy[opt.JustFloat], *, maxprint: int | None = 50) -> None: ...
     @overload  # dense array-like cfloat
     def __init__(
         self: _spbase[np.complex128],
         /,
-        arg1: _ToSparseFromPy[opt.Just[complex]],
+        arg1: _ToSparseFromPy[opt.JustComplex],
         *,
         maxprint: int | None = 50,
     ) -> None: ...
@@ -272,11 +271,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # sparse[-Complex], sparse[+Complex64]
     def __add__(self: _SpFromComplexT, other: _spbase[_ToComplex64], /) -> _SpFromComplexT: ...
     @overload  # spmatrix[-Int], array[+Int8]
-    def __add__(self: spmatrix[_FromInt], other: onp.ArrayND[_ToInt8], /) -> Matrix[_SCT_co]: ...
+    def __add__(self: spmatrix[_FromInt], other: onp.ArrayND[_ToInt8], /) -> onp.Matrix[_SCT_co]: ...
     @overload  # spmatrix[-Float], array[+Float32]
-    def __add__(self: spmatrix[_FromFloat], other: onp.ArrayND[_ToFloat32], /) -> Matrix[_SCT_co]: ...
+    def __add__(self: spmatrix[_FromFloat], other: onp.ArrayND[_ToFloat32], /) -> onp.Matrix[_SCT_co]: ...
     @overload  # spmatrix[-Complex], array[+Complex64]
-    def __add__(self: spmatrix[_FromComplex], other: onp.ArrayND[_ToComplex64], /) -> Matrix[_SCT_co]: ...
+    def __add__(self: spmatrix[_FromComplex], other: onp.ArrayND[_ToComplex64], /) -> onp.Matrix[_SCT_co]: ...
     @overload  # sparse[-Int], array[+Int8]
     def __add__(self: _spbase[_FromInt], other: onp.ArrayND[_ToInt8], /) -> onp.ArrayND[_SCT_co, _ShapeT_co]: ...
     @overload  # sparse[-Float], array[+Float32]
@@ -297,11 +296,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # sparse[-Complex], sparse[+Complex64]
     def __sub__(self: _SpFromComplexT, other: _spbase[_ToComplex64], /) -> _SpFromComplexT: ...
     @overload  # spmatrix[-Int], array[+Int8]
-    def __sub__(self: spmatrix[_FromInt], other: onp.ArrayND[_ToInt8], /) -> Matrix[_SCT_co]: ...
+    def __sub__(self: spmatrix[_FromInt], other: onp.ArrayND[_ToInt8], /) -> onp.Matrix[_SCT_co]: ...
     @overload  # spmatrix[-Float], array[+Float32]
-    def __sub__(self: spmatrix[_FromFloat], other: onp.ArrayND[_ToFloat32], /) -> Matrix[_SCT_co]: ...
+    def __sub__(self: spmatrix[_FromFloat], other: onp.ArrayND[_ToFloat32], /) -> onp.Matrix[_SCT_co]: ...
     @overload  # spmatrix[-Complex], array[+Complex64]
-    def __sub__(self: spmatrix[_FromComplex], other: onp.ArrayND[_ToComplex64], /) -> Matrix[_SCT_co]: ...
+    def __sub__(self: spmatrix[_FromComplex], other: onp.ArrayND[_ToComplex64], /) -> onp.Matrix[_SCT_co]: ...
     @overload  # sparse[-Int], array[+Int8]
     def __sub__(self: _spbase[_FromInt], other: onp.ArrayND[_ToInt8], /) -> onp.ArrayND[_SCT_co, _ShapeT_co]: ...
     @overload  # sparse[-Float], array[+Float32]
@@ -360,13 +359,13 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # spmatrix[+Bool], /, other: array-like ~Int
     def __mul__(self: spmatrix[_ToBool], /, other: _DualArrayLike2d[opt.JustInt, Int]) -> onp.Array2D[Int]: ...
     @overload  # spmatrix[+Int], /, other: scalar- or matrix-like ~Float
-    def __mul__(self: spmatrix[_ToInt], /, other: _DualMatrixLike[opt.Just[float], Float]) -> spmatrix[Float]: ...
+    def __mul__(self: spmatrix[_ToInt], /, other: _DualMatrixLike[opt.JustFloat, Float]) -> spmatrix[Float]: ...
     @overload  # spmatrix[+Int], /, other: array-like ~Float
-    def __mul__(self: spmatrix[_ToInt], /, other: _DualArrayLike2d[opt.Just[float], Float]) -> onp.Array2D[Float]: ...
+    def __mul__(self: spmatrix[_ToInt], /, other: _DualArrayLike2d[opt.JustFloat, Float]) -> onp.Array2D[Float]: ...
     @overload  # spmatrix[+Float], /, other: scalar- or matrix-like ~Complex
-    def __mul__(self: spmatrix[_ToFloat], /, other: _DualMatrixLike[opt.Just[complex], Complex]) -> spmatrix[Complex]: ...
+    def __mul__(self: spmatrix[_ToFloat], /, other: _DualMatrixLike[opt.JustComplex, Complex]) -> spmatrix[Complex]: ...
     @overload  # spmatrix[+Float], /, other: array-like ~Complex
-    def __mul__(self: spmatrix[_ToFloat], /, other: _DualArrayLike2d[opt.Just[complex], Complex]) -> onp.Array2D[Complex]: ...
+    def __mul__(self: spmatrix[_ToFloat], /, other: _DualArrayLike2d[opt.JustComplex, Complex]) -> onp.Array2D[Complex]: ...
     @overload  # Self[+Bool], /, other: -Int
     def __mul__(self: _spbase[_ToBool], /, other: _FromIntT) -> _spbase[_FromIntT, _ShapeT_co]: ...
     @overload  # Self[+Int], /, other: -Float
@@ -424,11 +423,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # spmatrix[+Int], other: scalar- or matrix-like ~Float
     def __matmul__(self: spmatrix[_ToInt], other: _spbase[Float], /) -> _SpMatrixOut[Float]: ...
     @overload  # spmatrix[+Int], other: array-like ~Float
-    def __matmul__(self: spmatrix[_ToInt], other: _DualArrayLike2d[opt.Just[float], Float], /) -> onp.Array2D[Float]: ...
+    def __matmul__(self: spmatrix[_ToInt], other: _DualArrayLike2d[opt.JustFloat, Float], /) -> onp.Array2D[Float]: ...
     @overload  # spmatrix[+Float], other: scalar- or matrix-like ~Complex
     def __matmul__(self: spmatrix[_ToFloat], other: _spbase[Complex], /) -> _SpMatrixOut[Complex]: ...
     @overload  # spmatrix[+Float], other: array-like ~Complex
-    def __matmul__(self: spmatrix[_ToFloat], other: _DualArrayLike2d[opt.Just[complex], Complex], /) -> onp.Array2D[Complex]: ...
+    def __matmul__(self: spmatrix[_ToFloat], other: _DualArrayLike2d[opt.JustComplex, Complex], /) -> onp.Array2D[Complex]: ...
     @overload  # catch-all
     def __matmul__(self, other: _DualArrayLike[complex, Scalar] | _spbase, /) -> _spbase[Any, Any] | onp.Array[Any, Any]: ...
     __rmatmul__ = __matmul__
@@ -449,11 +448,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload
     def __truediv__(self: spmatrix, rhs: onp.ArrayND[Scalar], /) -> coo_matrix[np.int_ | _FromFloat]: ...
     @overload
-    def __truediv__(self: spmatrix, rhs: _spbase[_FromComplex], /) -> Matrix[_FromComplex]: ...
+    def __truediv__(self: spmatrix, rhs: _spbase[_FromComplex], /) -> onp.Matrix[_FromComplex]: ...
     @overload
-    def __truediv__(self: spmatrix, rhs: _spbase[_FromFloat], /) -> Matrix[_FromFloat]: ...
+    def __truediv__(self: spmatrix, rhs: _spbase[_FromFloat], /) -> onp.Matrix[_FromFloat]: ...
     @overload
-    def __truediv__(self: spmatrix, rhs: _spbase, /) -> Matrix[np.int_ | _FromFloat]: ...
+    def __truediv__(self: spmatrix, rhs: _spbase, /) -> onp.Matrix[np.int_ | _FromFloat]: ...
     @overload
     def __truediv__(self, rhs: _spbase[_FromComplex], /) -> onp.ArrayND[_FromComplex, _ShapeT_co]: ...
     @overload
@@ -477,9 +476,9 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # spmatrix[+Bool], /, other: scalar-like ~Int
     def dot(self: spmatrix[_ToBool], /, other: opt.JustInt) -> spmatrix[Int]: ...
     @overload  # spmatrix[+Int], /, other: scalar-like ~Float
-    def dot(self: spmatrix[_ToInt], /, other: opt.Just[float]) -> spmatrix[Float]: ...
+    def dot(self: spmatrix[_ToInt], /, other: opt.JustFloat) -> spmatrix[Float]: ...
     @overload  # spmatrix[+Float], /, other: scalar-like ~Complex
-    def dot(self: spmatrix[_ToFloat], /, other: opt.Just[complex]) -> spmatrix[Complex]: ...
+    def dot(self: spmatrix[_ToFloat], /, other: opt.JustComplex) -> spmatrix[Complex]: ...
     @overload  # sparray[-Bool], /, other: sparse +Bool
     def dot(self: _SpArray, /, other: _spbase[_ToBool | _SCT_co]) -> _SpArrayOut[_SCT_co]: ...
     @overload  # sparray[-Bool], /, other: array-like +Bool
@@ -521,11 +520,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # spmatrix[+Int], /, other: scalar- or matrix-like ~Float
     def dot(self: spmatrix[_ToInt], /, other: _spbase[Float]) -> _SpMatrixOut[Float]: ...
     @overload  # spmatrix[+Int], /, other: array-like ~Float
-    def dot(self: spmatrix[_ToInt], /, other: _DualArrayLike2d[opt.Just[float], Float]) -> onp.Array2D[Float]: ...
+    def dot(self: spmatrix[_ToInt], /, other: _DualArrayLike2d[opt.JustFloat, Float]) -> onp.Array2D[Float]: ...
     @overload  # spmatrix[+Float], /, other: scalar- or matrix-like ~Complex
     def dot(self: spmatrix[_ToFloat], /, other: _spbase[Complex]) -> _SpMatrixOut[Complex]: ...
     @overload  # spmatrix[+Float], /, other: array-like ~Complex
-    def dot(self: spmatrix[_ToFloat], /, other: _DualArrayLike2d[opt.Just[complex], Complex]) -> onp.Array2D[Complex]: ...
+    def dot(self: spmatrix[_ToFloat], /, other: _DualArrayLike2d[opt.JustComplex, Complex]) -> onp.Array2D[Complex]: ...
     @overload  # catch-all
     def dot(self, /, other: _DualArrayLike[complex, Scalar] | _spbase) -> _spbase[Any, Any] | onp.Array[Any, Any]: ...
 
@@ -551,7 +550,7 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # sparray, dense
     def maximum(self: sparray, /, other: onp.ArrayND[_SCT]) -> onp.ArrayND[_SCT_co | _SCT, _ShapeT_co]: ...
     @overload  # spmatrix, dense
-    def maximum(self: spmatrix, /, other: onp.ArrayND[_SCT]) -> Matrix[_SCT_co | _SCT]: ...
+    def maximum(self: spmatrix, /, other: onp.ArrayND[_SCT]) -> onp.Matrix[_SCT_co | _SCT]: ...
     @overload  # sparray, unknown scalar
     def maximum(self: sparray, /, other: onp.ToComplex) -> _SpArrayOut[Any]: ...
     @overload  # spmatrix, unknown scalar
@@ -579,7 +578,7 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # sparray, dense
     def minimum(self: sparray, /, other: onp.ArrayND[_SCT]) -> onp.ArrayND[_SCT_co | _SCT, _ShapeT_co]: ...
     @overload  # spmatrix, dense
-    def minimum(self: spmatrix, /, other: onp.ArrayND[_SCT]) -> Matrix[_SCT_co | _SCT]: ...
+    def minimum(self: spmatrix, /, other: onp.ArrayND[_SCT]) -> onp.Matrix[_SCT_co | _SCT]: ...
     @overload  # sparray, unknown scalar
     def minimum(self: sparray, /, other: onp.ToComplex) -> _SpArrayOut[Any]: ...
     @overload  # spmatrix, unknown scalar
@@ -622,7 +621,7 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
     @overload  # sparray[-Bool, 2d], axis: index
     def sum(self: _SpArray2D[np.bool_], /, axis: op.CanIndex, dtype: None = None, out: None = None) -> onp.Array1D[np.int_]: ...
     @overload  # spmatrix[-Bool], axis: index
-    def sum(self: spmatrix[np.bool_], /, axis: op.CanIndex, dtype: None = None, out: None = None) -> Matrix[np.int_]: ...
+    def sum(self: spmatrix[np.bool_], /, axis: op.CanIndex, dtype: None = None, out: None = None) -> onp.Matrix[np.int_]: ...
     @overload  # Self[-Int]
     def sum(self: _spbase[_FromIntT], /, axis: None = None, dtype: None = None, out: None = None) -> _FromIntT: ...
     @overload  # sparray[-Int, 1d], axis: index
@@ -642,9 +641,9 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
         out: None = None,
     ) -> onp.Array1D[_FromIntT]: ...
     @overload  # spmatrix[-Int], axis: index
-    def sum(self: spmatrix[_FromIntT], /, axis: op.CanIndex, dtype: None = None, out: None = None) -> Matrix[_FromIntT]: ...
+    def sum(self: spmatrix[_FromIntT], /, axis: op.CanIndex, dtype: None = None, out: None = None) -> onp.Matrix[_FromIntT]: ...
     @overload  # spmatrix, axis: index, dtype: <unknown>
-    def sum(self: spmatrix, /, axis: op.CanIndex, dtype: npt.DTypeLike, out: None = None) -> Matrix[Any]: ...
+    def sum(self: spmatrix, /, axis: op.CanIndex, dtype: npt.DTypeLike, out: None = None) -> onp.Matrix[Any]: ...
     @overload  # dtype: <unknown>  (keyword)
     def sum(self, /, axis: op.CanIndex | None = None, *, dtype: npt.DTypeLike, out: None = None) -> Any: ...  # noqa: ANN401
 
@@ -680,7 +679,7 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
         axis: op.CanIndex,
         dtype: None = None,
         out: None = None,
-    ) -> Matrix[np.float64]: ...
+    ) -> onp.Matrix[np.float64]: ...
     @overload  # sparray[-Float, 1d]
     def mean(
         self: _SpArray1D[_FromFloatT],
@@ -698,9 +697,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
         out: None = None,
     ) -> onp.Array1D[_FromFloatT]: ...
     @overload  # spmatrix[-Float], axis: index
-    def mean(self: spmatrix[_FromFloatT], /, axis: op.CanIndex, dtype: None = None, out: None = None) -> Matrix[_FromFloatT]: ...
+    def mean(
+        self: spmatrix[_FromFloatT], /, axis: op.CanIndex, dtype: None = None, out: None = None
+    ) -> onp.Matrix[_FromFloatT]: ...
     @overload  # spmatrix, axis: index, dtype: <unknown>
-    def mean(self: spmatrix, /, axis: op.CanIndex, dtype: npt.DTypeLike, out: None = None) -> Matrix[Any]: ...
+    def mean(self: spmatrix, /, axis: op.CanIndex, dtype: npt.DTypeLike, out: None = None) -> onp.Matrix[Any]: ...
     @overload  # dtype: <unknown>  (keyword)
     def mean(self, /, axis: op.CanIndex | None = None, *, dtype: npt.DTypeLike, out: None = None) -> Any: ...  # noqa: ANN401
 
@@ -925,11 +926,11 @@ class _spbase(Generic[_SCT_co, _ShapeT_co]):
 
     #
     @overload  # self: spmatrix, out: None
-    def todense(self: spmatrix, /, order: OrderCF | None = None, out: None = None) -> Matrix[_SCT_co]: ...
+    def todense(self: spmatrix, /, order: OrderCF | None = None, out: None = None) -> onp.Matrix[_SCT_co]: ...
     @overload  # self: spmatrix, out: array (positional)
-    def todense(self: spmatrix, /, order: OrderCF | None, out: onp.ArrayND[_SCT]) -> Matrix[_SCT]: ...
+    def todense(self: spmatrix, /, order: OrderCF | None, out: onp.ArrayND[_SCT]) -> onp.Matrix[_SCT]: ...
     @overload  # self: spmatrix, out: array (keyword)
-    def todense(self: spmatrix, /, order: OrderCF | None = None, *, out: onp.ArrayND[_SCT]) -> Matrix[_SCT]: ...
+    def todense(self: spmatrix, /, order: OrderCF | None = None, *, out: onp.ArrayND[_SCT]) -> onp.Matrix[_SCT]: ...
     @overload  # out: None
     def todense(self, /, order: OrderCF | None = None, out: None = None) -> onp.Array[_ShapeT_co, _SCT_co]: ...
     @overload  # out: array (positional)

scipy-stubs/sparse/_base.pyi

@@ -92,9 +92,9 @@ class _bsr_base(_cs_matrix[_SCT, tuple[int, int]], _minmax_mixin[_SCT, tuple[int
     def __init__(
         self: _bsr_base[np.float64],
         /,
-        arg1: _ToMatrixPy[opt.Just[float]],
+        arg1: _ToMatrixPy[opt.JustFloat],
         shape: ToShape2d | None = None,
-        dtype: type[opt.Just[float]] | onp.AnyFloat64DType | None = None,
+        dtype: type[opt.JustFloat] | onp.AnyFloat64DType | None = None,
         copy: bool = False,
         blocksize: tuple[int, int] | None = None,
         *,
@@ -104,9 +104,9 @@ class _bsr_base(_cs_matrix[_SCT, tuple[int, int]], _minmax_mixin[_SCT, tuple[int
     def __init__(
         self: _bsr_base[np.complex128],
         /,
-        arg1: _ToMatrixPy[opt.Just[complex]],
+        arg1: _ToMatrixPy[opt.JustComplex],
         shape: ToShape2d | None = None,
-        dtype: type[opt.Just[complex]] | onp.AnyComplex128DType | None = None,
+        dtype: type[opt.JustComplex] | onp.AnyComplex128DType | None = None,
         copy: bool = False,
         blocksize: tuple[int, int] | None = None,
         *,

scipy-stubs/sparse/_bsr.pyi

@@ -184,7 +184,7 @@ class _cs_matrix(
     def __init__(
         self: _cs_matrix[np.float64, tuple[int]],
         /,
-        arg1: Sequence[opt.Just[float]],
+        arg1: Sequence[opt.JustFloat],
         shape: ToShape1dNd | None = None,
         dtype: ToDTypeFloat | None = None,
         copy: bool = False,
@@ -195,7 +195,7 @@ class _cs_matrix(
     def __init__(
         self: _cs_matrix[np.float64, tuple[int, int]],
         /,
-        arg1: Sequence[Sequence[opt.Just[float]]],
+        arg1: Sequence[Sequence[opt.JustFloat]],
         shape: ToShape1dNd | None = None,
         dtype: ToDTypeFloat | None = None,
         copy: bool = False,
@@ -206,7 +206,7 @@ class _cs_matrix(
     def __init__(
         self: _cs_matrix[np.complex128, tuple[int]],
         /,
-        arg1: Sequence[opt.Just[complex]],
+        arg1: Sequence[opt.JustComplex],
         shape: ToShape1dNd | None = None,
         dtype: ToDTypeComplex | None = None,
         copy: bool = False,
@@ -217,7 +217,7 @@ class _cs_matrix(
     def __init__(
         self: _cs_matrix[np.complex128, tuple[int, int]],
         /,
-        arg1: Sequence[Sequence[opt.Just[complex]]],
+        arg1: Sequence[Sequence[opt.JustComplex]],
         shape: ToShape1dNd | None = None,
         dtype: ToDTypeComplex | None = None,
         copy: bool = False,