Implement new aliases introduced in NumPy 2.0 - Part II (#2099)

* implement new aliases introduced in NumPy 2.0 * address comments * update linalg.rst
IntelPython · Oct 11, 2024 · bd6562a · bd6562a
1 parent 63e641f
commit bd6562a
Show file tree

Hide file tree

Showing 28 changed files with 1,066 additions and 246 deletions.
diff --git a/doc/known_words.txt b/doc/known_words.txt
@@ -1,4 +1,5 @@
 al
+ary
 backend
 bitwise
 boolean
@@ -31,6 +32,7 @@ Fortran
 Frobenius
 fs
 getter
+Golub
 Hadamard
 Hypergeometric
 iinfo
@@ -51,8 +53,10 @@ ndim
 Nj
 Nk
 normed
+nuc
 Nyquist
 oneAPI
+ord
 orthonormal
 Penrose
 Polyutils

diff --git a/doc/reference/binary.rst b/doc/reference/binary.rst
@@ -1,7 +1,7 @@
-Binary Operations
+Bit-wise operations
 =================
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.bitwise.html
+.. https://numpy.org/doc/stable/reference/routines.bitwise.html
 
 Element-wise bit operations
 ---------------------------
@@ -15,8 +15,12 @@ Element-wise bit operations
    dpnp.bitwise_or
    dpnp.bitwise_xor
    dpnp.invert
+   dpnp.bitwise_invert
    dpnp.left_shift
+   dpnp.bitwise_left_shift
    dpnp.right_shift
+   dpnp.bitwise_right_shift
+   dpnp.bitwise_count
 
 
 Bit packing

diff --git a/doc/reference/creation.rst b/doc/reference/creation.rst
@@ -3,7 +3,7 @@
 Array creation routines
 =======================
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.array-creation.html
+.. https://numpy.org/doc/stable/reference/routines.array-creation.html
 
 From shape or value
 -----------------------

diff --git a/doc/reference/dtype.rst b/doc/reference/dtype.rst
@@ -3,7 +3,7 @@
 Data type routines
 ==================
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.dtype.html
+.. https://numpy.org/doc/stable/reference/routines.dtype.html
 
 .. autosummary::
    :toctree: generated/

diff --git a/doc/reference/fft.rst b/doc/reference/fft.rst
@@ -1,9 +1,7 @@
-.. module:: dpnp.fft
-
 FFT Functions
 =============
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.fft.html
+.. https://numpy.org/doc/stable/reference/routines.fft.html
 
 Standard FFTs
 -------------
@@ -12,12 +10,12 @@ Standard FFTs
    :toctree: generated/
    :nosignatures:
 
-   fft
-   ifft
-   fft2
-   ifft2
-   fftn
-   ifftn
+   dpnp.fft.fft
+   dpnp.fft.ifft
+   dpnp.fft.fft2
+   dpnp.fft.ifft2
+   dpnp.fft.fftn
+   dpnp.fft.ifftn
 
 
 Real FFTs
@@ -27,12 +25,12 @@ Real FFTs
    :toctree: generated/
    :nosignatures:
 
-   rfft
-   irfft
-   rfft2
-   irfft2
-   rfftn
-   irfftn
+   dpnp.fft.rfft
+   dpnp.fft.irfft
+   dpnp.fft.rfft2
+   dpnp.fft.irfft2
+   dpnp.fft.rfftn
+   dpnp.fft.irfftn
 
 
 Hermitian FFTs
@@ -42,8 +40,8 @@ Hermitian FFTs
    :toctree: generated/
    :nosignatures:
 
-   hfft
-   ihfft
+   dpnp.fft.hfft
+   dpnp.fft.ihfft
 
 
 Helper routines
@@ -53,10 +51,10 @@ Helper routines
    :toctree: generated/
    :nosignatures:
 
-   fftfreq
-   rfftfreq
-   fftshift
-   ifftshift
+   dpnp.fft.fftfreq
+   dpnp.fft.rfftfreq
+   dpnp.fft.fftshift
+   dpnp.fft.ifftshift
 
    .. fft.config module is not implemented yet
    .. dpnp.fft.config.set_cufft_callbacks

diff --git a/doc/reference/linalg.rst b/doc/reference/linalg.rst
@@ -1,7 +1,7 @@
 Linear Algebra
 ==============
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.linalg.html
+.. https://numpy.org/doc/stable/reference/routines.linalg.html
 
 Matrix and vector products
 --------------------------
@@ -13,14 +13,19 @@ Matrix and vector products
    dpnp.dot
    dpnp.linalg.multi_dot
    dpnp.vdot
+   dpnp.vecdot
+   dpnp.linalg.vecdot (Array API compatible)
    dpnp.inner
    dpnp.outer
    dpnp.matmul
+   dpnp.linalg.matmul (Array API compatible)
    dpnp.tensordot
+   dpnp.linalg.tensordot (Array API compatible)
    dpnp.einsum
    dpnp.einsum_path
    dpnp.linalg.matrix_power
    dpnp.kron
+   dpnp.linalg.cross (Array API compatible)
 
 Decompositions
 --------------
@@ -55,11 +60,14 @@ Norms and other numbers
    :nosignatures:
 
    dpnp.linalg.norm
+   dpnp.linalg.matrix_norm (Array API compatible)
+   dpnp.linalg.vector_norm (Array API compatible)
    dpnp.linalg.cond
    dpnp.linalg.det
    dpnp.linalg.matrix_rank
    dpnp.linalg.slogdet
    dpnp.trace
+   dpnp.linalg.trace (Array API compatible)
 
 
 Solving linear equations
@@ -75,3 +83,19 @@ Solving linear equations
    dpnp.linalg.inv
    dpnp.linalg.pinv
    dpnp.linalg.tensorinv
+
+Other matrix operations
+-----------------------
+.. autosummary::
+   :toctree: generated/
+
+   dpnp.diagonal
+   dpnp.linalg.diagonal (Array API compatible)
+   dpnp.linalg.matrix_tranpose (Array API compatible)
+
+Exceptions
+----------
+.. autosummary::
+   :toctree: generated/
+
+   dpnp.linalg.linAlgError
diff --git a/doc/reference/logic.rst b/doc/reference/logic.rst
@@ -1,7 +1,7 @@
 Logic Functions
 ===============
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.logic.html
+.. https://numpy.org/doc/stable/reference/routines.logic.html
 
 Truth value testing
 -------------------

diff --git a/doc/reference/manipulation.rst b/doc/reference/manipulation.rst
@@ -1,7 +1,7 @@
 Array Manipulation Routines
 ===========================
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.array-manipulation.html
+.. https://numpy.org/doc/stable/reference/routines.array-manipulation.html
 
 Basic operations
 ----------------

diff --git a/doc/reference/math.rst b/doc/reference/math.rst
@@ -1,7 +1,7 @@
 Mathematical functions
 ======================
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.math.html
+.. https://numpy.org/doc/stable/reference/routines.math.html
 
 Trigonometric functions
 -----------------------

diff --git a/doc/reference/misc.rst b/doc/reference/misc.rst
@@ -1,7 +1,7 @@
 Miscellaneous routines
 ======================
 
-.. https://docs.scipy.org/doc/numpy/reference/routines.other.html
+.. https://numpy.org/doc/stable/reference/routines.other.html
 
 Utility
 -------
@@ -13,6 +13,4 @@ Utility
    dpnp.get_include
    dpnp.show_config
    dpnp.show_runtime
-   dpnp.deprecate
-   dpnp.deprecate_with_doc
    dpnp.broadcast_shapes
diff --git a/doc/reference/pad.rst b/doc/reference/pad.rst
diff --git a/doc/reference/random.rst b/doc/reference/random.rst
@@ -1,9 +1,7 @@
-.. module:: dpnp.random
-
 Random Sampling (``dpnp.random``)
 =================================
 
-.. https://docs.scipy.org/doc/numpy/reference/random/legacy.html
+.. https://numpy.org/doc/stable/reference/random/legacy.html
 
 
 Simple random data
@@ -13,16 +11,16 @@ Simple random data
    :toctree: generated/
    :nosignatures:
 
-   rand
-   randn
-   randint
-   random_integers
-   random_sample
-   random
-   ranf
-   sample
-   choice
-   bytes
+   dpnp.random.rand
+   dpnp.random.randn
+   dpnp.random.randint
+   dpnp.random.random_integers
+   dpnp.random.random_sample
+   dpnp.random.random
+   dpnp.random.ranf
+   dpnp.random.sample
+   dpnp.random.choice
+   dpnp.random.bytes
 
 
 Permutations
@@ -32,8 +30,8 @@ Permutations
    :toctree: generated/
    :nosignatures:
 
-   shuffle
-   permutation
+   dpnp.random.shuffle
+   dpnp.random.permutation
 
 
 Distributions
@@ -43,41 +41,41 @@ Distributions
    :toctree: generated/
    :nosignatures:
 
-   beta
-   binomial
-   chisquare
-   dirichlet
-   exponential
-   f
-   gamma
-   geometric
-   gumbel
-   hypergeometric
-   laplace
-   logistic
-   lognormal
-   logseries
-   multinomial
-   multivariate_normal
-   negative_binomial
-   noncentral_chisquare
-   noncentral_f
-   normal
-   pareto
-   poisson
-   power
-   rayleigh
-   standard_cauchy
-   standard_exponential
-   standard_gamma
-   standard_normal
-   standard_t
-   triangular
-   uniform
-   vonmises
-   wald
-   weibull
-   zipf
+   dpnp.random.beta
+   dpnp.random.binomial
+   dpnp.random.chisquare
+   dpnp.random.dirichlet
+   dpnp.random.exponential
+   dpnp.random.f
+   dpnp.random.gamma
+   dpnp.random.geometric
+   dpnp.random.gumbel
+   dpnp.random.hypergeometric
+   dpnp.random.laplace
+   dpnp.random.logistic
+   dpnp.random.lognormal
+   dpnp.random.logseries
+   dpnp.random.multinomial
+   dpnp.random.multivariate_normal
+   dpnp.random.negative_binomial
+   dpnp.random.noncentral_chisquare
+   dpnp.random.noncentral_f
+   dpnp.random.normal
+   dpnp.random.pareto
+   dpnp.random.poisson
+   dpnp.random.power
+   dpnp.random.rayleigh
+   dpnp.random.standard_cauchy
+   dpnp.random.standard_exponential
+   dpnp.random.standard_gamma
+   dpnp.random.standard_normal
+   dpnp.random.standard_t
+   dpnp.random.triangular
+   dpnp.random.uniform
+   dpnp.random.vonmises
+   dpnp.random.wald
+   dpnp.random.weibull
+   dpnp.random.zipf
 
 
 Random generator
@@ -87,7 +85,7 @@ Random generator
    :toctree: generated/
    :nosignatures:
 
-   RandomState
-   seed
-   get_random_state
-   set_random_state
+   dpnp.random.RandomState
+   dpnp.random.seed
+   dpnp.random.get_random_state
+   dpnp.random.set_random_state