Skip to content

Commit 3c238a1

Browse files
null
PR-URL: null
1 parent 5dfd41d commit 3c238a1

File tree

7 files changed

+20
-88
lines changed

7 files changed

+20
-88
lines changed

lib/node_modules/@stdlib/blas/ext/cusum/README.md

Lines changed: 7 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -35,16 +35,12 @@ var cusum = require( '@stdlib/blas/ext/cusum' );
3535
Computes the cumulative sum along one or more [ndarray][@stdlib/ndarray/ctor] dimensions.
3636

3737
```javascript
38-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
3938
var array = require( '@stdlib/ndarray/array' );
4039

4140
var x = array( [ -1.0, 2.0, -3.0 ] );
4241

4342
var y = cusum( x );
44-
// returns <ndarray>
45-
46-
var arr = ndarray2array( y );
47-
// returns [ -1.0, 1.0, -2.0 ]
43+
// returns <ndarray>[ -1.0, 1.0, -2.0 ]
4844
```
4945

5046
The function has the following parameters:
@@ -61,61 +57,44 @@ The function accepts the following options:
6157
By default, the function uses the additive identity when computing the cumulative sum. To begin summing from a different value, provide an `initial` argument.
6258

6359
```javascript
64-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
6560
var array = require( '@stdlib/ndarray/array' );
6661

6762
var x = array( [ -1.0, 2.0, -3.0 ] );
6863

6964
var y = cusum( x, 10.0 );
70-
// returns <ndarray>
71-
72-
var arr = ndarray2array( y );
73-
// returns [ 9.0, 11.0, 8.0 ]
65+
// returns <ndarray>[ 9.0, 11.0, 8.0 ]
7466
```
7567

7668
By default, the function performs the operation over all elements in a provided input [ndarray][@stdlib/ndarray/ctor]. To perform the operation over specific dimensions, provide a `dims` option.
7769

7870
```javascript
79-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
8071
var array = require( '@stdlib/ndarray/array' );
8172

8273
var x = array( [ -1.0, 2.0, -3.0, 4.0 ], {
8374
'shape': [ 2, 2 ],
8475
'order': 'row-major'
8576
});
86-
87-
var v = ndarray2array( x );
88-
// returns [ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
77+
// returns <ndarray>[ [ -1.0, 2.0 ], [ -3.0, 4.0 ] ]
8978

9079
var y = cusum( x, {
9180
'dims': [ 0 ]
9281
});
93-
// returns <ndarray>
94-
95-
v = ndarray2array( y );
96-
// returns [ [ -1.0, 2.0 ], [ -4.0, 6.0 ] ]
82+
// returns <ndarray>[ [ -1.0, 2.0 ], [ -4.0, 6.0 ] ]
9783

9884
y = cusum( x, {
9985
'dims': [ 1 ]
10086
});
101-
// returns <ndarray>
102-
103-
v = ndarray2array( y );
104-
// returns [ [ -1.0, 1.0 ], [ -3.0, 1.0 ] ]
87+
// returns <ndarray>[ [ -1.0, 1.0 ], [ -3.0, 1.0 ] ]
10588

10689
y = cusum( x, {
10790
'dims': [ 0, 1 ]
10891
});
109-
// returns <ndarray>
110-
111-
v = ndarray2array( y );
112-
// returns [ [ -1.0, 1.0 ], [ -2.0, 2.0 ] ]
92+
// returns <ndarray>[ [ -1.0, 1.0 ], [ -2.0, 2.0 ] ]
11393
```
11494

11595
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.
11696

11797
```javascript
118-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
11998
var dtype = require( '@stdlib/ndarray/dtype' );
12099
var array = require( '@stdlib/ndarray/array' );
121100

@@ -137,18 +116,14 @@ var dt = dtype( y );
137116
Computes the cumulative sum along one or more [ndarray][@stdlib/ndarray/ctor] dimensions and assigns results to a provided output [ndarray][@stdlib/ndarray/ctor].
138117

139118
```javascript
140-
var ndarray2array = require( '@stdlib/ndarray/to-array' );
141119
var array = require( '@stdlib/ndarray/array' );
142120
var zerosLike = require( '@stdlib/ndarray/zeros-like' );
143121

144122
var x = array( [ -1.0, 2.0, -3.0 ] );
145123
var y = zerosLike( x );
146124

147125
var out = cusum.assign( x, y );
148-
// returns <ndarray>
149-
150-
var v = ndarray2array( out );
151-
// returns [ -1.0, 1.0, -2.0 ]
126+
// returns <ndarray>[ -1.0, 1.0, -2.0 ]
152127

153128
var bool = ( out === y );
154129
// returns true

