Merge branch 'develop' into lapack-dlarfg

Author: aayush0325

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -57,7 +57,6 @@ body:
         - a
         - b
         - c
-      render: shell
   - type: textarea
     id: expected
     attributes:
@@ -86,12 +85,14 @@ body:
       options:
         - N/A
         - Node.js
+        - Deno
         - Firefox
         - Chrome
         - Safari
         - Microsoft Edge
         - Internet Explorer
         - Other Browser
+        - Other Server Runtime
     validations:
       required: true
   - type: input

lib/node_modules/@stdlib/assert/is-numeric-array/README.md

@@ -141,7 +141,7 @@ bool = isNumericArray( new Buffer( 10 ) );
 
 -   <span class="package-name">[`@stdlib/assert/is-array`][@stdlib/assert/is-array]</span><span class="delimiter">: </span><span class="description">test if a value is an array.</span>
 -   <span class="package-name">[`@stdlib/assert/is-number-array`][@stdlib/assert/is-number-array]</span><span class="delimiter">: </span><span class="description">test if a value is an array-like object of numbers.</span>
--   <span class="package-name">[`@stdlib/assert/is-typed-array`][@stdlib/assert/is-typed-array]</span><span class="delimiter">: </span><span class="description">test if a value is a typed array.</span>
+-   <span class="package-name">[`@stdlib/assert/is-typed-array`][@stdlib/assert/is-typed-array]</span><span class="delimiter">: </span><span class="description">test if a value is a built-in typed array.</span>
 
 </section>
 

lib/node_modules/@stdlib/assert/is-uint8clampedarray/README.md

@@ -115,7 +115,7 @@ bool = isUint8ClampedArray( null );
 
 ## See Also
 
--   <span class="package-name">[`@stdlib/assert/is-typed-array`][@stdlib/assert/is-typed-array]</span><span class="delimiter">: </span><span class="description">test if a value is a typed array.</span>
+-   <span class="package-name">[`@stdlib/assert/is-typed-array`][@stdlib/assert/is-typed-array]</span><span class="delimiter">: </span><span class="description">test if a value is a built-in typed array.</span>
 -   <span class="package-name">[`@stdlib/assert/is-uint8array`][@stdlib/assert/is-uint8array]</span><span class="delimiter">: </span><span class="description">test if a value is a Uint8Array.</span>
 
 </section>

lib/node_modules/@stdlib/blas/base/dgemm/lib/dgemm.js

@@ -22,7 +22,7 @@
 
 var max = require( '@stdlib/math/base/special/fast/max' );
 var isLayout = require( '@stdlib/blas/base/assert/is-layout' );
-var isMatrixTranspose = require( '@stdlib/blas/base/assert/is-transpose-operation' );
+var resolveStr = require( '@stdlib/blas/base/transpose-operation-resolve-str' );
 var isRowMajor = require( '@stdlib/ndarray/base/assert/is-row-major-string' );
 var isColumnMajor = require( '@stdlib/ndarray/base/assert/is-column-major-string' );
 var format = require( '@stdlib/string/format' );
@@ -35,8 +35,8 @@ var base = require( './base.js' );
 * Performs the matrix-matrix operation `C = α*op(A)*op(B) + β*C` where `op(X)` is either `op(X) = X` or `op(X) = X^T`, `α` and `β` are scalars, `A`, `B`, and `C` are matrices, with `op(A)` an `M` by `K` matrix, `op(B)` a `K` by `N` matrix, and `C` an `M` by `N` matrix.
 *
 * @param {string} order - storage layout
-* @param {string} transA - specifies whether `A` should be transposed, conjugate-transposed, or not transposed
-* @param {string} transB - specifies whether `B` should be transposed, conjugate-transposed, or not transposed
+* @param {(integer|string)} transA - specifies whether `A` should be transposed, conjugate-transposed, or not transposed
+* @param {(integer|string)} transB - specifies whether `B` should be transposed, conjugate-transposed, or not transposed
 * @param {NonNegativeInteger} M - number of rows in the matrix `op(A)` and in the matrix `C`
 * @param {NonNegativeInteger} N - number of columns in the matrix `op(B)` and in the matrix `C`
 * @param {NonNegativeInteger} K - number of columns in the matrix `op(A)` and number of rows in the matrix `op(B)`
