Merge branch 'stdlib-js:develop' into refactor-variancetk

Author: prajjwalbajpai

.mailmap

@@ -141,8 +141,9 @@ Ori Miles <[email protected]> orimiles5
 Philipp Burckhardt <[email protected]> <[email protected]>
 Philipp Burckhardt <[email protected]> Planeshifter
 
-Pranav Goswami <[email protected]> <[email protected]>
-Pranav Goswami <[email protected]> Pranav
+Pranav Goswami <[email protected]> <[email protected]>
+Pranav Goswami <[email protected]> <[email protected]>
+Pranav Goswami <[email protected]> Pranav
 
 Pranjal Jha <[email protected]> PraneGIT
 

CONTRIBUTORS

@@ -17,8 +17,10 @@ Aksshay Balasubramanian <[email protected]>
 Aleksandr <[email protected]>
 Ali Salesi <[email protected]>
 Aman Bhansali <[email protected]>
+AmanBhadkariya <[email protected]>
 Amit Jimiwal <[email protected]>
 Anshu Kumar <[email protected]>
+Anshu Kumar <[email protected]>
 Anudeep Sanapala <[email protected]>
 Athan Reines <[email protected]>
 Ayaka <[email protected]>
@@ -33,6 +35,7 @@ Daniel Yu <[email protected]>
 Debashis Maharana <[email protected]>
 Desh Deepak Kant <[email protected]>
 Dev Goel <[email protected]>
+Dhanyabad behera <[email protected]>
 Dhruv Arvind Singh <[email protected]>
 Dhruvil Mehta <[email protected]>
 Divyansh Seth <[email protected]>
@@ -47,12 +50,14 @@ Gautam sharma <[email protected]>
 Golden Kumar <[email protected]>
 Gunj Joshi <[email protected]>
 Gururaj Gurram <[email protected]>
+Haroon Rasheed <[email protected]>
 Harsh <[email protected]>
 HarshaNP <[email protected]>
 Harshita Kalani <[email protected]>
 Hemant M Mehta <[email protected]>
 Hridyanshu <[email protected]>
 Jaimin Godhani <[email protected]>
+Jaison D Souza <[email protected]>
 Jalaj Kumar <[email protected]>
 James Gelok <[email protected]>
 Jaysukh Makvana <[email protected]>
@@ -66,6 +71,7 @@ Justin Dennison <[email protected]>
 Justyn Shelby <[email protected]>
 Karan Anand <[email protected]>
 Karthik Prakash <[email protected]>
+Kaushikgtm <[email protected]>
 Kohantika Nath <[email protected]>
 Krishnam Agarwal <[email protected]>
 Krishnendu Das <[email protected]>

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

@@ -41,6 +41,7 @@ import scopy = require( '@stdlib/blas/base/scopy' );
 import sdot = require( '@stdlib/blas/base/sdot' );
 import snrm2 = require( '@stdlib/blas/base/snrm2' );
 import srot = require( '@stdlib/blas/base/srot' );
+import srotm = require( '@stdlib/blas/base/srotm' );
 import sscal = require( '@stdlib/blas/base/sscal' );
 import zcopy = require( '@stdlib/blas/base/zcopy' );
 import zdrot = require( '@stdlib/blas/base/zdrot' );
