feat: add blas/base/ndarray/gger

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

@@ -21,7 +21,7 @@
 // MODULES //
 
 var isLayout = require( '@stdlib/blas/base/assert/is-layout' );
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
+var resolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 var stride2offset = require( '@stdlib/strided/base/stride2offset' );
 var format = require( '@stdlib/string/format' );
 var base = require( './base.js' );
@@ -33,7 +33,7 @@ var base = require( './base.js' );
 * Performs the symmetric rank 1 operation `A = α*x*x^T + A` where `α` is a scalar, `x` is an `N` element vector, and `A` is an `N` by `N` symmetric matrix supplied in packed form.
 *
 * @param {string} order - storage layout
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` is supplied
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` is supplied
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} x - input vector
@@ -56,11 +56,13 @@ var base = require( './base.js' );
 */
 function dspr( order, uplo, N, alpha, x, strideX, AP ) {
 	var ox;
+	var u;
 
 	if ( !isLayout( order ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid order. Value: `%s`.', order ) );
 	}
-	if ( !isMatrixTriangle( uplo ) ) {
+	u = resolveStr( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must specify whether the lower or upper triangular matrix is supplied. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -73,7 +75,7 @@ function dspr( order, uplo, N, alpha, x, strideX, AP ) {
 		return AP;
 	}
 	ox = stride2offset( N, strideX );
-	return base( order, uplo, N, alpha, x, strideX, ox, AP, 1, 0 );
+	return base( order, u, N, alpha, x, strideX, ox, AP, 1, 0 );
 }
 
 

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

@@ -21,7 +21,7 @@
 // MODULES //
 
 var isLayout = require( '@stdlib/blas/base/assert/is-layout' );
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
+var resolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 var format = require( '@stdlib/string/format' );
 var base = require( './base.js' );
 
@@ -32,7 +32,7 @@ var base = require( './base.js' );
 * Performs the symmetric rank 1 operation `A = α*x*x^T + A` where `α` is a scalar, `x` is an `N` element vector, and `A` is an `N` by `N` symmetric matrix supplied in packed form.
 *
 * @param {string} order - storage layout
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` is supplied
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` is supplied
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} x - input vector
@@ -58,10 +58,12 @@ var base = require( './base.js' );
 * // AP => <Float64Array>[ 2.0, 4.0, 6.0, 5.0, 8.0, 10.0 ]
 */
 function dspr( order, uplo, N, alpha, x, strideX, offsetX, AP, strideAP, offsetAP ) { // eslint-disable-line max-len
+	var u;
 	if ( !isLayout( order ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid order. Value: `%s`.', order ) );
 	}
-	if ( !isMatrixTriangle( uplo ) ) {
+	u = resolveStr( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must specify whether the lower or upper triangular matrix is supplied. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -76,7 +78,7 @@ function dspr( order, uplo, N, alpha, x, strideX, offsetX, AP, strideAP, offsetA
 	if ( N === 0 || alpha === 0.0 ) {
 		return AP;
 	}
-	return base( order, uplo, N, alpha, x, strideX, offsetX, AP, strideAP, offsetAP ); // eslint-disable-line max-len
+	return base( order, u, N, alpha, x, strideX, offsetX, AP, strideAP, offsetAP ); // eslint-disable-line max-len
 }
 
 

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

@@ -22,7 +22,7 @@
 
 var isColumnMajor = require( '@stdlib/ndarray/base/assert/is-column-major-string' );
 var isLayout = require( '@stdlib/blas/base/assert/is-layout' );
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
+var resolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 var stride2offset = require( '@stdlib/strided/base/stride2offset' );
 var max = require( '@stdlib/math/base/special/fast/max' );
 var format = require( '@stdlib/string/format' );
@@ -35,7 +35,7 @@ var base = require( './base.js' );
 * Performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` where `α` is a scalar, `x` and `y` are `N` element vectors, and `A` is an `N` by `N` symmetric matrix.
 *
 * @param {string} order - storage layout
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} x - first input vector
@@ -67,11 +67,13 @@ function dsyr2( order, uplo, N, alpha, x, strideX, y, strideY, A, LDA ) {
 	var sa2;
 	var ox;
 	var oy;
+	var u;
 
 	if ( !isLayout( order ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid order. Value: `%s`.', order ) );
 	}
-	if ( !isMatrixTriangle( uplo ) ) {
+	u = resolveStr( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must specify whether to reference the lower or upper triangular matrix. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -99,7 +101,7 @@ function dsyr2( order, uplo, N, alpha, x, strideX, y, strideY, A, LDA ) {
 	}
 	ox = stride2offset( N, strideX );
 	oy = stride2offset( N, strideY );
-	return base( uplo, N, alpha, x, strideX, ox, y, strideY, oy, A, sa1, sa2, 0 ); // eslint-disable-line max-len
+	return base( u, N, alpha, x, strideX, ox, y, strideY, oy, A, sa1, sa2, 0 );
 }
 
 

lib/node_modules/@stdlib/blas/base/dsyr2/lib/dsyr2.native.js

@@ -21,7 +21,6 @@
 // MODULES //
 
 var isLayout = require( '@stdlib/blas/base/assert/is-layout' );
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
 var resolveOrder = require( '@stdlib/blas/base/layout-resolve-enum' );
 var resolveUplo = require( '@stdlib/blas/base/matrix-triangle-resolve-enum' );
 var max = require( '@stdlib/math/base/special/fast/max' );
@@ -35,7 +34,7 @@ var addon = require( './../src/addon.node' );
 * Performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` where `α` is a scalar, `x` and `y` are `N` element vectors, and `A` is an `N` by `N` symmetric matrix.
 *
 * @param {string} order - storage layout
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} x - first input vector
@@ -63,10 +62,13 @@ var addon = require( './../src/addon.node' );
 * // A => <Float64Array>[ 3.0, 6.0, 9.0, 2.0, 9.0, 14.0, 3.0, 2.0, 19.0 ]
 */
 function dsyr2( order, uplo, N, alpha, x, strideX, y, strideY, A, LDA ) {
+	var u;
+
 	if ( !isLayout( order ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid order. Value: `%s`.', order ) );
 	}
-	if ( !isMatrixTriangle( uplo ) ) {
+	u = resolveUplo( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must specify whether to reference the lower or upper triangular matrix. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -85,7 +87,7 @@ function dsyr2( order, uplo, N, alpha, x, strideX, y, strideY, A, LDA ) {
 	if ( N === 0 || alpha === 0.0 ) {
 		return A;
 	}
-	addon( resolveOrder( order ), resolveUplo( uplo ), N, alpha, x, strideX, y, strideY, A, LDA ); // eslint-disable-line max-len
+	addon( resolveOrder( order ), u, N, alpha, x, strideX, y, strideY, A, LDA );
 	return A;
 }
 

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

@@ -20,7 +20,7 @@
 
 // MODULES //
 
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
+var resolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 var format = require( '@stdlib/string/format' );
 var base = require( './base.js' );
 
@@ -30,7 +30,7 @@ var base = require( './base.js' );
 /**
 * Performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` where `α` is a scalar, `x` and `y` are `N` element vectors, and `A` is an `N` by `N` symmetric matrix.
 *
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} x - first input vector
@@ -62,7 +62,8 @@ var base = require( './base.js' );
 * // A => <Float64Array>[ 3.0, 6.0, 9.0, 2.0, 9.0, 14.0, 3.0, 2.0, 19.0 ]
 */
 function dsyr2( uplo, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, strideA1, strideA2, offsetA ) { // eslint-disable-line max-len, max-params
-	if ( !isMatrixTriangle( uplo ) ) {
+	var u = resolveStr( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. First argument must specify whether to reference the lower or upper triangular matrix. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -84,7 +85,7 @@ function dsyr2( uplo, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, str
 	if ( N === 0 || alpha === 0.0 ) {
 		return A;
 	}
-	return base( uplo, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, strideA1, strideA2, offsetA ); // eslint-disable-line max-len
+	return base( u, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, strideA1, strideA2, offsetA ); // eslint-disable-line max-len
 }
 
 

lib/node_modules/@stdlib/blas/base/dsyr2/lib/ndarray.native.js

@@ -20,7 +20,6 @@
 
 // MODULES //
 
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
 var resolveUplo = require( '@stdlib/blas/base/matrix-triangle-resolve-enum' );
 var format = require( '@stdlib/string/format' );
 var addon = require( './../src/addon.node' );
@@ -31,7 +30,7 @@ var addon = require( './../src/addon.node' );
 /**
 * Performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` where `α` is a scalar, `x` and `y` are `N` element vectors, and `A` is an `N` by `N` symmetric matrix.
 *
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {Float64Array} x - first input vector
@@ -63,7 +62,8 @@ var addon = require( './../src/addon.node' );
 * // A => <Float64Array>[ 3.0, 6.0, 9.0, 2.0, 9.0, 14.0, 3.0, 2.0, 19.0 ]
 */
 function dsyr2( uplo, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, strideA1, strideA2, offsetA ) { // eslint-disable-line max-len, max-params
-	if ( !isMatrixTriangle( uplo ) ) {
+	var u = resolveUplo( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. First argument must specify whether to reference the lower or upper triangular matrix. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -85,7 +85,7 @@ function dsyr2( uplo, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, str
 	if ( N === 0 || alpha === 0.0 ) {
 		return A;
 	}
-	addon.ndarray( resolveUplo( uplo ), N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, strideA1, strideA2, offsetA ); // eslint-disable-line max-len
+	addon.ndarray( u, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, strideA1, strideA2, offsetA ); // eslint-disable-line max-len
 	return A;
 }
 

lib/node_modules/@stdlib/blas/base/gsyr/lib/main.js

@@ -21,7 +21,7 @@
 // MODULES //
 
 var isLayout = require( '@stdlib/blas/base/assert/is-layout' );
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
+var resolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 var isColumnMajor = require( '@stdlib/ndarray/base/assert/is-column-major-string' );
 var stride2offset = require( '@stdlib/strided/base/stride2offset' );
 var max = require( '@stdlib/math/base/special/fast/max' );
@@ -35,7 +35,7 @@ var base = require( './base.js' );
 * Performs the symmetric rank 1 operation `A = α*x*x^T + A` where `α` is a scalar, `x` is an `N` element vector, and `A` is an `N` by `N` symmetric matrix.
 *
 * @param {string} order - storage layout
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {NumericArray} x - input vector
@@ -60,11 +60,13 @@ function gsyr( order, uplo, N, alpha, x, strideX, A, LDA ) {
 	var sa1;
 	var sa2;
 	var ox;
+	var u;
 
 	if ( !isLayout( order ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must be a valid order. Value: `%s`.', order ) );
 	}
-	if ( !isMatrixTriangle( uplo ) ) {
+	u = resolveStr( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. Second argument must specify whether to reference the lower or upper triangular matrix. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -88,7 +90,7 @@ function gsyr( order, uplo, N, alpha, x, strideX, A, LDA ) {
 		sa2 = 1;
 	}
 	ox = stride2offset( N, strideX );
-	return base( uplo, N, alpha, x, strideX, ox, A, sa1, sa2, 0 );
+	return base( u, N, alpha, x, strideX, ox, A, sa1, sa2, 0 );
 }
 
 

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

@@ -20,7 +20,7 @@
 
 // MODULES //
 
-var isMatrixTriangle = require( '@stdlib/blas/base/assert/is-matrix-triangle' );
+var resolveStr = require( '@stdlib/blas/base/matrix-triangle-resolve-str' );
 var format = require( '@stdlib/string/format' );
 var base = require( './base.js' );
 
@@ -30,7 +30,7 @@ var base = require( './base.js' );
 /**
 * Performs the symmetric rank 1 operation `A = α*x*x^T + A` where `α` is a scalar, `x` is an `N` element vector, and `A` is an `N` by `N` symmetric matrix.
 *
-* @param {string} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
+* @param {(integer|string)} uplo - specifies whether the upper or lower triangular part of the symmetric matrix `A` should be referenced
 * @param {NonNegativeInteger} N - number of elements along each dimension of `A`
 * @param {number} alpha - scalar constant
 * @param {NumericArray} x - input vector
@@ -55,7 +55,8 @@ var base = require( './base.js' );
 * // A => [ 2.0, 4.0, 6.0, 2.0, 5.0, 8.0, 3.0, 2.0, 10.0 ]
 */
 function gsyr( uplo, N, alpha, x, strideX, offsetX, A, strideA1, strideA2, offsetA ) { // eslint-disable-line max-len
-	if ( !isMatrixTriangle( uplo ) ) {
+	var u = resolveStr( uplo );
+	if ( u === null ) {
 		throw new TypeError( format( 'invalid argument. First argument must specify whether to reference the lower or upper triangular matrix. Value: `%s`.', uplo ) );
 	}
 	if ( N < 0 ) {
@@ -74,7 +75,7 @@ function gsyr( uplo, N, alpha, x, strideX, offsetX, A, strideA1, strideA2, offse
 	if ( N === 0 || alpha === 0.0 ) {
 		return A;
 	}
-	return base( uplo, N, alpha, x, strideX, offsetX, A, strideA1, strideA2, offsetA ); // eslint-disable-line max-len
+	return base( u, N, alpha, x, strideX, offsetX, A, strideA1, strideA2, offsetA ); // eslint-disable-line max-len
 }
 
 

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

@@ -40,8 +40,9 @@ var cgemv = require( '@stdlib/blas/base/ndarray/cgemv' );
 
 Performs one of the matrix-vector operations `y = alpha*A*x + beta*y`, `y = alpha*A^T*x + beta*y`, or `y = alpha*A^H*x + beta*y`, where `alpha` and `beta` are scalars, `x` and `y` are one-dimensional ndarrays, and `A` is an `M` by `N` matrix.
 
+<!-- eslint-disable max-len -->
+
 ```javascript
-/* eslint-disable max-len */
 var Complex64Matrix = require( '@stdlib/ndarray/matrix/complex64' );
 var Complex64Vector = require( '@stdlib/ndarray/vector/complex64' );
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
@@ -94,10 +95,11 @@ The function has the following parameters:
 
 ## Examples
 
+<!-- eslint-disable max-len -->
+
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-/* eslint-disable max-len */
 var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
 var Complex64Matrix = require( '@stdlib/ndarray/matrix/complex64' );
 var Complex64Vector = require( '@stdlib/ndarray/vector/complex64' );