lib/node_modules/@stdlib/blas/ext/cusum/docs/repl.txt

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -38,9 +38,8 @@
3838
Examples
3939
--------
4040
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, -4.0 ] );
41-
> var y = {{alias}}( x );
42-
> {{alias:@stdlib/ndarray/to-array}}( y )
43-
[ -1.0, 1.0, -2.0, -6.0 ]
41+
> var y = {{alias}}( x )
42+
<ndarray>[ -1.0, 1.0, -2.0, -6.0 ]
4443

4544

4645
{{alias}}.assign( x[, initial], out[, options] )
@@ -85,11 +84,9 @@
8584
> var x = {{alias:@stdlib/ndarray/array}}( [ -1.0, 2.0, -3.0, -4.0 ] );
8685
> var out = {{alias:@stdlib/ndarray/zeros-like}}( x );
8786
> var y = {{alias}}.assign( x, out )
88-
<ndarray>
87+
<ndarray>[ -1.0, 1.0, -2.0, -6.0 ]
8988
> var bool = ( out === y )
9089
true
91-
> {{alias:@stdlib/ndarray/to-array}}( y )
92-
[ -1.0, 1.0, -2.0, -6.0 ]
9390

9491
See Also
9592
--------

lib/node_modules/@stdlib/blas/ext/cusum/docs/types/index.d.ts

