Skip to content

Commit 7cfb8f7

Browse files
gururaj1512gururaj1512
authored
docs: update examples for blas/base/zaxpy
PR-URL: #5173 Ref: #4833 Reviewed-by: Athan Reines <[email protected]>
1 parent 2981d28 commit 7cfb8f7

File tree

6 files changed

+25
-173
lines changed

6 files changed

+25
-173
lines changed

Diff for: ‎lib/node_modules/@stdlib/blas/base/zaxpy/README.md

+5-55
Original file line numberDiff line numberDiff line change
@@ -37,23 +37,13 @@ Scales values from `zx` by `za` and adds the result to `zy`.
3737
```javascript
3838
var Complex128Array = require( '@stdlib/array/complex128' );
3939
var Complex128 = require( '@stdlib/complex/float64/ctor' );
40-
var real = require( '@stdlib/complex/float64/real' );
41-
var imag = require( '@stdlib/complex/float64/imag' );
4240

4341
var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
4442
var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
4543
var za = new Complex128( 2.0, 2.0 );
4644

4745
zaxpy( 3, za, zx, 1, zy, 1 );
48-
49-
var z = zy.get( 0 );
50-
// returns <Complex128>
51-
52-
var re = real( z );
53-
// returns -1.0
54-
55-
var im = imag( z );
56-
// returns 7.0
46+
// zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
5747
```
5848

5949
The function has the following parameters:
@@ -70,23 +60,13 @@ The `N` and stride parameters determine how values from `zx` are scaled by `za`
7060
```javascript
7161
var Complex128Array = require( '@stdlib/array/complex128' );
7262
var Complex128 = require( '@stdlib/complex/float64/ctor' );
73-
var real = require( '@stdlib/complex/float64/real' );
74-
var imag = require( '@stdlib/complex/float64/imag' );
7563

7664
var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
7765
var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
7866
var za = new Complex128( 2.0, 2.0 );
7967

8068
zaxpy( 2, za, zx, 2, zy, 2 );
81-
82-
var z = zy.get( 0 );
83-
// returns <Complex128>
84-
85-
var re = real( z );
86-
// returns -1.0
87-
88-
var im = imag( z );
89-
// returns 7.0
69+
// zy => <Complex128Array>[ -1.0, 7.0, 1.0, 1.0, -1.0, 23.0, 1.0, 1.0 ]
9070
```
9171

