Skip to content

Commit e235637

Browse files
authored
docs: update return annotations to use ndarray instance notation for stats/nanmaxabs
PR-URL: #9180 Reviewed-by: Athan Reines <[email protected]>
1 parent 2af3f7b commit e235637

File tree

5 files changed

+20
-70
lines changed

5 files changed

+20
-70
lines changed

lib/node_modules/@stdlib/stats/nanmaxabs/README.md

Lines changed: 11 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,7 @@ var array = require( '@stdlib/ndarray/array' );
4040
var x = array( [ -1.0, 2.0, NaN ] );
4141

4242
var y = nanmaxabs( x );
43-
// returns <ndarray>
44-
45-
var v = y.get();
46-
// returns 2.0
43+
// returns <ndarray>[ 2.0 ]
4744
```
4845

4946
The function has the following parameters:
@@ -60,81 +57,58 @@ The function accepts the following options:
6057
By default, the function performs a reduction over all elements in a provided input [ndarray][@stdlib/ndarray/ctor]. To perform a reduction over specific dimensions, provide a `dims` option.
6158

6259
```javascript
63-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
6460
var array = require( '@stdlib/ndarray/array' );
6561

6662
var x = array( [ -1.0, 2.0, NaN, 4.0 ], {
6763
'shape': [ 2, 2 ],
6864
'order': 'row-major'
6965
});
70-
var v = ndarray2array( x );
71-
// returns [ [ -1.0, 2.0 ], [ NaN, 4.0 ] ]
66+
// returns <ndarray>[ [ -1.0, 2.0 ], [ NaN, 4.0 ] ]
7267

7368
var y = nanmaxabs( x, {
7469
'dims': [ 0 ]
7570
});
76-
// returns <ndarray>
77-
78-
v = ndarray2array( y );
79-
// returns [ 1.0, 4.0 ]
71+
// returns <ndarray>[ 1.0, 4.0 ]
8072

8173
y = nanmaxabs( x, {
8274
'dims': [ 1 ]
8375
});
84-
// returns <ndarray>
85-
86-
v = ndarray2array( y );
87-
// returns [ 2.0, 4.0 ]
76+
// returns <ndarray>[ 2.0, 4.0 ]
8877

8978
y = nanmaxabs( x, {
9079
'dims': [ 0, 1 ]
9180
});
92-
// returns <ndarray>
93-
94-
v = y.get();
95-
// returns 4.0
81+
// returns <ndarray>[ 4.0 ]
9682
```
9783

9884
By default, the function excludes reduced dimensions from the output [ndarray][@stdlib/ndarray/ctor]. To include the reduced dimensions as singleton dimensions, set the `keepdims` option to `true`.
9985

10086
```javascript
101-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
10287
var array = require( '@stdlib/ndarray/array' );
10388

10489
var x = array( [ -1.0, 2.0, NaN, 4.0 ], {
10590
'shape': [ 2, 2 ],
10691
'order': 'row-major'
10792
});
108-
109-
var v = ndarray2array( x );
110-
// returns [ [ -1.0, 2.0 ], [ NaN, 4.0 ] ]
93+
// returns <ndarray>[ [ -1.0, 2.0 ], [ NaN, 4.0 ] ]
11194

11295
var y = nanmaxabs( x, {
11396
'dims': [ 0 ],
11497
'keepdims': true
11598
});
116-
// returns <ndarray>
117-
118-
v = ndarray2array( y );
119-
// returns [ [ 1.0, 4.0 ] ]
99+
// returns <ndarray>[ [ 1.0, 4.0 ] ]
120100

121101
y = nanmaxabs( x, {
122102
'dims': [ 1 ],
123103
'keepdims': true
124104
});
125-
// returns <ndarray>
126-
127-
v = ndarray2array( y );
128-
// returns [ [ 2.0 ], [ 4.0 ] ]
105+
// returns <ndarray>[ [ 2.0 ], [ 4.0 ] ]
129106

