docs: update examples for blas/base/zdrot

PR-URL: #5209
Ref: #4833
Reviewed-by: Athan Reines <[email protected]>

Author: gururaj1512

lib/node_modules/@stdlib/blas/base/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( 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:
@@ -75,31 +57,13 @@ The `N` and stride parameters determine how values from `zx` and `zy` are access
 
 ```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( 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.
@@ -108,8 +72,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 ] );
@@ -120,24 +82,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( 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 )
@@ -146,31 +92,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:
@@ -182,31 +110,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 ]
 ```
 
 </section>

lib/node_modules/@stdlib/blas/base/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}}( 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}}( 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}}( 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 ]
 
     See Also
     --------