9272
Note that indexing is relative to the first index. To introduce an offset, use [`typed array`][mdn-typed-array] views.
@@ -96,8 +76,6 @@ Note that indexing is relative to the first index. To introduce an offset, use [
9676
```javascript
9777
var Complex128Array = require( '@stdlib/array/complex128' );
9878
var Complex128 = require( '@stdlib/complex/float64/ctor' );
99-
var real = require( '@stdlib/complex/float64/real' );
100-
var imag = require( '@stdlib/complex/float64/imag' );
10179

10280
// Initial arrays...
10381
var zx0 = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
@@ -112,15 +90,7 @@ var zy1 = new Complex128Array( zy0.buffer, zy0.BYTES_PER_ELEMENT*2 ); // start a
11290

11391
// Scales values of `zx0` by `za` starting from second index and add the result to `zy0` starting from third index...
11492
zaxpy( 2, za, zx1, 1, zy1, 1 );
115-
116-
var z = zy0.get( 2 );
117-
// returns <Complex128>
118-
119-
var re = real( z );
120-
// returns -1.0
121-
122-
var im = imag( z );
123-
// returns 15.0
93+
// zy0 => <Complex128Array>[ 1.0, 1.0, 1.0, 1.0, -1.0, 15.0, -1.0, 23.0 ]
12494
```
12595

12696
#### zaxpy.ndarray( N, za, zx, strideX, offsetX, zy, strideY, offsetY )
@@ -130,23 +100,13 @@ Scales values from `zx` by `za` and adds the result to `zy` using alternative in
130100
```javascript
131101
var Complex128Array = require( '@stdlib/array/complex128' );
132102
var Complex128 = require( '@stdlib/complex/float64/ctor' );
133-
var real = require( '@stdlib/complex/float64/real' );
134-
var imag = require( '@stdlib/complex/float64/imag' );
135103

136104
var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
137105
var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
138106
var za = new Complex128( 2.0, 2.0 );
139107

140108
zaxpy.ndarray( 3, za, zx, 1, 0, zy, 1, 0 );
141-
142-
var z = zy.get( 0 );
143-
// returns <Complex128>
144-
145-
var re = real( z );
146-
// returns -1.0
147-
148-
var im = imag( z );
149-
// returns 7.0
109+
// zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
150110
```
151111

152112
The function has the following additional parameters:
@@ -159,23 +119,13 @@ While [`typed array`][mdn-typed-array] views mandate a view offset based on the
159119
```javascript
160120
var Complex128Array = require( '@stdlib/array/complex128' );
161121
var Complex128 = require( '@stdlib/complex/float64/ctor' );
162-
var real = require( '@stdlib/complex/float64/real' );
163-
var imag = require( '@stdlib/complex/float64/imag' );
164122

165123
var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
166124
var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
167125
var za = new Complex128( 2.0, 2.0 );
168126

169127
zaxpy.ndarray( 3, za, zx, 1, 1, zy, 1, 1 );
170-
171-
var z = zy.get( 3 );
172-
// returns <Complex128>
173-
174-
var re = real( z );
175-
// returns -1.0
176-
177-
var im = imag( z );
178-
// returns 31.0
128+
// zy => <Complex128Array>[ 1.0, 1.0, -1.0, 15.0, -1.0, 23.0, -1.0, 31.0 ]
179129
```
180130

181131
</section>

Diff for: ‎lib/node_modules/@stdlib/blas/base/zaxpy/docs/repl.txt

+12-30
Original file line numberDiff line numberDiff line change
@@ -43,34 +43,24 @@
4343
> var zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
4444
> var zy = new {{alias:@stdlib/array/complex128}}( [ 1.0, 1.0, 1.0, 1.0 ] );
4545
> var za = new {{alias:@stdlib/complex/float64/ctor}}( 2.0, 2.0 );
46-
> {{alias}}( 2, za, zx, 1, zy, 1 );
47-
> var z = zy.get( 0 );
48-
> var re = {{alias:@stdlib/complex/float64/real}}( z )
49-
-1.0
50-
> var im = {{alias:@stdlib/complex/float64/imag}}( z )
51-
7.0
46+
> {{alias}}( 2, za, zx, 1, zy, 1 )
47+
<Complex128Array>[ -1.0, 7.0, -1.0, 15.0 ]
5248

5349
// Advanced indexing:
5450
> zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
5551
> zy = new {{alias:@stdlib/array/complex128}}( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
56-
> {{alias}}( 2, za, zx, -2, zy, 1 );
57-
> z = zy.get( 0 );
58-
> re = {{alias:@stdlib/complex/float64/real}}( z )
59-
-1.0
60-
> im = {{alias:@stdlib/complex/float64/imag}}( z )
61-
23.0
52+
> {{alias}}( 2, za, zx, -2, zy, 1 )
53+
<Complex128Array>[ -1.0, 23.0, -1.0, 7.0, 1.0, 1.0 ]
6254

6355
// Using typed array views:
6456
> var zx0 = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
6557
> var zy0 = new {{alias:@stdlib/array/complex128}}( [ 1.0, 1.0, 1.0, 1.0 ] );
6658
> var zx1 = new {{alias:@stdlib/array/complex128}}( zx0.buffer, zx0.BYTES_PER_ELEMENT*1 );
6759
> var zy1 = new {{alias:@stdlib/array/complex128}}( zy0.buffer, zy0.BYTES_PER_ELEMENT*1 );
68-
> {{alias}}( 1, za, zx1, 1, zy1, 1 );
69-
> z = zy0.get( 1 );
70-
> re = {{alias:@stdlib/complex/float64/real}}( z )
71-
-1.0
72-
> im = {{alias:@stdlib/complex/float64/imag}}( z )
73-
15.0
60+
> {{alias}}( 1, za, zx1, 1, zy1, 1 )
61+
<Complex128Array>[ -1.0, 15.0 ]
62+
> zy0
63+
<Complex128Array>[ 1.0, 1.0, -1.0, 15.0 ]
7464

7565

7666
{{alias}}.ndarray( N, za, zx, strideX, offsetX, zy, strideY, offsetY )
@@ -120,22 +110,14 @@
120110
> var zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
121111
> var zy = new {{alias:@stdlib/array/complex128}}( [ 1.0, 1.0, 1.0, 1.0 ] );
122112
> var za = new {{alias:@stdlib/complex/float64/ctor}}( 2.0, 2.0 );
123-
> {{alias}}.ndarray( zx.length, za, zx, 1, 0, zy, 1, 0 );
124-
> var z = zy.get( 0 );
125-
> var re = {{alias:@stdlib/complex/float64/real}}( z )
126-
-1.0
127-
> var im = {{alias:@stdlib/complex/float64/imag}}( z )
128-
7.0
113+
> {{alias}}.ndarray( zx.length, za, zx, 1, 0, zy, 1, 0 )
114+
<Complex128Array>[ -1.0, 7.0, -1.0, 15.0 ]
129115

130116
// Advanced indexing:
131117
> zx = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
132118
> zy = new {{alias:@stdlib/array/complex128}}( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
133-
> {{alias}}.ndarray( 2, za, zx, 1, 1, zy, 1, 1 );
134-
> z = zy.get( 2 );
135-
> re = {{alias:@stdlib/complex/float64/real}}( z )
136-
-1.0
137-
> im = {{alias:@stdlib/complex/float64/imag}}( z )
138-
23.0
119+
> {{alias}}.ndarray( 2, za, zx, 1, 1, zy, 1, 1 )
120+
<Complex128Array>[ 1.0, 1.0, -1.0, 15.0, -1.0, 23.0 ]
139121

140122
See Also
141123
--------

Diff for: ‎lib/node_modules/@stdlib/blas/base/zaxpy/docs/types/index.d.ts

+4-44
Original file line numberDiff line numberDiff line change
@@ -41,23 +41,13 @@ interface Routine {
4141
* @example
4242
* var Complex128Array = require( '@stdlib/array/complex128' );
4343
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
44-
* var real = require( '@stdlib/complex/float64/real' );
45-
* var imag = require( '@stdlib/complex/float64/imag' );
4644
*
4745
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
4846
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
4947
* var za = new Complex128( 2.0, 2.0 );
5048
*
5149
* zaxpy( zx.length, za, zx, 1, zy, 1 );
52-
*
53-
* var z = zy.get( 0 );
54-
* // returns <Complex128>
55-
*
56-
* var re = real( z );
57-
* // returns -1.0
58-
*
59-
* var im = imag( z );
60-
* // returns 7.0
50+
* // zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
6151
*/
6252
( N: number, za: Complex128, zx: Complex128Array, strideX: number, zy: Complex128Array, strideY: number ): Complex128Array;
6353

@@ -77,23 +67,13 @@ interface Routine {
7767
* @example
7868
* var Complex128Array = require( '@stdlib/array/complex128' );
7969
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
80-
* var real = require( '@stdlib/complex/float64/real' );
81-
* var imag = require( '@stdlib/complex/float64/imag' );
8270
*
8371
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
8472
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
8573
* var za = new Complex128( 2.0, 2.0 );
8674
*
8775
* zaxpy.ndarray( zx.length, za, zx, 1, 0, zy, 1, 0 );
88-
*
89-
* var z = zy.get( 0 );
90-
* // returns <Complex128>
91-
*
92-
* var re = real( z );
93-
* // returns -1.0
94-
*
95-
* var im = imag( z );
96-
* // returns 7.0
76+
* // zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
9777
*/
9878
ndarray( N: number, za: Complex128, zx: Complex128Array, strideX: number, offsetX: number, zy: Complex128Array, strideY: number, offsetY: number ): Complex128Array;
9979
}
@@ -112,44 +92,24 @@ interface Routine {
11292
* @example
11393
* var Complex128Array = require( '@stdlib/array/complex128' );
11494
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
115-
* var real = require( '@stdlib/complex/float64/real' );
116-
* var imag = require( '@stdlib/complex/float64/imag' );
11795
*
11896
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
11997
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
12098
* var za = new Complex128( 2.0, 2.0 );
12199
*
122100
* zaxpy( 2, za, zx, 2, zy, 2 );
123-
*
124-
* var z = zy.get( 0 );
125-
* // returns <Complex128>
126-
*
127-
* var re = real( z );
128-
* // returns -1.0
129-
*
130-
* var im = imag( z );
131-
* // returns 7.0
101+
* // zy => <Complex128Array>[ -1.0, 7.0, 1.0, 1.0, -1.0, 23.0, 1.0, 1.0 ]
132102
*
133103
* @example
134104
* var Complex128Array = require( '@stdlib/array/complex128' );
135105
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
136-
* var real = require( '@stdlib/complex/float64/real' );
137-
* var imag = require( '@stdlib/complex/float64/imag' );
138106
*
139107
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
140108
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
141109
* var za = new Complex128( 2.0, 2.0 );
142110
*
143111
* zaxpy.ndarray( 3, za, zx, 1, 1, zy, 1, 1 );
144-
*
145-
* var z = zy.get( 3 );
146-
* // returns <Complex128>
147-
*
148-
* var re = real( z );
149-
* // returns -1.0
150-
*
151-
* var im = imag( z );
152-
* // returns 31.0
112+
* // zy => <Complex128Array>[ 1.0, 1.0, -1.0, 15.0, -1.0, 23.0, -1.0, 31.0 ]
153113
*/
154114
declare var zaxpy: Routine;
155115

Diff for: ‎lib/node_modules/@stdlib/blas/base/zaxpy/lib/index.js

+2-22
Original file line numberDiff line numberDiff line change
@@ -26,46 +26,26 @@
2626
* @example
2727
* var Complex128Array = require( '@stdlib/array/complex128' );
2828
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
29-
* var real = require( '@stdlib/complex/float64/real' );
30-
* var imag = require( '@stdlib/complex/float64/imag' );
3129
* var zaxpy = require( '@stdlib/blas/base/zaxpy' );
3230
*
3331
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
3432
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
3533
* var za = new Complex128( 2.0, 2.0 );
3634
*
3735
* zaxpy( 3, za, zx, 1, zy, 1 );
38-
*
39-
* var z = zy.get( 0 );
40-
* // returns <Complex128>
41-
*
42-
* var re = real( z );
43-
* // returns -1.0
44-
*
45-
* var im = imag( z );
46-
* // returns 7.0
36+
* // zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
4737
*
4838
* @example
4939
* var Complex128Array = require( '@stdlib/array/complex128' );
5040
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
51-
* var real = require( '@stdlib/complex/float64/real' );
52-
* var imag = require( '@stdlib/complex/float64/imag' );
5341
* var zaxpy = require( '@stdlib/blas/base/zaxpy' );
5442
*
5543
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
5644
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
5745
* var za = new Complex128( 2.0, 2.0 );
5846
*
5947
* zaxpy.ndarray( 3, za, zx, 1, 0, zy, 1, 0 );
60-
*
61-
* var z = zy.get( 0 );
62-
* // returns <Complex128>
63-
*
64-
* var re = real( z );
65-
* // returns -1.0
66-
*
67-
* var im = imag( z );
68-
* // returns 7.0
48+
* // zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
6949
*/
7050

7151
// MODULES //

Diff for: ‎lib/node_modules/@stdlib/blas/base/zaxpy/lib/ndarray.js

+1-11
Original file line numberDiff line numberDiff line change
@@ -45,23 +45,13 @@ var dcabs1 = require( '@stdlib/blas/base/dcabs1' );
4545
* @example
4646
* var Complex128Array = require( '@stdlib/array/complex128' );
4747
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
48-
* var real = require( '@stdlib/complex/float64/real' );
49-
* var imag = require( '@stdlib/complex/float64/imag' );
5048
*
5149
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
5250
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
5351
* var za = new Complex128( 2.0, 2.0 );
5452
*
5553
* zaxpy( 3, za, zx, 1, 0, zy, 1, 0 );
56-
*
57-
* var z = zy.get( 0 );
58-
* // returns <Complex128>
59-
*
60-
* var re = real( z );
61-
* // returns -1.0
62-
*
63-
* var im = imag( z );
64-
* // returns 7.0
54+
* // zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
6555
*/
6656
function zaxpy( N, za, zx, strideX, offsetX, zy, strideY, offsetY ) {
6757
var viewX;

Diff for: ‎lib/node_modules/@stdlib/blas/base/zaxpy/lib/zaxpy.js

+1-11
Original file line numberDiff line numberDiff line change
@@ -40,23 +40,13 @@ var ndarray = require( './ndarray.js' );
4040
* @example
4141
* var Complex128Array = require( '@stdlib/array/complex128' );
4242
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
43-
* var real = require( '@stdlib/complex/float64/real' );
44-
* var imag = require( '@stdlib/complex/float64/imag' );
4543
*
4644
* var zx = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
4745
* var zy = new Complex128Array( [ 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 ] );
4846
* var za = new Complex128( 2.0, 2.0 );
4947
*
5048
* zaxpy( 3, za, zx, 1, zy, 1 );
51-
*
52-
* var z = zy.get( 0 );
53-
* // returns <Complex128>
54-
*
55-
* var re = real( z );
56-
* // returns -1.0
57-
*
58-
* var im = imag( z );
59-
* // returns 7.0
49+
* // zy => <Complex128Array>[ -1.0, 7.0, -1.0, 15.0, -1.0, 23.0 ]
6050
*/
6151
function zaxpy( N, za, zx, strideX, zy, strideY ) {
6252
var ix = stride2offset( N, strideX );

0 commit comments

Comments
 (0)