@@ -81,14 +81,18 @@ function dgemm( order, transA, transB, M, N, K, alpha, A, LDA, B, LDB, beta, C,
 	var sb2;
 	var sc1;
 	var sc2;
+	var ta;
+	var tb;
 
 	if ( !isLayout( order ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid order. Value: `%s`.', order ) );
 	}
-	if ( !isMatrixTranspose( transA ) ) {
+	ta = resolveStr( transA );
+	if ( ta === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must be a valid transpose operation. Value: `%s`.', transA ) );
 	}
-	if ( !isMatrixTranspose( transB ) ) {
+	tb = resolveStr( transB );
+	if ( tb === null ) {
 		throw new TypeError( format( 'invalid argument. Third argument must be a valid transpose operation. Value: `%s`.', transB ) );
 	}
 	if ( M < 0 ) {
@@ -147,7 +151,7 @@ function dgemm( order, transA, transB, M, N, K, alpha, A, LDA, B, LDB, beta, C,
 		sc1 = LDC;
 		sc2 = 1;
 	}
-	return base( transA, transB, M, N, K, alpha, A, sa1, sa2, 0, B, sb1, sb2, 0, beta, C, sc1, sc2, 0 ); // eslint-disable-line max-len
+	return base( ta, tb, M, N, K, alpha, A, sa1, sa2, 0, B, sb1, sb2, 0, beta, C, sc1, sc2, 0 ); // eslint-disable-line max-len
 }
 
 

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

@@ -20,7 +20,7 @@
 
 // MODULES //
 
-var isMatrixTranspose = require( '@stdlib/blas/base/assert/is-transpose-operation' );
+var resolveStr = require( '@stdlib/blas/base/transpose-operation-resolve-str' );
 var format = require( '@stdlib/string/format' );
 var base = require( './base.js' );
 
@@ -30,8 +30,8 @@ var base = require( './base.js' );
 /**
 * Performs the matrix-matrix operation `C = α*op(A)*op(B) + β*C` where `op(X)` is either `op(X) = X` or `op(X) = X^T`, `α` and `β` are scalars, `A`, `B`, and `C` are matrices, with `op(A)` an `M` by `K` matrix, `op(B)` a `K` by `N` matrix, and `C` an `M` by `N` matrix.
 *
-* @param {string} transA - specifies whether `A` should be transposed, conjugate-transposed, or not transposed
-* @param {string} transB - specifies whether `B` should be transposed, conjugate-transposed, or not transposed
+* @param {(integer|string)} transA - specifies whether `A` should be transposed, conjugate-transposed, or not transposed
+* @param {(integer|string)} transB - specifies whether `B` should be transposed, conjugate-transposed, or not transposed
 * @param {NonNegativeInteger} M - number of rows in the matrix `op(A)` and in the matrix `C`
 * @param {NonNegativeInteger} N - number of columns in the matrix `op(B)` and in the matrix `C`
 * @param {NonNegativeInteger} K - number of columns in the matrix `op(A)` and number of rows in the matrix `op(B)`
@@ -69,10 +69,15 @@ var base = require( './base.js' );
 * // C => <Float64Array>[ 2.0, 5.0, 6.0, 11.0 ]
 */
 function dgemm( transA, transB, M, N, K, alpha, A, strideA1, strideA2, offsetA, B, strideB1, strideB2, offsetB, beta, C, strideC1, strideC2, offsetC ) { // eslint-disable-line max-params, max-len
-	if ( !isMatrixTranspose( transA ) ) {
+	var ta;
+	var tb;
+
+	ta = resolveStr( transA );
+	if ( ta === null ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid transpose operation. Value: `%s`.', transA ) );
 	}
-	if ( !isMatrixTranspose( transB ) ) {
+	tb = resolveStr( transB );
+	if ( tb === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must be a valid transpose operation. Value: `%s`.', transB ) );
 	}
 	if ( M < 0 ) {
@@ -90,7 +95,7 @@ function dgemm( transA, transB, M, N, K, alpha, A, strideA1, strideA2, offsetA,
 	if ( strideC2 === 0 ) {
 		throw new RangeError( format( 'invalid argument. Eighteenth argument must be non-zero. Value: `%d`.', strideC2 ) );
 	}
-	return base( transA, transB, M, N, K, alpha, A, strideA1, strideA2, offsetA, B, strideB1, strideB2, offsetB, beta, C, strideC1, strideC2, offsetC ); // eslint-disable-line max-len
+	return base( ta, tb, M, N, K, alpha, A, strideA1, strideA2, offsetA, B, strideB1, strideB2, offsetB, beta, C, strideC1, strideC2, offsetC ); // eslint-disable-line max-len
 }
 
 

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

@@ -29,6 +29,7 @@ import dasum = require( '@stdlib/blas/base/ndarray/dasum' );
 import daxpy = require( '@stdlib/blas/base/ndarray/daxpy' );
 import dcopy = require( '@stdlib/blas/base/ndarray/dcopy' );
 import ddot = require( '@stdlib/blas/base/ndarray/ddot' );
+import dnrm2 = require( '@stdlib/blas/base/ndarray/dnrm2' );
 import dscal = require( '@stdlib/blas/base/ndarray/dscal' );
 import dswap = require( '@stdlib/blas/base/ndarray/dswap' );
 import gasum = require( '@stdlib/blas/base/ndarray/gasum' );
@@ -45,6 +46,7 @@ import sscal = require( '@stdlib/blas/base/ndarray/sscal' );
 import sswap = require( '@stdlib/blas/base/ndarray/sswap' );
 import zaxpy = require( '@stdlib/blas/base/ndarray/zaxpy' );
 import zcopy = require( '@stdlib/blas/base/ndarray/zcopy' );
+import zdscal = require( '@stdlib/blas/base/ndarray/zdscal' );
 import zscal = require( '@stdlib/blas/base/ndarray/zscal' );
 import zswap = require( '@stdlib/blas/base/ndarray/zswap' );
 
@@ -310,6 +312,28 @@ interface Namespace {
 	*/
 	ddot: typeof ddot;
 
+	/**
+	* Computes the L2-norm of a one-dimensional double-precision floating-point ndarray.
+	*
+	* ## Notes
+	*
+	* -   The function expects the following ndarrays:
+	*
+	*     -   a one-dimensional input ndarray.
+	*
+	* @param arrays - array-like object containing ndarrays
+	* @returns L2-norm
+	*
+	* @example
+	* var Float64Vector = require( '@stdlib/ndarray/vector/float64' );
+	*
+	* var x = new Float64Vector( [ 1.0, -2.0, 2.0 ] );
+	*
+	* var y = ns.dnrm2( [ x ] );
+	* // returns 3.0
+	*/
+	dnrm2: typeof dnrm2;
+
 	/**
 	* Multiplies a one-dimensional double-precision floating-point ndarray by a scalar constant.
 	*
@@ -760,6 +784,37 @@ interface Namespace {
 	*/
 	zcopy: typeof zcopy;
 
+	/**
+	* Multiplies a one-dimensional double-precision complex floating-point ndarray by a double-precision floating-point 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 Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
+	* var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
+	*
+	* var x = new Complex128Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+	*
+	* var alpha = scalar2ndarray( 2.0, {
+	*     'dtype': 'float64'
+	* });
+	*
+	* var y = ns.zdscal( [ x, alpha ] );
+	* // returns <ndarray>[ <Complex128>[ 2.0, 4.0 ], <Complex128>[ 6.0, 8.0 ], <Complex128>[ 10.0, 12.0 ] ]
+	*
+	* var bool = ( y === x );
+	* // returns true
+	*/
+	zdscal: typeof zdscal;
+
 	/**
 	* Multiplies a one-dimensional double-precision complex floating-point ndarray by a scalar constant.
 	*

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

@@ -44,6 +44,7 @@ var o = ns;
 <div class="namespace-toc">
 
 -   <span class="signature">[`cfill( N, alpha, x, strideX )`][@stdlib/blas/ext/base/cfill]</span><span class="delimiter">: </span><span class="description">fill a single-precision complex floating-point strided array with a specified scalar constant.</span>
+-   <span class="signature">[`cindexOfColumn( order, M, N, A, LDA, x, strideX, workspace, strideW )`][@stdlib/blas/ext/base/cindex-of-column]</span><span class="delimiter">: </span><span class="description">return the index of the first column in a single-precision complex floating-point input matrix which has the same elements as a provided search vector.</span>
 -   <span class="signature">[`cindexOfRow( order, M, N, A, LDA, x, strideX, workspace, strideW )`][@stdlib/blas/ext/base/cindex-of-row]</span><span class="delimiter">: </span><span class="description">return the index of the first row in a single-precision complex floating-point input matrix which has the same elements as a provided search vector.</span>
 -   <span class="signature">[`cindexOf( N, searchElement, x, strideX )`][@stdlib/blas/ext/base/cindex-of]</span><span class="delimiter">: </span><span class="description">return the first index of a specified search element in a single-precision complex floating-point strided array.</span>
 -   <span class="signature">[`clastIndexOfRow( order, M, N, A, LDA, x, strideX, workspace, strideW )`][@stdlib/blas/ext/base/clast-index-of-row]</span><span class="delimiter">: </span><span class="description">return the index of the last row in a single-precision complex floating-point input matrix which has the same elements as a provided search vector.</span>
@@ -233,6 +234,7 @@ var o = ns;
 -   <span class="signature">[`szeroTo( N, x, strideX )`][@stdlib/blas/ext/base/szero-to]</span><span class="delimiter">: </span><span class="description">fill a single-precision floating-point strided array with linearly spaced numeric elements which increment by `1` starting from zero.</span>
 -   <span class="signature">[`wasm`][@stdlib/blas/ext/base/wasm]</span><span class="delimiter">: </span><span class="description">extensions to basic linear algebra subprograms (BLAS) compiled to WebAssembly.</span>
 -   <span class="signature">[`zfill( N, alpha, x, strideX )`][@stdlib/blas/ext/base/zfill]</span><span class="delimiter">: </span><span class="description">fill a double-precision complex floating-point strided array with a specified scalar constant.</span>
+-   <span class="signature">[`zindexOfColumn( order, M, N, A, LDA, x, strideX, workspace, strideW )`][@stdlib/blas/ext/base/zindex-of-column]</span><span class="delimiter">: </span><span class="description">return the index of the first column in a double-precision complex floating-point input matrix which has the same elements as a provided search vector.</span>
 -   <span class="signature">[`zindexOfRow( order, M, N, A, LDA, x, strideX, workspace, strideW )`][@stdlib/blas/ext/base/zindex-of-row]</span><span class="delimiter">: </span><span class="description">return the index of the first row in a double-precision complex floating-point input matrix which has the same elements as a provided search vector.</span>
 -   <span class="signature">[`zindexOf( N, searchElement, x, strideX )`][@stdlib/blas/ext/base/zindex-of]</span><span class="delimiter">: </span><span class="description">return the first index of a specified search element in a double-precision complex floating-point strided array.</span>
 -   <span class="signature">[`zlastIndexOfRow( order, M, N, A, LDA, x, strideX, workspace, strideW )`][@stdlib/blas/ext/base/zlast-index-of-row]</span><span class="delimiter">: </span><span class="description">return the index of the last row in a double-precision complex floating-point input matrix which has the same elements as a provided search vector.</span>
@@ -295,6 +297,8 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/ext/base/cfill]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/cfill
 
+[@stdlib/blas/ext/base/cindex-of-column]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/cindex-of-column
+
 [@stdlib/blas/ext/base/cindex-of-row]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/cindex-of-row
 
 [@stdlib/blas/ext/base/cindex-of]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/cindex-of
@@ -673,6 +677,8 @@ console.log( objectKeys( ns ) );
 
 [@stdlib/blas/ext/base/zfill]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/zfill
 
+[@stdlib/blas/ext/base/zindex-of-column]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/zindex-of-column
+
 [@stdlib/blas/ext/base/zindex-of-row]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/zindex-of-row
 
 [@stdlib/blas/ext/base/zindex-of]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/blas/ext/base/zindex-of