Skip to content

Commit ca64b6b

Browse files
committed
refactor: update implementation according to current project conventions
Ref: stdlib-js#788
1 parent 2b57f34 commit ca64b6b

File tree

21 files changed

+274
-365
lines changed

21 files changed

+274
-365
lines changed

lib/node_modules/@stdlib/blas/base/dscal/README.md

Lines changed: 5 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -54,31 +54,26 @@ The `N` and `stride` parameters determine which elements in `x` are accessed at
5454

5555
```javascript
5656
var Float64Array = require( '@stdlib/array/float64' );
57-
var floor = require( '@stdlib/math/base/special/floor' );
5857

5958
var x = new Float64Array( [ -2.0, 1.0, 3.0, -5.0, 4.0, 0.0, -1.0, -3.0 ] );
6059

61-
var N = floor( x.length / 2 );
62-
63-
dscal( N, 5.0, x, 2 );
60+
dscal( 4, 5.0, x, 2 );
6461
// x => <Float64Array>[ -10.0, 1.0, 15.0, -5.0, 20.0, 0.0, -5.0, -3.0 ]
6562
```
6663

6764
Note that indexing is relative to the first index. To introduce an offset, use [`typed array`][mdn-typed-array] views.
6865

6966
```javascript
7067
var Float64Array = require( '@stdlib/array/float64' );
71-
var floor = require( '@stdlib/math/base/special/floor' );
7268

7369
// Initial array...
7470
var x0 = new Float64Array( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
7571

7672
// Create an offset view...
7773
var x1 = new Float64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // start at 2nd element
78-
var N = 3;
7974

8075
// Scale every other value...
81-
dscal( N, 5.0, x1, 2 );
76+
dscal( 3, 5.0, x1, 2 );
8277
// x0 => <Float64Array>[ 1.0, -10.0, 3.0, -20.0, 5.0, -30.0 ]
8378
```
8479

@@ -134,27 +129,11 @@ dscal.ndarray( 3, 5.0, x, 1, x.length-3 );
134129
<!-- eslint no-undef: "error" -->
135130

