Skip to content

Commit afef2ff

Browse files
committed
docs/maxabs
1 parent e43e952 commit afef2ff

5 files changed

Lines changed: 18 additions & 66 deletions

File tree

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

Lines changed: 10 additions & 37 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, -3.0 ] );
4141

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

4946
The function has the following parameters:
@@ -67,32 +64,22 @@ var x = array( [ -1.0, 2.0, -3.0, 4.0 ], {
6764
'shape': [ 2, 2 ],
6865
'order': 'row-major'
6966
});
70-
var v = ndarray2array( x );
71-
// returns [ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
67+
// returns <ndarray>[ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
7268

7369
var y = maxabs( x, {
7470
'dims': [ 0 ]
7571
});
76-
// returns <ndarray>
77-
78-
v = ndarray2array( y );
79-
// returns [ 3.0, 4.0 ]
72+
// returns <ndarray>[ 3.0, 4.0 ]
8073

8174
y = maxabs( x, {
8275
'dims': [ 1 ]
8376
});
84-
// returns <ndarray>
85-
86-
v = ndarray2array( y );
87-
// returns [ 2.0, 4.0 ]
77+
// returns <ndarray>[ 2.0, 4.0 ]
8878

8979
y = maxabs( x, {
9080
'dims': [ 0, 1 ]
9181
});
92-
// returns <ndarray>
93-
94-
v = y.get();
95-
// returns 4.0
82+
// returns <ndarray>[ 4.0 ]
9683
```
9784

9885
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`.
@@ -105,36 +92,25 @@ var x = array( [ -1.0, 2.0, -3.0, 4.0 ], {
10592
'shape': [ 2, 2 ],
10693
'order': 'row-major'
10794
});
108-
109-
var v = ndarray2array( x );
110-
// returns [ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
95+
// returns <ndarray>[ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
11196

11297
var y = maxabs( x, {
11398
'dims': [ 0 ],
11499
'keepdims': true
115100
});
116-
// returns <ndarray>
117-
118-
v = ndarray2array( y );
119-
// returns [ [ 3.0, 4.0 ] ]
101+
// returns <ndarray>[ [ 3.0, 4.0 ] ]
120102

121103
y = maxabs( x, {
122104
'dims': [ 1 ],
123105
'keepdims': true
124106
});
125-
// returns <ndarray>
126-
127-
v = ndarray2array( y );
128-
// returns [ [ 2.0 ], [ 4.0 ] ]
107+
// returns <ndarray>[ [ 2.0 ], [ 4.0 ] ]
129108

130109
y = maxabs( x, {
131110
'dims': [ 0, 1 ],
132111
'keepdims': true
133112
});
134-
// returns <ndarray>
135-
136-
v = ndarray2array( y );
137-
// returns [ [ 4.0 ] ]
113+
// returns <ndarray>[ [ 4.0 ] ]
138114
```
139115

140116
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.
@@ -168,10 +144,7 @@ var x = array( [ -1.0, 2.0, -3.0 ] );
168144
var y = zeros( [] );
169145

170146
var out = maxabs.assign( x, y );
171-
// returns <ndarray>
172-
173-
var v = out.get();
174-
// returns 3.0
147+
// returns <ndarray>[ 3.0 ]
175148

176149
var bool = ( out === y );
177150
// returns true

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

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,7 @@
3131
--------
3232
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, -4.0 ] );
3333
> var y = {{alias}}( x );
34-
> var v = y.get()
35-
4.0
34+
<ndarray>[ 4.0 ]
3635

3736

3837
{{alias}}.assign( x, out[, options] )
@@ -65,11 +64,9 @@
6564
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, -4.0 ] );
6665
> var out = {{alias:@stdlib/ndarray/zeros}}( [] );
6766
> var y = {{alias}}.assign( x, out )
68-
<ndarray>
67+
<ndarray>[ 4.0 ]
6968
> var bool = ( out === y )
7069
true
71-
> var v = out.get()
72-
4.0
7370

7471
See Also
7572
--------

lib/node_modules/@stdlib/stats/maxabs/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, -3.0 ] );
7676
*
7777
* var y = maxabs( x );
78-
* // returns <ndarray>
79-
*
80-
* var v = y.get();
81-
* // returns 3.0
78+
* // returns <ndarray>[ 3.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 = maxabs.assign( x, y );
101-
* // returns <ndarray>
102-
*
103-
* var v = out.get();
104-
* // returns 3.0
98+
* // returns <ndarray>[ 3.0 ]
10599
*
106100
* var bool = ( out === y );
107101
* // returns true
@@ -122,10 +116,7 @@ interface Unary {
122116
* var x = array( [ -1.0, 2.0, -3.0 ] );
123117
*
124118
* var y = maxabs( x );
125-
* // returns <ndarray>
126-
*
127-
* var v = y.get();
128-
* // returns 3.0
119+
* // returns <ndarray>[ 3.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 = maxabs.assign( x, y );
138-
* // returns <ndarray>
139-
*
140-
* var v = out.get();
141-
* // returns 3.0
129+
* // returns <ndarray>[ 3.0 ]
142130
*
143131
* var bool = ( out === y );
144132
* // returns true

lib/node_modules/@stdlib/stats/maxabs/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 = maxabs( 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/maxabs/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 = maxabs( x );
91-
* // returns <ndarray>
92-
*
93-
* var v = out.get();
94-
* // returns 11.0
91+
* // returns <ndarray>[ 11.0 ]
9592
*/
9693
var maxabs = factory( table, [ idtypes ], odtypes, policies );
9794

0 commit comments

Comments
 (0)