Skip to content

Commit 9705997

Browse files
docs: improve doctests for ndarray instances in ndarray/count-truthy
PR-URL: #9340 Ref: #9329 Co-authored-by: Athan Reines <kgryte@gmail.com> Reviewed-by: Athan Reines <kgryte@gmail.com>
1 parent eaa7afb commit 9705997

File tree

6 files changed

+15
-62
lines changed

6 files changed

+15
-62
lines changed

lib/node_modules/@stdlib/ndarray/count-truthy/README.md

Lines changed: 5 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -49,10 +49,7 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 0.0, 6.0 ] ] ] );
4949

5050
// Perform reduction:
5151
var out = countTruthy( x );
52-
// returns <ndarray>
53-
54-
var v = out.get();
55-
// returns 5
52+
// returns <ndarray>[ 5 ]
5653
```
5754

5855
The function accepts the following arguments:
@@ -69,7 +66,6 @@ By default, the function performs a reduction over all elements in a provided [`
6966

7067
```javascript
7168
var array = require( '@stdlib/ndarray/array' );
72-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
7369

7470
// Create an input ndarray:
7571
var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 0.0, 6.0 ] ] ] );
@@ -79,17 +75,13 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 0.0, 6.0 ] ] ] );
7975
var out = countTruthy( x, {
8076
'dims': [ 1, 2 ]
8177
});
82-
// returns <ndarray>
83-
84-
var v = ndarray2array( out );
85-
// returns [ 2, 2, 1 ]
78+
// returns <ndarray>[ 2, 2, 1 ]
8679
```
8780

8881
By default, the function returns an [`ndarray`][@stdlib/ndarray/ctor] having a shape matching only the non-reduced dimensions of the input [`ndarray`][@stdlib/ndarray/ctor] (i.e., the reduced dimensions are dropped). To include the reduced dimensions as singleton dimensions in the output [`ndarray`][@stdlib/ndarray/ctor], set the `keepdims` option to `true`.
8982

9083
```javascript
9184
var array = require( '@stdlib/ndarray/array' );
92-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
9385

9486
// Create an input ndarray:
9587
var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 0.0, 6.0 ] ] ] );
@@ -100,10 +92,7 @@ var out = countTruthy( x, {
10092
'dims': [ 1, 2 ],
10193
'keepdims': true
10294
});
103-
// returns <ndarray>
104-
105-
var v = ndarray2array( out );
106-
// returns [ [ [ 2 ] ], [ [ 2 ] ], [ [ 1 ] ] ]
95+
// returns <ndarray>[ [ [ 2 ] ], [ [ 2 ] ], [ [ 1 ] ] ]
10796
```
10897

