Skip to content

Commit 1491c49

Browse files
sagar7162sagar7162
authored
docs: improve doctests for complex number instances in lapack/base/zlaset
PR-URL: #8753 Ref: #8641 Reviewed-by: Athan Reines <kgryte@gmail.com>
1 parent 7975dcf commit 1491c49

File tree

6 files changed

+40
-290
lines changed

6 files changed

+40
-290
lines changed

‎lib/node_modules/@stdlib/lapack/base/zlaset/README.md‎

Lines changed: 7 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,6 @@ Sets the off-diagonal elements and the diagonal elements of a double-precision c
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 A = new Complex128Array( 4 );
4442

@@ -48,22 +46,10 @@ var beta = new Complex128( 3.0, 4.0 );
4846
zlaset( 'row-major', 'all', 2, 2, alpha, beta, A, 2 );
4947

5048
var z = A.get( 0 );
51-
// returns <Complex128>
52-
53-
var re = real( z );
54-
// returns 3.0
55-
56-
var im = imag( z );
57-
// returns 4.0
49+
// returns <Complex128>[ 3.0, 4.0 ]
5850

5951
z = A.get( 1 );
60-
// returns <Complex128>
61-
62-
re = real( z );
63-
// returns 1.0
64-
65-
im = imag( z );
66-
// returns 2.0
52+
// returns <Complex128>[ 1.0, 2.0 ]
6753
```
6854

6955
The function has the following parameters:
@@ -84,8 +70,6 @@ Note that indexing is relative to the first index. To introduce an offset, use [
8470
```javascript
8571
var Complex128Array = require( '@stdlib/array/complex128' );
8672
var Complex128 = require( '@stdlib/complex/float64/ctor' );
87-
var real = require( '@stdlib/complex/float64/real' );
88-
var imag = require( '@stdlib/complex/float64/imag' );
8973

9074
// Initial array:
9175
var A0 = new Complex128Array( 5 );
@@ -99,13 +83,7 @@ var beta = new Complex128( 3.0, 4.0 );
9983
zlaset( 'row-major', 'all', 2, 2, alpha, beta, A1, 2 );
10084

10185
var z = A0.get( 1 );
102-
// returns <Complex128>
103-
104-
var re = real( z );
105-
// returns 3.0
106-
107-
var im = imag( z );
108-
// returns 4.0
86+
// returns <Complex128>[ 3.0, 4.0 ]
10987
```
11088

11189
#### zlaset.ndarray( uplo, M, N, alpha, beta, A, sa1, sa2, oa )
@@ -115,8 +93,6 @@ Sets the off-diagonal elements and the diagonal elements of a double-precision c
11593
```javascript
11694
var Complex128Array = require( '@stdlib/array/complex128' );
11795
var Complex128 = require( '@stdlib/complex/float64/ctor' );
118-
var real = require( '@stdlib/complex/float64/real' );
119-
var imag = require( '@stdlib/complex/float64/imag' );
12096

12197
var A = new Complex128Array( 4 );
12298

@@ -126,22 +102,10 @@ var beta = new Complex128( 3.0, 4.0 );
126102
zlaset.ndarray( 'all', 2, 2, alpha, beta, A, 2, 1, 0 );
127103

128104
var z = A.get( 0 );
129-
// returns <Complex128>
130-
131-
var re = real( z );
132-
// returns 3.0
133-
134-
var im = imag( z );
135-
// returns 4.0
105+
// returns <Complex128>[ 3.0, 4.0 ]
136106

137107
z = A.get( 1 );
138-
// returns <Complex128>
139-
140-
re = real( z );
141-
// returns 1.0
142-
143-
im = imag( z );
144-
// returns 2.0
108+
// returns <Complex128>[ 1.0, 2.0 ]
145109
```
146110

147111
The function has the following parameters:
@@ -161,8 +125,6 @@ While [`typed array`][mdn-typed-array] views mandate a view offset based on the
161125
```javascript
162126
var Complex128Array = require( '@stdlib/array/complex128' );
163127
var Complex128 = require( '@stdlib/complex/float64/ctor' );
164-
var real = require( '@stdlib/complex/float64/real' );
165-
var imag = require( '@stdlib/complex/float64/imag' );
166128

167129
var A = new Complex128Array( 5 );
168130

@@ -172,22 +134,10 @@ var beta = new Complex128( 3.0, 4.0 );
172134
zlaset.ndarray( 'all', 2, 2, alpha, beta, A, 2, 1, 1 );
173135