@@ -677,6 +678,41 @@ interface Namespace {
 	*/
 	srot: typeof srot;
 
+	/**
+	* Applies a modified Givens plane rotation.
+	*
+	* @param N - number of indexed elements
+	* @param x - first input array
+	* @param strideX - `x` stride length
+	* @param y - second input array
+	* @param strideY - `y` stride length
+	* @param param - parameters for the modified Givens transformation
+	* @returns `y`
+	*
+	* @example
+	* var Float32Array = require( '@stdlib/array/float32' );
+	*
+	* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+	* var y = new Float32Array( [ 6.0, 7.0, 8.0, 9.0, 10.0 ] );
+	* var param = new Float32Array( [ 0.0, 0.0, 2.0, -3.0, 0.0 ] );
+	*
+	* ns.srotm( 2, x, 2, y, 1, param );
+	* // x => <Float32Array>[ ~-17.0, 2.0, ~-18.0, 4.0, 5.0 ]
+	* // y => <Float32Array>[ ~8.0, ~13.0, 8.0, 9.0, 10.0 ]
+	*
+	* @example
+	* var Float32Array = require( '@stdlib/array/float32' );
+	*
+	* var x = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 5.0 ] );
+	* var y = new Float32Array( [ 6.0, 7.0, 8.0, 9.0, 10.0 ] );
+	* var param = new Float32Array( [ 0.0, 0.0, 2.0, -3.0, 0.0 ] );
+	*
+	* ns.srotm.ndarray( 2, x, 1, 0, y, 2, 1, param );
+	* // x => <Float32Array>[ ~-20.0, ~-25.0, 3.0, 4.0, 5.0 ]
+	* // y => <Float32Array>[ 6.0, ~9.0, 8.0, ~13.0, 10.0 ]
+	*/
+	srotm: typeof srotm;
+
 	/**
 	* Multiplies a single-precision floating-point vector `x` by a constant `alpha`.
 	*

lib/node_modules/@stdlib/blas/base/wasm/zdrot/README.md

@@ -36,31 +36,13 @@ Applies a plane rotation.
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 var zy = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zdrot.main( zx.length, zx, 1, zy, 1, 0.8, 0.6 );
-
-var z = zy.get( 0 );
-// returns <Complex128>
-
-var re = real( z );
-// returns ~-0.6
-
-var im = imag( z );
-// returns ~-1.2
-
-z = zx.get( 0 );
-// returns <Complex128>
-
-re = real( z );
-// returns ~0.8
-
-im = imag( z );
-// returns ~1.6
+// zx => <Complex128Array>[ ~0.8, ~1.6, ~2.4, ~3.2, 4.0, ~4.8, ~5.6, ~6.4 ]
+// zy => <Complex128Array>[ ~-0.6, ~-1.2, ~-1.8, ~-2.4, -3.0, ~-3.6, ~-4.2, ~-4.8 ]
 ```
 
 The function has the following parameters:
@@ -77,31 +59,13 @@ The `N` and stride parameters determine how values in the strided arrays are acc
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 var zy = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zdrot.main( 2, zx, 2, zy, 2, 0.8, 0.6 );
-
-var z = zy.get( 0 );
-// returns <Complex128>
-
-var re = real( z );
-// returns ~-0.6
-
-var im = imag( z );
-// returns ~-1.2
-
-z = zx.get( 0 );
-// returns <Complex128>
-
-re = real( z );
-// returns ~0.8
-
-im = imag( z );
-// returns ~1.6
+// zx => <Complex128Array>[ ~0.8, ~1.6, 3.0, 4.0, 4.0, ~4.8, 7.0, 8.0 ]
+// zy => <Complex128Array>[ ~-0.6, ~-1.2,  0.0, 0.0, -3.0, ~-3.6,  0.0, 0.0 ]
 ```
 
 Note that indexing is relative to the first index. To introduce an offset, use [`typed array`][mdn-typed-array] views.
@@ -110,8 +74,6 @@ Note that indexing is relative to the first index. To introduce an offset, use [
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 // Initial arrays...
 var zx0 = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
@@ -122,24 +84,8 @@ var zx1 = new Complex128Array( zx0.buffer, zx0.BYTES_PER_ELEMENT*1 ); // start a
 var zy1 = new Complex128Array( zy0.buffer, zy0.BYTES_PER_ELEMENT*2 ); // start at 3rd element
 
 zdrot.main( 2, zx1, -2, zy1, 1, 0.8, 0.6 );
-
-var z = zy0.get( 2 );
-// returns <Complex128>
-
-var re = real( z );
-// returns ~-4.2
-
-var im = imag( z );
-// returns ~-4.8
-
-z = zx0.get( 3 );
-// returns <Complex128>
-
-re = real( z );
-// returns ~5.6
-
-im = imag( z );
-// returns ~6.4
+// zx0 => <Complex128Array>[ 1.0, 2.0, ~2.4, ~3.2, 5.0, 6.0, ~5.6, ~6.4 ]
+// zy0 => <Complex128Array>[ 0.0, 0.0,  0.0, 0.0, ~-4.2, ~-4.8, ~-1.8, ~-2.4 ]
 ```
 
 #### zdrot.ndarray( N, zx, strideX, offsetX, zy, strideY, offsetY, c, s )
@@ -148,31 +94,13 @@ Applies a plane rotation using alternative indexing semantics.
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
 var zy = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zdrot.ndarray( zx.length, zx, 1, 0, zy, 1, 0, 0.8, 0.6 );
-
-var z = zy.get( 0 );
-// returns <Complex128>
-
-var re = real( z );
-// returns ~-0.6
-
-var im = imag( z );
-// returns ~-1.2
-
-z = zx.get( 0 );
-// returns <Complex128>
-
-re = real( z );
-// returns ~0.8
-
-im = imag( z );
-// returns ~1.6
+// zx => <Complex128Array>[ ~0.8, ~1.6, ~2.4, ~3.2, 4.0, ~4.8 ]
+// zy => <Complex128Array>[ ~-0.6, ~-1.2, ~-1.8, ~-2.4, -3.0, ~-3.6 ]
 ```
 
 The function has the following additional parameters:
@@ -184,31 +112,13 @@ While [`typed array`][mdn-typed-array] views mandate a view offset based on the
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 var zy = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zdrot.ndarray( 2, zx, 2, 1, zy, 2, 1, 0.8, 0.6 );
-
-var z = zy.get( 3 );
-// returns <Complex128>
-
-var re = real( z );
-// returns ~-4.2
-
-var im = imag( z );
-// returns ~-4.8
-
-z = zx.get( 1 );
-// returns <Complex128>
-
-re = real( z );
-// returns ~2.4
-
-im = imag( z );
-// returns ~3.2
+// zx => <Complex128Array>[ 1.0, 2.0, ~2.4, ~3.2, 5.0, 6.0, ~5.6, ~6.4 ]
+// zy => <Complex128Array>[ 0.0, 0.0, ~-1.8, ~-2.4, 0.0, 0.0, ~-4.2, ~-4.8 ]
 ```
 
 * * *

lib/node_modules/@stdlib/blas/base/wasm/zdrot/docs/repl.txt

@@ -44,48 +44,30 @@
     > var zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
     > var zy = new {{alias:@stdlib/array/complex128}}( [ 0.0, 0.0, 0.0, 0.0 ] );
     > {{alias}}.main( zx.length, zx, 1, zy, 1, 0.8, 0.6 );
-    > var z = zy.get( 0 );
-    > var re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~-0.6
-    > var im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~-1.2
-    > z = zx.get( 0 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~0.8
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~1.6
+    > zx
+    <Complex128Array>[ ~0.8, ~1.6, ~2.4, ~3.2 ]
+    > zy
+    <Complex128Array>[ ~-0.6, ~-1.2, ~-1.8, ~-2.4 ]
 
     // Advanced indexing:
     > zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
     > zy = new {{alias:@stdlib/array/complex128}}( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
     > {{alias}}.main( 2, zx, -2, zy, 1, 0.8, 0.6 );
-    > z = zy.get( 0 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~-3.0
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~-3.6
-    > z = zx.get( 2 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~4.0
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~4.8
+    > zx
+    <Complex128Array>[ ~0.8, ~1.6, 3.0, 4.0, 4.0, ~4.8, 7.0, 8.0 ]
+    > zy
+    <Complex128Array>[ -3.0, ~-3.6, ~-0.6, ~-1.2, 0.0, 0.0, 0.0, 0.0 ]
 
     // Using typed array views:
     > var zx0 = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
     > var zy0 = new {{alias:@stdlib/array/complex128}}( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
     > var zx1 = new {{alias:@stdlib/array/complex128}}( zx0.buffer, zx0.BYTES_PER_ELEMENT*1 );
     > var zy1 = new {{alias:@stdlib/array/complex128}}( zy0.buffer, zy0.BYTES_PER_ELEMENT*2 );
     > {{alias}}.main( 1, zx1, 1, zy1, 1, 0.8, 0.6 );
-    > z = zy0.get( 2 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~-1.8
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~-2.4
-    > z = zx0.get( 1 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~2.4
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~3.2
+    > zx0
+    <Complex128Array>[ 1.0, 2.0, ~2.4, ~3.2, 5.0, 6.0 ]
+    > zy0
+    <Complex128Array>[ 0.0, 0.0, 0.0, 0.0, ~-1.8, ~-2.4 ]
 
 
 {{alias}}.ndarray( N, zx, strideX, offsetX, zy, strideY, offsetY, c, s )
@@ -135,31 +117,19 @@
     > var zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
     > var zy = new {{alias:@stdlib/array/complex128}}( [ 0.0, 0.0, 0.0, 0.0 ] );
     > {{alias}}.ndarray( zx.length, zx, 1, 0, zy, 1, 0, 0.8, 0.6 );
-    > var z = zy.get( 0 );
-    > var re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~-0.6
-    > var im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~-1.2
-    > z = zx.get( 0 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~0.8
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~1.6
+    > zx
+    <Complex128Array>[ ~0.8, ~1.6, ~2.4, ~3.2 ]
+    > zy
+    <Complex128Array>[ ~-0.6, ~-1.2, ~-1.8, ~-2.4 ]
 
     // Advanced indexing:
     > zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
     > zy = new {{alias:@stdlib/array/complex128}}( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
     > {{alias}}.ndarray( 1, zx, 2, 1, zy, 2, 1, 0.8, 0.6 );
-    > z = zy.get( 1 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~-1.8
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~-2.4
-    > z = zx.get( 1 );
-    > re = {{alias:@stdlib/complex/float64/real}}( z )
-    ~2.4
-    > im = {{alias:@stdlib/complex/float64/imag}}( z )
-    ~3.2
+    > zx
+    <Complex128Array>[ 1.0, 2.0, ~2.4, ~3.2, 5.0, 6.0 ]
+    > zy
+    <Complex128Array>[ 0.0, 0.0, ~-1.8, ~-2.4, 0.0, 0.0 ]
 
 
 {{alias}}.Module( memory )