136131
```javascript
137-
var round = require( '@stdlib/math/base/special/round' );
138-
var randu = require( '@stdlib/random/base/randu' );
139-
var Float64Array = require( '@stdlib/array/float64' );
132+
var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
133+
var filledarrayBy = require( '@stdlib/array/filled-by' );
140134
var dscal = require( '@stdlib/blas/base/dscal' );
141135

142-
var rand;
143-
var sign;
144-
var x;
145-
var i;
146-
147-
x = new Float64Array( 10 );
148-
for ( i = 0; i < x.length; i++ ) {
149-
rand = round( randu()*100.0 );
150-
sign = randu();
151-
if ( sign < 0.5 ) {
152-
sign = -1.0;
153-
} else {
154-
sign = 1.0;
155-
}
156-
x[ i ] = sign * rand;
157-
}
136+
var x = filledarrayBy( 10, 'float64', discreteUniform( -100, 100 ) );
158137
console.log( x );
159138

160139
dscal( x.length, 5.0, x, 1 );

lib/node_modules/@stdlib/blas/base/dscal/benchmark/benchmark.js

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -21,14 +21,19 @@
2121
// MODULES //
2222

2323
var bench = require( '@stdlib/bench' );
24-
var randu = require( '@stdlib/random/base/randu' );
24+
var uniform = require( '@stdlib/random/base/uniform' ).factory;
25+
var filledarrayBy = require( '@stdlib/array/filled-by' );
2526
var isnan = require( '@stdlib/math/base/assert/is-nan' );
2627
var pow = require( '@stdlib/math/base/special/pow' );
27-
var Float64Array = require( '@stdlib/array/float64' );
2828
var pkg = require( './../package.json' ).name;
2929
var dscal = require( './../lib/dscal.js' );
3030

3131

32+
// VARIABLES //
33+
34+
var rand = uniform( -100.0, 100.0 );
35+
36+
3237
// FUNCTIONS //
3338

3439
/**
@@ -39,13 +44,7 @@ var dscal = require( './../lib/dscal.js' );
3944
* @returns {Function} benchmark function
4045
*/
4146
function createBenchmark( len ) {
42-
var x;
43-
var i;
44-
45-
x = new Float64Array( len );
46-
for ( i = 0; i < len; i++ ) {
47-
x[ i ] = ( randu()*20.0 ) - 10.0;
48-
}
47+
var x = filledarrayBy( len, 'float64', rand );
4948
return benchmark;
5049

5150
function benchmark( b ) {

lib/node_modules/@stdlib/blas/base/dscal/benchmark/benchmark.native.js

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@
2222

2323
var resolve = require( 'path' ).resolve;
2424
var bench = require( '@stdlib/bench' );
25-
var randu = require( '@stdlib/random/base/randu' );
25+
var uniform = require( '@stdlib/random/base/uniform' ).factory;
26+
var filledarrayBy = require( '@stdlib/array/filled-by' );
2627
var isnan = require( '@stdlib/math/base/assert/is-nan' );
2728
var pow = require( '@stdlib/math/base/special/pow' );
28-
var Float64Array = require( '@stdlib/array/float64' );
2929
var tryRequire = require( '@stdlib/utils/try-require' );
3030
var pkg = require( './../package.json' ).name;
3131

@@ -36,6 +36,7 @@ var dscal = tryRequire( resolve( __dirname, './../lib/dscal.native.js' ) );
3636
var opts = {
3737
'skip': ( dscal instanceof Error )
3838
};
39+
var rand = uniform( -100.0, 100.0 );
3940

4041

4142
// FUNCTIONS //
@@ -48,13 +49,7 @@ var opts = {
4849
* @returns {Function} benchmark function
4950
*/
5051
function createBenchmark( len ) {
51-
var x;
52-
var i;
53-
54-
x = new Float64Array( len );
55-
for ( i = 0; i < len; i++ ) {
56-
x[ i ] = ( randu()*10.0 ) - 20.0;
57-
}
52+
var x = filledarrayBy( len, 'float64', rand );
5853
return benchmark;
5954

6055
function benchmark( b ) {

lib/node_modules/@stdlib/blas/base/dscal/benchmark/benchmark.ndarray.js

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -21,14 +21,19 @@
2121
// MODULES //
2222

2323
var bench = require( '@stdlib/bench' );
24-
var randu = require( '@stdlib/random/base/randu' );
24+
var uniform = require( '@stdlib/random/base/uniform' ).factory;
25+
var filledarrayBy = require( '@stdlib/array/filled-by' );
2526
var isnan = require( '@stdlib/math/base/assert/is-nan' );
2627
var pow = require( '@stdlib/math/base/special/pow' );
27-
var Float64Array = require( '@stdlib/array/float64' );
2828
var pkg = require( './../package.json' ).name;
2929
var dscal = require( './../lib/ndarray.js' );
3030

3131

32+
// VARIABLES //
33+
34+
var rand = uniform( -100.0, 100.0 );
35+
36+
3237
// FUNCTIONS //
3338

3439
/**
@@ -39,13 +44,7 @@ var dscal = require( './../lib/ndarray.js' );
3944
* @returns {Function} benchmark function
4045
*/
4146
function createBenchmark( len ) {
42-
var x;
43-
var i;
44-
45-
x = new Float64Array( len );
46-
for ( i = 0; i < len; i++ ) {
47-
x[ i ] = ( randu()*20.0 ) - 10.0;
48-
}
47+
var x = filledarrayBy( len, 'float64', rand );
4948
return benchmark;
5049

5150
function benchmark( b ) {

lib/node_modules/@stdlib/blas/base/dscal/benchmark/benchmark.ndarray.native.js

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@
2222

2323
var resolve = require( 'path' ).resolve;
2424
var bench = require( '@stdlib/bench' );
25-
var randu = require( '@stdlib/random/base/randu' );
25+
var uniform = require( '@stdlib/random/base/uniform' ).factory;
26+
var filledarrayBy = require( '@stdlib/array/filled-by' );
2627
var isnan = require( '@stdlib/math/base/assert/is-nan' );
2728
var pow = require( '@stdlib/math/base/special/pow' );
28-
var Float64Array = require( '@stdlib/array/float64' );
2929
var tryRequire = require( '@stdlib/utils/try-require' );
3030
var pkg = require( './../package.json' ).name;
3131

@@ -36,6 +36,7 @@ var dscal = tryRequire( resolve( __dirname, './../lib/ndarray.native.js' ) );
3636
var opts = {
3737
'skip': ( dscal instanceof Error )
3838
};
39+
var rand = uniform( -100.0, 100.0 );
3940

4041

4142
// FUNCTIONS //
@@ -48,13 +49,7 @@ var opts = {
4849
* @returns {Function} benchmark function
4950
*/
5051
function createBenchmark( len ) {
51-
var x;
52-
var i;
53-
54-
x = new Float64Array( len );
55-
for ( i = 0; i < len; i++ ) {
56-
x[ i ] = ( randu()*20.0 ) - 10.0;
57-
}
52+
var x = filledarrayBy( len, 'float64', rand );
5853
return benchmark;
5954

6055
function benchmark( b ) {

lib/node_modules/@stdlib/blas/base/dscal/docs/repl.txt

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -34,29 +34,23 @@
3434
--------
3535
// Standard Usage:
3636
> var x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ] );
37-
> var alpha = 5.0;
38-
> {{alias}}( x.length, alpha, x, 1 )
37+
> {{alias}}( x.length, 5.0, x, 1 )
3938
<Float64Array>[ -10.0, 5.0, 15.0, -25.0, 20.0, -5.0, -15.0 ]
4039

4140
// Using `N` and `stride` parameters:
4241
> x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ] );
43-
> var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
44-
> alpha = 5.0;
45-
> var stride = 2;
46-
> {{alias}}( N, alpha, x, stride )
42+
> {{alias}}( 3, 5.0, x, 2 )
4743
<Float64Array>[ -10.0, 1.0, 15.0, -5.0, 20.0, -1.0, -3.0 ]
4844

4945
// Using view offsets:
5046
> var x0 = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
5147
> var x1 = new {{alias:@stdlib/array/float64}}( x0.buffer, x0.BYTES_PER_ELEMENT*1 );
52-
> N = {{alias:@stdlib/math/base/special/floor}}( x0.length / 2 );
53-
> alpha = 5.0;
54-
> stride = 2;
55-
> {{alias}}( N, alpha, x1, stride )
48+
> {{alias}}( 3, 5.0, x1, 2 )
5649
<Float64Array>[ -10.0, 3.0, -20.0, 5.0, -30.0 ]
5750
> x0
5851
<Float64Array>[ 1.0, -10.0, 3.0, -20.0, 5.0, -30.0 ]
5952

53+
6054
{{alias}}.ndarray( N, alpha, x, stride, offset )
6155
Multiplies a double-precision floating-point vector `x` by a constant
6256
`alpha` using alternative indexing semantics.
@@ -91,16 +85,12 @@
9185
--------
9286
// Standard Usage:
9387
> var x = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0, 3.0, -5.0, 4.0, -1.0, -3.0 ] );
94-
> var alpha = 5.0;
95-
> {{alias}}.ndarray( x.length, alpha, x, 1, 0 )
88+
> {{alias}}.ndarray( x.length, 5.0, x, 1, 0 )
9689
<Float64Array>[ -10.0, 5.0, 15.0, -25.0, 20.0, -5.0, -15.0 ]
9790

9891
// Using an index offset:
9992
> x = new {{alias:@stdlib/array/float64}}( [ 1.0, -2.0, 3.0, -4.0, 5.0, -6.0 ] );
100-
> var N = {{alias:@stdlib/math/base/special/floor}}( x.length / 2 );
101-
> alpha = 5.0;
102-
> var stride = 2;
103-
> {{alias}}.ndarray( N, alpha, x, stride, 1 )
93+
> {{alias}}.ndarray( 3, 5.0, x, 2, 1 )
10494
<Float64Array>[ 1.0, -10.0, 3.0, -20.0, 5.0, -30.0 ]
10595

10696
See Also

lib/node_modules/@stdlib/blas/base/dscal/docs/types/index.d.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ interface Routine {
2929
* @param alpha - constant
3030
* @param x - input array
3131
* @param stride - stride length
32-
* @returns `y`
32+
* @returns input array
3333
*
3434
* @example
3535
* var Float64Array = require( `@stdlib/array/float64` );
@@ -49,7 +49,7 @@ interface Routine {
4949
* @param x - input array
5050
* @param stride - stride length
5151
* @param offset - starting index
52-
* @returns `x`
52+
* @returns input array
5353
*
5454
* @example
5555
* var Float64Array = require( `@stdlib/array/float64` );
@@ -69,7 +69,7 @@ interface Routine {
6969
* @param alpha - constant
7070
* @param x - input array
7171
* @param stride - stride length
72-
* @returns `x`
72+
* @returns input array
7373
*
7474
* @example
7575
* var Float64Array = require( `@stdlib/array/float64` );

lib/node_modules/@stdlib/blas/base/dscal/examples/c/example.c

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,10 @@ int main( void ) {
2424
double x[] = { 1.0, -2.0, 3.0, -4.0, 5.0, -6.0, 7.0, -8.0 };
2525

2626
// Specify the number of elements:
27-
int N = 8;
27+
const int N = 8;
2828

2929
// Specify a stride:
30-
int strideX = 1;
30+
const int strideX = 1;
3131

3232
// Scale the vector:
3333
c_dscal( N, 5.0, x, strideX );

lib/node_modules/@stdlib/blas/base/dscal/examples/index.js

Lines changed: 3 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -18,27 +18,11 @@
1818

1919
'use strict';
2020

21-
var round = require( '@stdlib/math/base/special/round' );
22-
var randu = require( '@stdlib/random/base/randu' );
23-
var Float64Array = require( '@stdlib/array/float64' );
21+
var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
22+
var filledarrayBy = require( '@stdlib/array/filled-by' );
2423
var dscal = require( './../lib' );
2524

26-
var rand;
27-
var sign;
28-
var x;
29-
var i;
30-
31-
x = new Float64Array( 10 );
32-
for ( i = 0; i < x.length; i++ ) {
33-
rand = round( randu()*100.0 );
34-
sign = randu();
35-
if ( sign < 0.5 ) {
36-
sign = -1.0;
37-
} else {
38-
sign = 1.0;
39-
}
40-
x[ i ] = sign * rand;
41-
}
25+
var x = filledarrayBy( 10, 'float64', discreteUniform( -100, 100 ) );
4226
console.log( x );
4327

4428
dscal( x.length, 5.0, x, 1 );

lib/node_modules/@stdlib/blas/base/dscal/include.gypi

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@
5252

5353
# Source files:
5454
'src_files': [
55-
'<(src_dir)/addon.cpp',
55+
'<(src_dir)/addon.c',
5656
'<!@(node -e "var arr = require(\'@stdlib/utils/library-manifest\')(\'./manifest.json\',{\'os\':\'<(OS)\',\'blas\':\'<(blas)\'},{\'basedir\':process.cwd(),\'paths\':\'posix\'}).src; for ( var i = 0; i < arr.length; i++ ) { console.log( arr[ i ] ); }")',
5757
],
5858

0 commit comments

Comments
 (0)