174136
var z = A.get( 0 );
175-
// returns <Complex128>
176-
177-
var re = real( z );
178-
// returns 0.0
179-
180-
var im = imag( z );
181-
// returns 0.0
137+
// returns <Complex128>[ 0.0, 0.0 ]
182138

183139
z = A.get( 1 );
184-
// returns <Complex128>
185-
186-
re = real( z );
187-
// returns 3.0
188-
189-
im = imag( z );
190-
// returns 4.0
140+
// returns <Complex128>[ 3.0, 4.0 ]
191141
```
192142

193143
</section>

‎lib/node_modules/@stdlib/lapack/base/zlaset/docs/repl.txt‎

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -46,11 +46,8 @@
4646
> var alpha = new {{alias:@stdlib/complex/float64/ctor}}( 1.0, 2.0 );
4747
> var beta = new {{alias:@stdlib/complex/float64/ctor}}( 3.0, 4.0 );
4848
> {{alias}}( 'row-major', 'all', 2, 2, alpha, beta, A, 2 );
49-
> var z = A.get( 0 );
50-
> {{alias:@stdlib/complex/float64/real}}( z )
51-
3.0
52-
> {{alias:@stdlib/complex/float64/imag}}( z )
53-
4.0
49+
> var z = A.get( 0 )
50+
<Complex128>[ 3.0, 4.0 ]
5451

5552

5653
{{alias}}.ndarray( uplo, M, N, alpha, beta, A, sa1, sa2, oa )
@@ -103,11 +100,8 @@
103100
> var alpha = new {{alias:@stdlib/complex/float64/ctor}}( 1.0, 2.0 );
104101
> var beta = new {{alias:@stdlib/complex/float64/ctor}}( 3.0, 4.0 );
105102
> {{alias}}.ndarray( 'all', 2, 2, alpha, beta, A, 2, 1, 1 );
106-
> var z = A.get( 1 );
107-
> {{alias:@stdlib/complex/float64/real}}( z )
108-
3.0
109-
> {{alias:@stdlib/complex/float64/imag}}( z )
110-
4.0
103+
> var z = A.get( 1 )
104+
<Complex128>[ 3.0, 4.0 ]
111105

112106
See Also
113107
--------

‎lib/node_modules/@stdlib/lapack/base/zlaset/lib/base.js‎

Lines changed: 9 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -475,8 +475,6 @@ function setLower( M, N, areal, aimag, breal, bimag, A, strideA1, strideA2, offs
475475
* @example
476476
* var Complex128Array = require( '@stdlib/array/complex128' );
477477
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
478-
* var real = require( '@stdlib/complex/float64/real' );
479-
* var imag = require( '@stdlib/complex/float64/imag' );
480478
*
481479
* var A = new Complex128Array( 4 );
482480
*
@@ -486,37 +484,17 @@ function setLower( M, N, areal, aimag, breal, bimag, A, strideA1, strideA2, offs
486484
* zlaset( 'all', 2, 2, alpha, beta, A, 2, 1, 0 );
487485
*
488486
* var z = A.get( 0 );
489-
* // returns <Complex128>
490-
*
491-
* var re = real( z );
492-
* // returns 3.0
493-
*
494-
* var im = imag( z );
495-
* // returns 4.0
487+
* // returns <Complex128>[ 3.0, 4.0 ]
496488
*
497489
* z = A.get( 1 );
498-
* // returns <Complex128>
499-
*
500-
* re = real( z );
501-
* // returns 1.0
502-
*
503-
* im = imag( z );
504-
* // returns 2.0
490+
* // returns <Complex128>[ 1.0, 2.0 ]
505491
*
506492
* z = A.get( 2 );
507-
* // returns <Complex128>
508-
*
509-
* re = real( z );
510-
* // returns 1.0
511-
*
512-
* im = imag( z );
513-
* // returns 2.0
493+
* // returns <Complex128>[ 1.0, 2.0 ]
514494
*
515495
* @example
516496
* var Complex128Array = require( '@stdlib/array/complex128' );
517497
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
518-
* var real = require( '@stdlib/complex/float64/real' );
519-
* var imag = require( '@stdlib/complex/float64/imag' );
520498
*
521499
* var A = new Complex128Array( 4 );
522500
*
@@ -526,37 +504,17 @@ function setLower( M, N, areal, aimag, breal, bimag, A, strideA1, strideA2, offs
526504
* zlaset( 'upper', 2, 2, alpha, beta, A, 2, 1, 0 );
527505
*
528506
* var z = A.get( 0 );
529-
* // returns <Complex128>
530-
*
531-
* var re = real( z );
532-
* // returns 3.0
533-
*
534-
* var im = imag( z );
535-
* // returns 4.0
507+
* // returns <Complex128>[ 3.0, 4.0 ]
536508
*
537509
* z = A.get( 1 );
538-
* // returns <Complex128>
539-
*
540-
* re = real( z );
541-
* // returns 1.0
542-
*
543-
* im = imag( z );
544-
* // returns 2.0
510+
* // returns <Complex128>[ 1.0, 2.0 ]
545511
*
546512
* z = A.get( 2 );
547-
* // returns <Complex128>
548-
*
549-
* re = real( z );
550-
* // returns 0.0
551-
*
552-
* im = imag( z );
553-
* // returns 0.0
513+
* // returns <Complex128>[ 0.0, 0.0 ]
554514
*
555515
* @example
556516
* var Complex128Array = require( '@stdlib/array/complex128' );
557517
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
558-
* var real = require( '@stdlib/complex/float64/real' );
559-
* var imag = require( '@stdlib/complex/float64/imag' );
560518
*
561519
* var A = new Complex128Array( 4 );
562520
*
@@ -566,31 +524,13 @@ function setLower( M, N, areal, aimag, breal, bimag, A, strideA1, strideA2, offs
566524
* zlaset( 'lower', 2, 2, alpha, beta, A, 2, 1, 0 );
567525
*
568526
* var z = A.get( 0 );
569-
* // returns <Complex128>
570-
*
571-
* var re = real( z );
572-
* // returns 3.0
573-
*
574-
* var im = imag( z );
575-
* // returns 4.0
527+
* // returns <Complex128>[ 3.0, 4.0 ]
576528
*
577529
* z = A.get( 1 );
578-
* // returns <Complex128>
579-
*
580-
* re = real( z );
581-
* // returns 0.0
582-
*
583-
* im = imag( z );
584-
* // returns 0.0
530+
* // returns <Complex128>[ 0.0, 0.0 ]
585531
*
586532
* z = A.get( 2 );
587-
* // returns <Complex128>
588-
*
589-
* re = real( z );
590-
* // returns 1.0
591-
*
592-
* im = imag( z );
593-
* // returns 2.0
533+
* // returns <Complex128>[ 1.0, 2.0 ]
594534
*/
595535
function zlaset( uplo, M, N, alpha, beta, A, strideA1, strideA2, offsetA ) {
596536
var viewA;

‎lib/node_modules/@stdlib/lapack/base/zlaset/lib/index.js‎

Lines changed: 2 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -26,8 +26,6 @@
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 zlaset = require( '@stdlib/lapack/base/zlaset' );
3230
*
3331
* var A = new Complex128Array( 4 );
@@ -37,19 +35,11 @@
3735
* zlaset( 'row-major', 'all', 2, 2, alpha, beta, A, 2 );
3836
*
3937
* var z = A.get( 0 );
40-
* // returns <Complex128>
41-
*
42-
* var re = real( z );
43-
* // returns 3.0
44-
*
45-
* var im = imag( z );
46-
* // returns 4.0
38+
* // returns <Complex128>[ 3.0, 4.0 ]
4739
*
4840
* @example
4941
* var Complex128Array = require( '@stdlib/array/complex128' );
5042
* var Complex128 = require( '@stdlib/complex/float64/ctor' );
51-
* var real = require( '@stdlib/complex/float64/real' );
52-
* var imag = require( '@stdlib/complex/float64/imag' );
5343
* var zlaset = require( '@stdlib/lapack/base/zlaset' );
5444
*
5545
* var A = new Complex128Array( 5 );
@@ -59,13 +49,7 @@
5949
* zlaset.ndarray( 'all', 2, 2, alpha, beta, A, 2, 1, 1 );
6050
*
6151
* var z = A.get( 1 );
62-
* // returns <Complex128>
63-
*
64-
* var re = real( z );
65-
* // returns 3.0
66-
*
67-
* var im = imag( z );
68-
* // returns 4.0
52+
* // returns <Complex128>[ 3.0, 4.0 ]
6953
*/
7054

7155
// MODULES //

0 commit comments

Comments
 (0)