Merge branch 'develop' into blas/glastidxofrow

Author: headlessNode

docs/migration-guides/numpy/data/numpy_2_4.csv

@@ -153,13 +153,13 @@ eye,(planned)
 f2py,N/A
 fabs,(planned)
 fft,(planned)
-fill_diagonal,(planned)
+fill_diagonal,@stdlib/ndarray/fill-diagonal
 finfo,(planned)
 fix,N/A
 flatiter,(planned)
 flatnonzero,(planned)
 flexible,N/A
-flip,(planned)
+flip,@stdlib/ndarray/reverse-dimensions
 fliplr,@stdlib/ndarray/fliplr
 flipud,@stdlib/ndarray/flipud
 float16,@stdlib/ndarray/dtypes
@@ -178,7 +178,7 @@ frexp,(planned)
 from_dlpack,(planned)
 frombuffer,N/A
 fromfile,(planned)
-fromfunction,(planned)
+fromfunction,@stdlib/ndarray/full-by
 fromiter,(planned)
 frompyfunc,(planned)
 fromregex,(planned)
@@ -212,7 +212,7 @@ i0,(planned)
 identity,(planned)
 iinfo,(planned)
 imag,(planned)
-in1d,(planned)
+in1d,N/A
 index_exp,N/A
 indices,(planned)
 inexact,N/A
@@ -259,9 +259,9 @@ less,(planned)
 less_equal,(planned)
 lexsort,(planned)
 lib,N/A
-linalg,(planned)
+linalg,N/A
 linspace,@stdlib/blas/ext/linspace
-little_endian,N/A
+little_endian,@stdlib/assert/is-little-endian
 load,(planned)
 loadtxt,(planned)
 log,(planned)
@@ -282,7 +282,7 @@ ma,(planned)
 mask_indices,(planned)
 matmul,(planned)
 matrix,(planned)
-matrix_transpose,(planned)
+matrix_transpose,@stdlib/ndarray/transpose
 max,@stdlib/stats/max
 maximum,(planned)
 may_share_memory,(planned)

lib/node_modules/@stdlib/array/base/accessors/README.md

@@ -115,7 +115,7 @@ console.log( 'Accessor protocol: %s', bool );
 
 // Retrieve an array element:
 var v = obj.accessors[ 0 ]( x, 1 );