Lines changed: 6 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -70,16 +70,12 @@ interface Unary {
7070
* @returns output ndarray
7171
*
7272
* @example
73-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
7473
* var array = require( '@stdlib/ndarray/array' );
7574
*
7675
* var x = array( [ -1.0, 2.0, -3.0 ] );
7776
*
7877
* var y = cusum( x );
79-
* // returns <ndarray>
80-
*
81-
* var arr = ndarray2array( y );
82-
* // returns [ -1.0, 1.0, -2.0 ]
78+
* // returns <ndarray>[ -1.0, 1.0, -2.0 ]
8379
*/
8480
<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`.
8581

@@ -92,16 +88,12 @@ interface Unary {
9288
* @returns output ndarray
9389
*
9490
* @example
95-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
9691
* var array = require( '@stdlib/ndarray/array' );
9792
*
9893
* var x = array( [ -1.0, 2.0, -3.0 ] );
9994
*
10095
* var y = cusum( x, 10.0 );
101-
* // returns <ndarray>
102-
*
103-
* var arr = ndarray2array( y );
104-
* // returns [ 9.0, 11.0, 8.0 ]
96+
* // returns <ndarray>[ 9.0, 11.0, 8.0 ]
10597
*/
10698
<T = unknown, U = unknown>( x: InputArray<T>, initial: InitialValue<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`. In principle, as well, based on the policy, it is possible to know more exactly which `InputArray` types are actually allowed.
10799

@@ -114,21 +106,17 @@ interface Unary {
114106
* @returns output ndarray
115107
*
116108
* @example
117-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
118109
* var zerosLike = require( '@stdlib/ndarray/zeros-like' );
119110
* var array = require( '@stdlib/ndarray/array' );
120111
*
121112
* var x = array( [ -1.0, 2.0, -3.0 ] );
122113
* var y = zerosLike( x );
123114
*
124115
* var out = cusum.assign( x, y );
125-
* // returns <ndarray>
116+
* // returns <ndarray>[ -1.0, 1.0, -2.0 ]
126117
*
127118
* var bool = ( out === y );
128119
* // returns true
129-
*
130-
* var arr = ndarray2array( out );
131-
* // returns [ -1.0, 1.0, -2.0 ]
132120
*/
133121
assign<T = unknown, U extends OutputArray<unknown> = OutputArray<unknown>>( x: InputArray<T>, out: U, options?: BaseOptions ): U;
134122

@@ -142,21 +130,17 @@ interface Unary {
142130
* @returns output ndarray
143131
*
144132
* @example
145-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
146133
* var zerosLike = require( '@stdlib/ndarray/zeros-like' );
147134
* var array = require( '@stdlib/ndarray/array' );
148135
*
149136
* var x = array( [ -1.0, 2.0, -3.0 ] );
150137
* var y = zerosLike( x );
151138
*
152139
* var out = cusum.assign( x, 10.0, y );
153-
* // returns <ndarray>
140+
* // returns <ndarray>[ 9.0, 11.0, 8.0 ]
154141
*
155142
* var bool = ( out === y );
156143
* // returns true
157-
*
158-
* var arr = ndarray2array( out );
159-
* // returns [ 9.0, 11.0, 8.0 ]
160144
*/
161145
assign<T = unknown, U extends OutputArray<unknown> = OutputArray<unknown>>( x: InputArray<T>, initial: InitialValue<T>, out: U, options?: BaseOptions ): U;
162146
}
@@ -169,33 +153,25 @@ interface Unary {
169153
* @returns output ndarray
170154
*
171155
* @example
172-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
173156
* var array = require( '@stdlib/ndarray/array' );
174157
*
175158
* var x = array( [ -1.0, 2.0, -3.0 ] );
176159
*
177160
* var y = cusum( x );
178-
* // returns <ndarray>
179-
*
180-
* var arr = ndarray2array( y );
181-
* // returns [ -1.0, 1.0, -2.0 ]
161+
* // returns <ndarray>[ -1.0, 1.0, -2.0 ]
182162
*
183163
* @example
184-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
185164
* var zerosLike = require( '@stdlib/ndarray/zeros-like' );
186165
* var array = require( '@stdlib/ndarray/array' );
187166
*
188167
* var x = array( [ -1.0, 2.0, -3.0 ] );
189168
* var y = zerosLike( x );
190169
*
191170
* var out = cusum.assign( x, y );
192-
* // returns <ndarray>
171+
* // returns <ndarray>[ -1.0, 1.0, -2.0 ]
193172
*
194173
* var bool = ( out === y );
195174
* // returns true
196-
*
197-
* var arr = ndarray2array( out );
198-
* // returns [ -1.0, 1.0, -2.0 ]
199175
*/
200176
declare const cusum: Unary;
201177

lib/node_modules/@stdlib/blas/ext/cusum/lib/assign.js

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,6 @@ var base = require( './base.js' ).assign;
5555
*
5656
* @example
5757
* var Float64Array = require( '@stdlib/array/float64' );
58-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
5958
* var ndarray = require( '@stdlib/ndarray/ctor' );
6059
*
6160
* // Create data buffers:
@@ -79,13 +78,10 @@ var base = require( './base.js' ).assign;
7978
*
8079
* // Perform operation:
8180
* var out = assign( x, y );
82-
* // returns <ndarray>
81+
* // returns <ndarray>[ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
8382
*
8483
* var bool = ( out === y );
8584
* // returns true
86-
*
87-
* var arr = ndarray2array( out );
88-
* // returns [ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
8985
*/
9086
function assign( x ) {
9187
var nargs;

lib/node_modules/@stdlib/blas/ext/cusum/lib/base.js

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,6 @@ var options = {
7979
*
8080
* @example
8181
* var Float64Array = require( '@stdlib/array/float64' );
82-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
8382
* var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
8483
* var ndarray = require( '@stdlib/ndarray/ctor' );
8584
*
@@ -105,10 +104,7 @@ var options = {
105104
*
106105
* // Perform operation:
107106
* var out = cusum( x, initial );
108-
* // returns <ndarray>
109-
*
110-
* var arr = ndarray2array( out );
111-
* // returns [ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
107+
* // returns <ndarray>[ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
112108
*/
113109
var cusum = factory( table, [ idtypes0, idtypes1 ], odtypes, policies, options ); // eslint-disable-line max-len
114110

lib/node_modules/@stdlib/blas/ext/cusum/lib/index.js

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,6 @@
2626
* @example
2727
* var Float64Array = require( '@stdlib/array/float64' );
2828
* var ndarray = require( '@stdlib/ndarray/ctor' );
29-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
3029
* var cusum = require( '@stdlib/blas/ext/cusum' );
3130
*
3231
* // Create a data buffer:
@@ -46,10 +45,7 @@
4645
*
4746
* // Perform operation:
4847
* var out = cusum( x );
49-
* // returns <ndarray>
50-
*
51-
* var arr = ndarray2array( out );
52-
* // returns [ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
48+
* // returns <ndarray>[ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
5349
*/
5450

5551
// MODULES //

lib/node_modules/@stdlib/blas/ext/cusum/lib/main.js

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,6 @@ var base = require( './base.js' );
5454
*
5555
* @example
5656
* var Float64Array = require( '@stdlib/array/float64' );
57-
* var ndarray2array = require( '@stdlib/ndarray/to-array' );
5857
* var ndarray = require( '@stdlib/ndarray/ctor' );
5958
*
6059
* // Create a data buffer:
@@ -74,10 +73,7 @@ var base = require( './base.js' );
7473
*
7574
* // Perform operation:
7675
* var out = cusum( x );
77-
* // returns <ndarray>
78-
*
79-
* var arr = ndarray2array( out );
80-
* // returns [ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
76+
* // returns <ndarray>[ [ [ 1.0, 3.0 ] ], [ [ 0.0, 4.0 ] ], [ [ -1.0, 5.0 ] ] ]
8177
*/
8278
function cusum( x ) {
8379
var nargs;

0 commit comments

Comments
 (0)