Skip to content

Commit 4252091

Browse files
committed
Fix documentation examples to use native Uint8Array instead of @stdlib/array/uint8
1 parent 68ca019 commit 4252091

File tree

4 files changed

+26
-14
lines changed

4 files changed

+26
-14
lines changed

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

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -35,10 +35,11 @@ var mskmax = require( '@stdlib/stats/mskmax' );
3535
Compute the maximum value along one or more [ndarray][@stdlib/ndarray/ctor] dimensions according to a mask.
3636

3737
```javascript
38+
var Uint8Array = require( '@stdlib/array/uint8' );
3839
var array = require( '@stdlib/ndarray/array' );
3940

4041
var x = array( [ -1.0, 2.0, -3.0 ] );
41-
var mask = array( [ 0, 0, 1 ] );
42+
var mask = array( new Uint8Array( [ 0, 0, 1 ] ) );
4243

4344
var y = mskmax( x, mask );
4445
// returns <ndarray>
@@ -62,14 +63,15 @@ The function accepts the following options:
6263
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.
6364

6465
```javascript
66+
var mskmax = require( '@stdlib/stats/mskmax' );
6567
var ndarray2array = require( '@stdlib/ndarray/to-array' );
6668
var array = require( '@stdlib/ndarray/array' );
6769