-// returns <Complex64>
+// returns <Complex64>[ 2.0, 3.0 ]
 
 console.log( 'x[1] = %s', v.toString() );
 ```

lib/node_modules/@stdlib/array/base/accessors/docs/types/index.d.ts

@@ -761,7 +761,7 @@ declare function accessors( x: Uint8ClampedArray ): Uint8cAccessorObject;
 * // returns [ <Function>, <Function> ]
 *
 * var v = fcns[ 0 ]( x, 1 );
-* // returns <Complex128>
+* // returns <Complex128>[ 3.0, 4.0 ]
 */
 declare function accessors( x: Complex128Array ): Complex128AccessorObject;
 
@@ -789,7 +789,7 @@ declare function accessors( x: Complex128Array ): Complex128AccessorObject;
 * // returns [ <Function>, <Function> ]
 *
 * var v = fcns[ 0 ]( x, 1 );
-* // returns <Complex64>
+* // returns <Complex64>[ 3.0, 4.0 ]
 */
 declare function accessors( x: Complex64Array ): Complex64AccessorObject;
 

lib/node_modules/@stdlib/array/base/arraylike2object/docs/types/index.d.ts

@@ -650,7 +650,7 @@ interface GetSetAccessorObject<T> {
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Float64Array ): Float64AccessorObject;
@@ -678,7 +678,7 @@ declare function arraylike2object( x: Float64Array ): Float64AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Float32Array ): Float32AccessorObject;
@@ -706,7 +706,7 @@ declare function arraylike2object( x: Float32Array ): Float32AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Int32Array ): Int32AccessorObject;
@@ -734,7 +734,7 @@ declare function arraylike2object( x: Int32Array ): Int32AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Int16Array ): Int16AccessorObject;
@@ -762,7 +762,7 @@ declare function arraylike2object( x: Int16Array ): Int16AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Int8Array ): Int8AccessorObject;
@@ -790,7 +790,7 @@ declare function arraylike2object( x: Int8Array ): Int8AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Uint32Array ): Uint32AccessorObject;
@@ -818,7 +818,7 @@ declare function arraylike2object( x: Uint32Array ): Uint32AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Uint16Array ): Uint16AccessorObject;
@@ -846,7 +846,7 @@ declare function arraylike2object( x: Uint16Array ): Uint16AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Uint8Array ): Uint8AccessorObject;
@@ -874,7 +874,7 @@ declare function arraylike2object( x: Uint8Array ): Uint8AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object( x: Uint8ClampedArray ): Uint8cAccessorObject;
@@ -903,7 +903,7 @@ declare function arraylike2object( x: Uint8ClampedArray ): Uint8cAccessorObject;
 * // returns [ <Function>, <Function> ]
 *
 * var v = fcns[ 0 ]( x, 1 );
-* // returns <Complex128>
+* // returns <Complex128>[ 3.0, 4.0 ]
 */
 declare function arraylike2object( x: Complex128Array ): Complex128AccessorObject;
 
@@ -931,7 +931,7 @@ declare function arraylike2object( x: Complex128Array ): Complex128AccessorObjec
 * // returns [ <Function>, <Function> ]
 *
 * var v = fcns[ 0 ]( x, 1 );
-* // returns <Complex64>
+* // returns <Complex64>[ 3.0, 4.0 ]
 */
 declare function arraylike2object( x: Complex64Array ): Complex64AccessorObject;
 
@@ -968,7 +968,7 @@ declare function arraylike2object( x: Complex64Array ): Complex64AccessorObject;
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object<T = unknown>( x: AccessorArrayLike<T> ): GetSetAccessorObject<T>;
@@ -994,7 +994,7 @@ declare function arraylike2object<T = unknown>( x: AccessorArrayLike<T> ): GetSe
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object<T = unknown>( x: Array<T> ): GenericAccessorObject<T>;
@@ -1026,7 +1026,7 @@ declare function arraylike2object<T = unknown>( x: Array<T> ): GenericAccessorOb
 * var fcns = obj.accessors;
 * // returns [ <Function>, <Function> ]
 *
-* var v = fcns[ 0 ]( x.data, 2 );
+* var v = fcns[ 0 ]( x, 2 );
 * // returns 3
 */
 declare function arraylike2object<T = unknown>( x: Collection<T> ): IndexedAccessorObject<T>;

lib/node_modules/@stdlib/blas/base/ndarray/README.md

@@ -47,6 +47,7 @@ The namespace exposes the following APIs:
 
 -   <span class="signature">[`caxpy( arrays )`][@stdlib/blas/base/ndarray/caxpy]</span><span class="delimiter">: </span><span class="description">multiply a one-dimensional single-precision complex floating-point ndarray `x` by a constant `alpha` and add the result to a one-dimensional single-precision complex floating-point ndarray `y`.</span>
 -   <span class="signature">[`ccopy( arrays )`][@stdlib/blas/base/ndarray/ccopy]</span><span class="delimiter">: </span><span class="description">copy values from a one-dimensional single-precision complex floating-point ndarray `x` into a one-dimensional single-precision complex floating-point ndarray `y`.</span>
+-   <span class="signature">[`cscal( arrays )`][@stdlib/blas/base/ndarray/cscal]</span><span class="delimiter">: </span><span class="description">multiply a one-dimensional single-precision complex floating-point ndarray by a scalar constant.</span>
 -   <span class="signature">[`cswap( arrays )`][@stdlib/blas/base/ndarray/cswap]</span><span class="delimiter">: </span><span class="description">interchange two one-dimensional single-precision complex floating-point ndarrays.</span>
 -   <span class="signature">[`dasum( arrays )`][@stdlib/blas/base/ndarray/dasum]</span><span class="delimiter">: </span><span class="description">calculate the sum of absolute values for all elements in a one-dimensional double-precision floating-point ndarray.</span>
 -   <span class="signature">[`daxpy( arrays )`][@stdlib/blas/base/ndarray/daxpy]</span><span class="delimiter">: </span><span class="description">multiply a one-dimensional double-precision floating-point ndarray `x` by a constant `alpha` and add the result to a one-dimensional double-precision floating-point ndarray `y`.</span>
@@ -58,6 +59,7 @@ The namespace exposes the following APIs:
 -   <span class="signature">[`gaxpy( arrays )`][@stdlib/blas/base/ndarray/gaxpy]</span><span class="delimiter">: </span><span class="description">multiply a one-dimensional ndarray `x` by a constant `alpha` and add the result to a one-dimensional ndarray `y`.</span>
 -   <span class="signature">[`gcopy( arrays )`][@stdlib/blas/base/ndarray/gcopy]</span><span class="delimiter">: </span><span class="description">copy values from a one-dimensional ndarray `x` into a one-dimensional ndarray `y`.</span>
 -   <span class="signature">[`gdot( arrays )`][@stdlib/blas/base/ndarray/gdot]</span><span class="delimiter">: </span><span class="description">calculate the dot product of two one-dimensional ndarrays.</span>
+-   <span class="signature">[`gscal( arrays )`][@stdlib/blas/base/ndarray/gscal]</span><span class="delimiter">: </span><span class="description">multiply a one-dimensional ndarray by a scalar constant.</span>
 -   <span class="signature">[`gswap( arrays )`][@stdlib/blas/base/ndarray/gswap]</span><span class="delimiter">: </span><span class="description">interchange two one-dimensional ndarrays.</span>
 -   <span class="signature">[`sasum( arrays )`][@stdlib/blas/base/ndarray/sasum]</span><span class="delimiter">: </span><span class="description">calculate the sum of absolute values for all elements in a one-dimensional single-precision floating-point ndarray.</span>
 -   <span class="signature">[`saxpy( arrays )`][@stdlib/blas/base/ndarray/saxpy]</span><span class="delimiter">: </span><span class="description">multiply a one-dimensional single-precision floating-point ndarray `x` by a constant `alpha` and add the result to a one-dimensional single-precision floating-point ndarray `y`.</span>
@@ -114,6 +116,8 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/base/ndarray/ccopy]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/ccopy
 
+[@stdlib/blas/base/ndarray/cscal]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/cscal
+
 [@stdlib/blas/base/ndarray/cswap]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/cswap
 
 [@stdlib/blas/base/ndarray/dasum]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/dasum
@@ -136,6 +140,8 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/base/ndarray/gdot]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/gdot
 
+[@stdlib/blas/base/ndarray/gscal]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/gscal
+
 [@stdlib/blas/base/ndarray/gswap]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/gswap
 
 [@stdlib/blas/base/ndarray/sasum]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/base/ndarray/sasum

lib/node_modules/@stdlib/blas/base/ndarray/docs/types/index.d.ts

@@ -22,6 +22,7 @@
 
 import caxpy = require( '@stdlib/blas/base/ndarray/caxpy' );
 import ccopy = require( '@stdlib/blas/base/ndarray/ccopy' );
+import cscal = require( '@stdlib/blas/base/ndarray/cscal' );
 import cswap = require( '@stdlib/blas/base/ndarray/cswap' );
 import dasum = require( '@stdlib/blas/base/ndarray/dasum' );
 import daxpy = require( '@stdlib/blas/base/ndarray/daxpy' );
@@ -33,6 +34,7 @@ import gasum = require( '@stdlib/blas/base/ndarray/gasum' );
 import gaxpy = require( '@stdlib/blas/base/ndarray/gaxpy' );
 import gcopy = require( '@stdlib/blas/base/ndarray/gcopy' );
 import gdot = require( '@stdlib/blas/base/ndarray/gdot' );
+import gscal = require( '@stdlib/blas/base/ndarray/gscal' );
 import gswap = require( '@stdlib/blas/base/ndarray/gswap' );
 import sasum = require( '@stdlib/blas/base/ndarray/sasum' );
 import saxpy = require( '@stdlib/blas/base/ndarray/saxpy' );
@@ -109,6 +111,38 @@ interface Namespace {
 	*/
 	ccopy: typeof ccopy;
 
+	/**
+	* Multiplies a one-dimensional single-precision complex floating-point ndarray by a scalar constant.
+	*
+	* ## Notes
+	*
+	* -   The function expects the following ndarrays:
+	*
+	*     -   a one-dimensional input ndarray.
+	*     -   a zero-dimensional ndarray containing a scalar constant.
+	*
+	* @param arrays - array-like object containing ndarrays
+	* @returns input ndarray
+	*
+	* @example
+	* var Complex64Vector = require( '@stdlib/ndarray/vector/complex64' );
+	* var Complex64 = require( '@stdlib/complex/float32/ctor' );
+	* var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
+	*
+	* var x = new Complex64Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+	*
+	* var alpha = scalar2ndarray( new Complex64( 2.0, 0.0 ), {
+	*     'dtype': 'complex64'
+	* });
+	*
+	* var y = ns.cscal( [ x, alpha ] );
+	* // returns <ndarray>[ <Complex64>[ 2.0, 4.0 ], <Complex64>[ 6.0, 8.0 ], <Complex64>[ 10.0, 12.0 ] ]
+	*
+	* var bool = ( y === x );
+	* // returns true
+	*/
+	cscal: typeof cscal;
+
 	/**
 	* Interchanges two one-dimensional single-precision complex floating-point ndarrays.
 	*
@@ -408,6 +442,37 @@ interface Namespace {
 	*/
 	gdot: typeof gdot;
 
+	/**
+	* Multiplies a one-dimensional ndarray by a scalar constant.
+	*
+	* ## Notes
+	*
+	* -   The function expects the following ndarrays:
+	*
+	*     -   a one-dimensional input ndarray.
+	*     -   a zero-dimensional ndarray containing a scalar constant.
+	*
+	* @param arrays - array-like object containing ndarrays
+	* @returns input ndarray
+	*
+	* @example
+	* var vector = require( '@stdlib/ndarray/vector/ctor' );
+	* var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
+	*
+	* var x = vector( [ 1.0, 2.0, 3.0, 4.0, 5.0 ], 'generic' );
+	*
+	* var alpha = scalar2ndarray( 5.0, {
+	*     'dtype': 'generic'
+	* });
+	*
+	* var y = ns.gscal( [ x, alpha ] );
+	* // returns <ndarray>[ 5.0, 10.0, 15.0, 20.0, 25.0 ]
+	*
+	* var bool = ( y === x );
+	* // returns true
+	*/
+	gscal: typeof gscal;
+
 	/**
 	* Interchanges two one-dimensional ndarrays.
 	*

lib/node_modules/@stdlib/blas/base/ndarray/lib/index.js

@@ -252,6 +252,15 @@ setReadOnly( ns, 'zaxpy', require( '@stdlib/blas/base/ndarray/zaxpy' ) );
 */
 setReadOnly( ns, 'zcopy', require( '@stdlib/blas/base/ndarray/zcopy' ) );
 
+/**
+* @name zscal
+* @memberof ns
+* @readonly
+* @type {Function}
+* @see {@link module:@stdlib/blas/base/ndarray/zscal}
+*/
+setReadOnly( ns, 'zscal', require( '@stdlib/blas/base/ndarray/zscal' ) );
+
 /**
 * @name zswap
 * @memberof ns