Skip to content

Commit b6fe8ae

Browse files
committed
docs/minabs
1 parent 94be096 commit b6fe8ae

5 files changed

Lines changed: 19 additions & 68 deletions

File tree

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

Lines changed: 10 additions & 38 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 = minabs( x );
43-
// returns <ndarray>
44-
45-
var v = y.get();
46-
// returns 1.0
43+
// returns <ndarray>[ 1.0 ]
4744
```
4845

4946
The function has the following parameters:
@@ -67,74 +64,52 @@ 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 = minabs( x, {
7470
'dims': [ 0 ]
7571
});
76-
// returns <ndarray>
77-
78-
v = ndarray2array( y );
79-
// returns [ 1.0, 2.0 ]
72+
// returns <ndarray>[ 1.0, 2.0 ]
8073

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

8979
y = minabs( x, {
9080
'dims': [ 0, 1 ]
9181
});
92-
// returns <ndarray>
93-
94-
v = y.get();
95-
// returns 1.0
82+
// returns <ndarray>[ 1.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`.
9986

10087
```javascript
101-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
10288
var array = require( '@stdlib/ndarray/array' );
10389

10490
var x = array( [ -1.0, 2.0, -3.0, 4.0 ], {
10591
'shape': [ 2, 2 ],
10692
'order': 'row-major'
10793
});
108-
109-
var v = ndarray2array( x );
110-
// returns [ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
94+
// returns <ndarray>[ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
11195

11296
var y = minabs( x, {
11397
'dims': [ 0 ],
11498
'keepdims': true
11599
});
116-
// returns <ndarray>
117-
118-
v = ndarray2array( y );
119-
// returns [ [ 1.0, 2.0 ] ]
100+
// returns <ndarray>[ [ 1.0, 2.0 ] ]
120101

121102
y = minabs( x, {
122103
'dims': [ 1 ],
123104
'keepdims': true
124105
});
125-
// returns <ndarray>
126-
127-
v = ndarray2array( y );
128-
// returns [ [ 1.0 ], [ 3.0 ] ]
106+
// returns <ndarray>[ [ 1.0 ], [ 3.0 ] ]
129107

130108
y = minabs( x, {
131109
'dims': [ 0, 1 ],
132110
'keepdims': true
133111
});
134-
// returns <ndarray>
135-
136-
v = ndarray2array( y );
137-
// returns [ [ 1.0 ] ]
112+
// returns <ndarray>[ [ 1.0 ] ]
138113
```
139114

140115
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 +143,7 @@ var x = array( [ -1.0, 2.0, -3.0 ] );
168143
var y = zeros( [] );
169144

170145
var out = minabs.assign( x, y );
171-
// returns <ndarray>
172-
173-
var v = out.get();
174-
// returns 1.0
146+
// returns <ndarray>[ 1.0 ]
175147

176148
var bool = ( out === y );
177149
// returns true

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

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,8 @@
3030
Examples
3131
--------
3232
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, -4.0 ] );
33-
> var y = {{alias}}( x );
34-
> var v = y.get()
35-
1.0
33+
> var y = {{alias}}( x )
34+
<ndarray>[ 1.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>[ 1.0 ]
6968
> var bool = ( out === y )
7069
true
71-
> var v = out.get()
72-
1.0
7370

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

lib/node_modules/@stdlib/stats/minabs/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 = minabs( x );
78-
* // returns <ndarray>
79-
*
80-
* var v = y.get();
81-
* // returns 1.0
78+
* // returns <ndarray>[ 1.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 = minabs.assign( x, y );
101-
* // returns <ndarray>
102-
*
103-
* var v = out.get();
104-
* // returns 1.0
98+
* // returns <ndarray>[ 1.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 = minabs( x );
125-
* // returns <ndarray>
126-
*
127-
* var v = y.get();
128-
* // returns 1.0
119+
* // returns <ndarray>[ 1.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 = minabs.assign( x, y );
138-
* // returns <ndarray>
139-
*
140-
* var v = out.get();
141-
* // returns 1.0
129+
* // returns <ndarray>[ 1.0]
142130
*
143131
* var bool = ( out === y );
144132
* // returns true

lib/node_modules/@stdlib/stats/minabs/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 = minabs( x );
48-
* // returns <ndarray>
49-
*
50-
* var v = out.get();
51-
* // returns 2.0
48+
* // returns <ndarray>[ 2.0 ]
5249
*/
5350

5451
// MODULES //

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

0 commit comments

Comments
 (0)