10998
#### countTruthy.assign( x, out\[, options] )
@@ -125,13 +114,10 @@ var y = empty( [], {
125114

126115
// Perform reduction:
127116
var out = countTruthy.assign( x, y );
128-
// returns <ndarray>
117+
// returns <ndarray>[ 5 ]
129118

130119
var bool = ( out === y );
131120
// returns true
132-
133-
var v = y.get();
134-
// returns 5
135121
```
136122

137123
The function accepts the following arguments:
@@ -149,7 +135,6 @@ By default, the function performs a reduction over all elements in a provided [`
149135
```javascript
150136
var array = require( '@stdlib/ndarray/array' );
151137
var empty = require( '@stdlib/ndarray/empty' );
152-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
153138

154139
// Create an input ndarray:
155140
var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 0.0, 6.0 ] ] ] );
@@ -164,12 +149,10 @@ var y = empty( [ 3 ], {
164149
var out = countTruthy.assign( x, y, {
165150
'dims': [ 1, 2 ]
166151
});
152+
// returns <ndarray>[ 2, 2, 1 ]
167153

168154
var bool = ( out === y );
169155
// returns true
170-
171-
var v = ndarray2array( y );
172-
// returns [ 2, 2, 1 ]
173156
```
174157

175158
</section>

lib/node_modules/@stdlib/ndarray/count-truthy/docs/repl.txt

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,7 @@
3333
> y.get()
3434
3
3535
> y = {{alias}}( x, { 'keepdims': true } )
36-
<ndarray>
37-
> {{alias:@stdlib/ndarray/to-array}}( y )
38-
[ [ 3 ] ]
39-
> y.get( 0, 0 )
40-
3
36+
<ndarray>[ [ 3 ] ]
4137

4238

4339
{{alias}}.assign( x, y[, options] )
@@ -71,11 +67,9 @@
7167
> var x = {{alias:@stdlib/ndarray/array}}( [ [ 1.0, 1.0 ], [ 0.0, 1.0 ] ] );
7268
> var y = {{alias:@stdlib/ndarray/from-scalar}}( 0, { 'dtype': 'int32' } );
7369
> var out = {{alias}}.assign( x, y )
74-
<ndarray>
70+
<ndarray>[ 3 ]
7571
> var bool = ( out === y )
7672
true
77-
> y.get()
78-
3
7973

8074
See Also
8175
--------

lib/node_modules/@stdlib/ndarray/count-truthy/docs/types/index.d.ts

Lines changed: 4 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -77,10 +77,7 @@ interface CountTruthy {
7777
*
7878
* // Perform reduction:
7979
* var out = countTruthy( x );
80-
* // returns <ndarray>
81-
*
82-
* var v = out.get();
83-
* // returns 5
80+
* // returns <ndarray>[ 5 ]
8481
*/
8582
( x: ndarray, options?: Options ): int32ndarray; // FIXME: update once `int64` dtype support; may require adding support for an output `dtype` option
8683

@@ -120,10 +117,7 @@ interface CountTruthy {
120117
*
121118
* // Perform reduction:
122119
* var out = countTruthy.assign( x, y );
123-
* // returns <ndarray>
124-
*
125-
* var v = out.get();
126-
* // returns 5
120+
* // returns <ndarray>[ 5 ]
127121
*/
128122
assign<T extends ndarray>( x: ndarray, y: T, options?: BaseOptions ): T;
129123
}
@@ -158,10 +152,7 @@ interface CountTruthy {
158152
*
159153
* // Perform reduction:
160154
* var out = countTruthy( x );
161-
* // returns <ndarray>
162-
*
163-
* var v = out.get();
164-
* // returns 5
155+
* // returns <ndarray>[ 5 ]
165156
*
166157
* @example
167158
* var Float64Array = require( '@stdlib/array/float64' );
@@ -190,10 +181,7 @@ interface CountTruthy {
190181
*
191182
* // Perform reduction:
192183
* var out = countTruthy.assign( x, y );
193-
* // returns <ndarray>
194-
*
195-
* var v = out.get();
196-
* // returns 5
184+
* // returns <ndarray>[ 5 ]
197185
*/
198186
declare var countTruthy: CountTruthy;
199187

lib/node_modules/@stdlib/ndarray/count-truthy/lib/assign.js

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -73,10 +73,7 @@ var validate = require( './validate.js' );
7373
*
7474
* // Perform reduction:
7575
* var out = assign( x, y );
76-
* // returns <ndarray>
77-
*
78-
* var v = out.get();
79-
* // returns 5
76+
* // returns <ndarray>[ 5 ]
8077
*/
8178
function assign( x, y, options ) {
8279
var opts;

lib/node_modules/@stdlib/ndarray/count-truthy/lib/index.js

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,7 @@
4545
*
4646
* // Perform reduction:
4747
* var out = countTruthy( x );
48-
* // returns <ndarray>
49-
*
50-
* var v = out.get();
51-
* // returns 5
48+
* // returns <ndarray>[ 5 ]
5249
*
5350
* @example
5451
* var Float64Array = require( '@stdlib/array/float64' );
@@ -78,10 +75,7 @@
7875
*
7976
* // Perform reduction:
8077
* var out = countTruthy.assign( x, y );
81-
* // returns <ndarray>
82-
*
83-
* var v = out.get();
84-
* // returns 5
78+
* // returns <ndarray>[ 5 ]
8579
*/
8680

8781
// MODULES //

lib/node_modules/@stdlib/ndarray/count-truthy/lib/main.js

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -79,10 +79,7 @@ var DEFAULT_DTYPE = defaults.get( 'dtypes.integer_index' );
7979
*
8080
* // Perform reduction:
8181
* var out = countTruthy( x );
82-
* // returns <ndarray>
83-
*
84-
* var v = out.get();
85-
* // returns 5
82+
* // returns <ndarray>[ 5 ]
8683
*/
8784
function countTruthy( x, options ) {
8885
var opts;

0 commit comments

Comments
 (0)