130107
y = nanmaxabs( x, {
131108
'dims': [ 0, 1 ],
132109
'keepdims': true
133110
});
134-
// returns <ndarray>
135-
136-
v = ndarray2array( y );
137-
// returns [ [ 4.0 ] ]
111+
// returns <ndarray>[ [ 4.0 ] ]
138112
```
139113

140114
By default, the function returns an [ndarray][@stdlib/ndarray/ctor] having a [data type][@stdlib/ndarray/dtypes] determined by the function's output data type [policy][@stdlib/ndarray/output-dtype-policies]. To override the default behavior, set the `dtype` option.
@@ -150,7 +124,7 @@ var x = array( [ -1.0, 2.0, NaN ], {
150124
var y = nanmaxabs( x, {
151125
'dtype': 'float64'
152126
});
153-
// returns <ndarray>
127+
// returns <ndarray>[ 2.0 ]
154128

155129
var dt = String( getDType( y ) );
156130
// returns 'float64'
@@ -168,10 +142,7 @@ var x = array( [ -1.0, 2.0, NaN ] );
168142
var y = zeros( [] );
169143

170144
var out = nanmaxabs.assign( x, y );
171-
// returns <ndarray>
172-
173-
var v = out.get();
174-
// returns 2.0
145+
// returns <ndarray>[ 2.0 ]
175146

176147
var bool = ( out === y );
177148
// returns true

lib/node_modules/@stdlib/stats/nanmaxabs/docs/repl.txt

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,8 @@
3131
Examples
3232
--------
3333
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, NaN, -4.0 ] );
34-
> var y = {{alias}}( x );
35-
> var v = y.get()
36-
4.0
34+
> var y = {{alias}}( x )
35+
<ndarray>[ 4.0 ]
3736

3837

3938
{{alias}}.assign( x, out[, options] )
@@ -66,11 +65,9 @@
6665
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, NaN, -4.0 ] );
6766
> var out = {{alias:@stdlib/ndarray/zeros}}( [] );
6867
> var y = {{alias}}.assign( x, out )
69-
<ndarray>
68+
<ndarray>[ 4.0 ]
7069
> var bool = ( out === y )
7170
true
72-
> var v = out.get()
73-
4.0
7471

7572
See Also
7673
--------

lib/node_modules/@stdlib/stats/nanmaxabs/docs/types/index.d.ts

Lines changed: 4 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -75,10 +75,7 @@ interface Unary {
7575
* var x = array( [ -1.0, 2.0, NaN ] );
7676
*
7777
* var y = nanmaxabs( x );
78-
* // returns <ndarray>
79-
*
80-
* var v = y.get();
81-
* // returns 2.0
78+
* // returns <ndarray>[ 2.0 ]
8279
*/
8380
<T = unknown, U = unknown>( x: InputArray<T>, options?: Options ): OutputArray<U>; // NOTE: we lose type specificity here, but retaining specificity would likely be difficult and/or tedious to completely enumerate, as the output ndarray data type is dependent on how `x` interacts with output data type policy and whether that policy has been overridden by `options.dtype`.
8481

@@ -98,10 +95,7 @@ interface Unary {
9895
* var y = zeros( [] );
9996
*
10097
* var out = nanmaxabs.assign( x, y );
101-
* // returns <ndarray>
102-
*
103-
* var v = out.get();
104-
* // returns 2.0
98+
* // returns <ndarray>[ 2.0 ]
10599
*
106100
* var bool = ( out === y );
107101
* // returns true
@@ -122,10 +116,7 @@ interface Unary {
122116
* var x = array( [ -1.0, 2.0, NaN ] );
123117
*
124118
* var y = nanmaxabs( x );
125-
* // returns <ndarray>
126-
*
127-
* var v = y.get();
128-
* // returns 2.0
119+
* // returns <ndarray>[ 2.0 ]
129120
*
130121
* @example
131122
* var array = require( '@stdlib/ndarray/array' );
@@ -135,10 +126,7 @@ interface Unary {
135126
* var y = zeros( [] );
136127
*
137128
* var out = nanmaxabs.assign( x, y );
138-
* // returns <ndarray>
139-
*
140-
* var v = out.get();
141-
* // returns 2.0
129+
* // returns <ndarray>[ 2.0 ]
142130
*
143131
* var bool = ( out === y );
144132
* // returns true

lib/node_modules/@stdlib/stats/nanmaxabs/lib/index.js

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,7 @@
4545
*
4646
* // Perform reduction:
4747
* var out = nanmaxabs( x );
48-
* // returns <ndarray>
49-
*
50-
* var v = out.get();
51-
* // returns 11.0
48+
* // returns <ndarray>[ 11.0 ]
5249
*/
5350

5451
// MODULES //

lib/node_modules/@stdlib/stats/nanmaxabs/lib/main.js

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -88,10 +88,7 @@ var table = {
8888
*
8989
* // Perform reduction:
9090
* var out = nanmaxabs( x );
91-
* // returns <ndarray>
92-
*
93-
* var v = out.get();
94-
* // returns 11.0
91+
* // returns <ndarray>[ 11.0 ]
9592
*/
9693
var nanmaxabs = factory( table, [ idtypes ], odtypes, policies );
9794

0 commit comments

Comments
 (0)