6870
var x = array( [ -1.0, 2.0, -3.0, 4.0 ], {
6971
'shape': [ 2, 2 ],
7072
'order': 'row-major'
7173
});
72-
var mask = array( [ 0, 0, 1, 0 ], {
74+
var mask = array( new Uint8Array( [ 0, 0, 1, 0 ] ), {
7375
'shape': [ 2, 2 ],
7476
'order': 'row-major'
7577
});
@@ -104,14 +106,15 @@ v = y.get();
104106
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`.
105107

106108
```javascript
109+
var mskmax = require( '@stdlib/stats/mskmax' );
107110
var ndarray2array = require( '@stdlib/ndarray/to-array' );
108111
var array = require( '@stdlib/ndarray/array' );
109112

110113
var x = array( [ -1.0, 2.0, -3.0, 4.0 ], {
111114
'shape': [ 2, 2 ],
112115
'order': 'row-major'
113116
});
114-
var mask = array( [ 0, 0, 1, 0 ], {
117+
var mask = array( new Uint8Array( [ 0, 0, 1, 0 ] ), {
115118
'shape': [ 2, 2 ],
116119
'order': 'row-major'
117120
});
@@ -150,13 +153,14 @@ v = ndarray2array( y );
150153
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.
151154

152155
```javascript
156+
var mskmax = require( '@stdlib/stats/mskmax' );
153157
var getDType = require( '@stdlib/ndarray/dtype' );
154158
var array = require( '@stdlib/ndarray/array' );
155159

156160
var x = array( [ -1.0, 2.0, -3.0 ], {
157161
'dtype': 'generic'
158162
});
159-
var mask = array( [ 0, 0, 1 ] );
163+
var mask = array( new Uint8Array( [ 0, 0, 1 ] ) );
160164

161165
var y = mskmax( x, mask, {
162166
'dtype': 'float64'
@@ -172,11 +176,12 @@ var dt = String( getDType( y ) );
172176
Computes the maximum value of [ndarray][@stdlib/ndarray/ctor] along one or more dimensions and assigns results to a provided output [ndarray][@stdlib/ndarray/ctor] according to mask.
173177

174178
```javascript
179+
var mskmax = require( '@stdlib/stats/mskmax' );
175180
var array = require( '@stdlib/ndarray/array' );
176181
var zeros = require( '@stdlib/ndarray/zeros' );
177182

178183
var x = array( [ -1.0, 2.0, -3.0 ] );
179-
var mask = array( [ 0, 0, 1 ] );
184+
var mask = array( new Uint8Array( [ 0, 0, 1 ] ) );
180185
var y = zeros( [] );
181186

182187
var out = mskmax.assign( x, mask, y );

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,13 +34,13 @@
3434

3535
Returns
3636
-------
37-
out: ndarray
37+
y: ndarray
3838
Output array.
3939

4040
Examples
4141
--------
4242
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, 4.0 ] );
43-
> var mask = {{alias:@stdlib/ndarray/array}}( [ 0, 0, 1, 0 ] );
43+
> var mask = {{alias:@stdlib/ndarray/array}}( new Uint8Array( [ 0, 0, 1, 0 ] ) );
4444
> var y = {{alias}}( x, mask );
4545
> var v = y.get()
4646
2.0
@@ -77,7 +77,7 @@
7777
Examples
7878
--------
7979
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, 4.0 ] );
80-
> var mask = {{alias:@stdlib/ndarray/array}}( [ 0, 0, 1, 0 ] );
80+
> var mask = {{alias:@stdlib/ndarray/array}}( new Uint8Array( [ 0, 0, 1, 0 ] ) );
8181
> var out = {{alias:@stdlib/ndarray/zeros}}( [] );
8282
> var y = {{alias}}.assign( x, mask, out )
8383
<ndarray>

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ interface Unary {
7474
* var array = require( '@stdlib/ndarray/array' );
7575
*
7676
* var x = array( [ -1.0, 2.0, -3.0, 4.0 ] );
77-
* var mask = array( [ 0, 0, 1, 0 ] );
77+
* var mask = array( new Uint8Array( [ 0, 0, 1, 0 ] ) );
7878
*
7979
* var y = mskmax( x, mask );
8080
* // returns <ndarray>
@@ -98,7 +98,7 @@ interface Unary {
9898
* var zeros = require( '@stdlib/ndarray/zeros' );
9999
*
100100
* var x = array( [ -1.0, 2.0, -3.0, 4.0 ] );
101-
* var mask = array( [ 0, 0, 1, 0 ] );
101+
* var mask = array( new Uint8Array( [ 0, 0, 1, 0 ] ) );
102102
* var y = zeros( [] );
103103
*
104104
* var out = mskmax.assign( x, mask, y );
@@ -125,7 +125,7 @@ interface Unary {
125125
* var array = require( '@stdlib/ndarray/array' );
126126
*
127127
* var x = array( [ -1.0, 2.0, -3.0, 4.0 ] )
128-
* var mask = array( [ 0, 0, 1, 0 ] );
128+
* var mask = array( new Uint8Array( [ 0, 0, 1, 0 ] ) );
129129
*
130130
* var y = mskmax( x, mask );
131131
* // returns <ndarray>
@@ -138,7 +138,7 @@ interface Unary {
138138
* var zeros = require( '@stdlib/ndarray/zeros' );
139139
*
140140
* var x = array( [ -1.0, 2.0, -3.0, 4.0 ] )
141-
* var mask = array( [ 0, 0, 1, 0 ] );
141+
* var mask = array( new Uint8Array( [ 0, 0, 1, 0 ] ) );
142142
* var y = zeros( [] );
143143
*
144144
* var out = mskmax.assign( x, mask, y );

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,16 @@
2525
*
2626
* @example
2727
* var Float64Array = require( '@stdlib/array/float64' );
28+
* var Uint8Array = require( '@stdlib/array/uint8' );
2829
* var ndarray = require( '@stdlib/ndarray/ctor' );
2930
* var mskmax = require( '@stdlib/stats/mskmax' );
3031
*
3132
* // Create a data buffer:
3233
* var xbuf = new Float64Array( [ 0.0, 2.0, 3.0, 0.0, 0.0, 6.0, 7.0, 0.0, 0.0, 10.0, 11.0, 0.0 ] );
3334
*
35+
* // Create a mask buffer:
36+
* var mbuf = new Uint8Array( [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0 ] );
37+
*
3438
* // Define the shape of the input array:
3539
* var sh = [ 3, 1, 2 ];
3640
*
@@ -43,12 +47,15 @@
4347
* // Create an input ndarray:
4448
* var x = new ndarray( 'float64', xbuf, sh, sx, ox, 'row-major' );
4549
*
50+
* // Create a mask ndarray:
51+
* var mask = new ndarray( 'uint8', mbuf, sh, sx, ox, 'row-major' );
52+
*
4653
* // Perform reduction:
47-
* var out = mskmax( x );
54+
* var out = mskmax( x, mask );
4855
* // returns <ndarray>
4956
*
5057
* var v = out.get();
51-
* // returns 11.0
58+
* // returns 10.0
5259
*/
5360

5461
// MODULES //

0 commit comments

Comments
 (0)