Skip to content

Commit 1b4bf6c

Browse files
committed
chore: cleaning up
--- type: pre_commit_static_analysis_report description: Results of running static analysis checks when committing changes. report: - task: lint_filenames status: passed - task: lint_editorconfig status: passed - task: lint_markdown status: passed - task: lint_package_json status: na - task: lint_repl_help status: passed - task: lint_javascript_src status: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: passed - task: lint_javascript_tests status: na - task: lint_javascript_benchmarks status: na - task: lint_python status: na - task: lint_r status: na - task: lint_c_src status: na - task: lint_c_examples status: na - task: lint_c_benchmarks status: na - task: lint_c_tests_fixtures status: na - task: lint_shell status: na - task: lint_typescript_declarations status: passed - task: lint_typescript_tests status: na - task: lint_license_headers status: passed ---
1 parent 29ec292 commit 1b4bf6c

File tree

7 files changed

+29
-20
lines changed

7 files changed

+29
-20
lines changed

lib/node_modules/@stdlib/lapack/base/dlarf1f/README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ var out = dlarf1f( 'row-major', 'left', 4, 3, V, 1, 1.0, C, 3, work );
5858
The function has the following parameters:
5959

6060
- **order**: storage layout.
61-
- **side**: use `left` to form `H * C` and `right` to from `C * H`.
61+
- **side**: specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
6262
- **M**: number of rows in `C`.
6363
- **N**: number of columns in `C`.
6464
- **V**: the vector `v` in the representation of `H` as a [`Float64Array`][mdn-float64array].
@@ -68,6 +68,11 @@ The function has the following parameters:
6868
- **LDC**: stride of the first dimension of `C` (a.k.a., leading dimension of the matrix `C`).
6969
- **work**: workspace [`Float64Array`][mdn-float64array].
7070

71+
Based on the `side` of multiplication, the expected storage of the array changes:
72+
73+
- `work` should have `N` indexed elements if `side` = `left` and `M` indexed elements if `side` = `right`.
74+
- `V` should have `1 + (M-1) * abs(incv)` indexed elements if `side` = `left` and `1 + (N-1) * abs(incv)` indexed elements if `side` = `right`.
75+
7176
The sign of the increment parameter `incv` determines the order in which elements of `V` are accessed. For example, to access elements in reverse order,
7277

7378
<!-- eslint-disable max-len -->
@@ -138,7 +143,7 @@ var out = dlarf1f.ndarray( 'left', 4, 3, V, 1, 0, 1.0, C, 3, 1, 0, work, 1, 0 );
138143

139144
The function has the following additional parameters:
140145

141-
- **side**: use `left` to form `H * C` and `right` to from `C * H`.
146+
- **side**: specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
142147
- **M**: number of rows in `C`.
143148
- **N**: number of columns in `C`.
144149
- **V**: the vector `v` in the representation of `H` as a [`Float64Array`][mdn-float64array].
@@ -153,6 +158,11 @@ The function has the following additional parameters:
153158
- **sw**: stride length for `work`.
154159
- **ow**: starting index for `work`.
155160

161+
Based on the `side` of multiplication, the expected storage of the array changes:
162+
163+
- `work` should have `N` indexed elements if `side` = `left` and `M` indexed elements if `side` = `right`.
164+
- `V` should have `1 + (M-1) * abs(incv)` indexed elements if `side` = `left` and `1 + (N-1) * abs(incv)` indexed elements if `side` = `right`.
165+
156166
While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying buffer, the offset parameters support indexing semantics based on starting indices. For example,
157167

158168
<!-- eslint-disable max-len -->
@@ -176,8 +186,6 @@ var out = dlarf1f.ndarray( 'left', 4, 3, V, 1, 2, 1.0, C, 3, 1, 4, work, 1, 0 );
176186

177187
## Notes
178188

179-
- `work` should have `N` indexed elements if side = `left` and `M` indexed elements if side = `right`.
180-
- `V` should have `1 + (M-1) * abs(incv)` indexed elements if side = `left` and `1 + (N-1) * abs(incv)` indexed elements if side = `right`.
181189
- `C` is overwritten by `H * C` if side = `left` and `C * H` if side = `right`.
182190
- `dlarf1f()` corresponds to the [LAPACK][LAPACK] function [`dlarf1f`][lapack-dlarf1f].
183191

lib/node_modules/@stdlib/lapack/base/dlarf1f/docs/repl.txt

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11

22
{{alias}}( order, side, M, N, V, incv, tau, C, LDC, work )
3-
Applies a real elementary reflector `H = I - tau * v * v ^ T`
4-
to a real M by N matrix `C`.
3+
Applies a real elementary reflector `H = I - tau * v * v ^ T` to a
4+
real M by N matrix `C`.
55

66
Parameters
77
----------
88
order: string
99
Storage layout. Must be either 'row-major' or 'column-major'.
1010

1111
side: string
12-
Specifies whether to form `H * C` ('left') or
13-
`C * H` ('right').
12+
Specifies the side of multiplication with `C`. Use `left` to form
13+
`H * C` and `right` to from `C * H`.
1414

1515
M: integer
1616
Number of rows in `C`.
@@ -31,8 +31,8 @@
3131
Input matrix.
3232

3333
LDC: integer
34-
Stride of the first dimension of `C` (a.k.a., leading
35-
dimension of the matrix `C`).
34+
Stride of the first dimension of `C` (a.k.a., leading dimension
35+
of the matrix `C`).
3636

3737
work: Float64Array
3838
Workspace array.
@@ -52,13 +52,14 @@
5252

5353

5454
{{alias}}.ndarray( side, M, N, V, sv, ov, tau, C, sc1, sc2, oc, work, sw, ow )
55-
Applies a real elementary reflector `H = I - tau * v * v ^ T`
56-
to a real M by N matrix `C` using alternative indexing semantics.
55+
Applies a real elementary reflector `H = I - tau * v * v ^ T` to a real
56+
M by N matrix `C` using alternative indexing semantics.
5757

5858
Parameters
5959
----------
6060
side: string
61-
Specifies whether to form `H * C` ('left') or `C * H` ('right').
61+
Specifies the side of multiplication with `C`. Use `left` to form
62+
`H * C` and `right` to from `C * H`.
6263

6364
M: integer
6465
Number of rows in `C`.

lib/node_modules/@stdlib/lapack/base/dlarf1f/docs/types/index.d.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ interface Routine {
3030
/**
3131
* Applies a real elementary reflector `H = I - tau * v * v ^ T` to a real M by N matrix `C`.
3232
*
33-
* @param side - use `left` to form `H * C` and `right` to from `C * H`
33+
* @param side - specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
3434
* @param M - number of rows in `C`
3535
* @param N - number of columns in `C`
3636
* @param V - the vector `v` in the representation of `H`
@@ -56,7 +56,7 @@ interface Routine {
5656
/**
5757
* Applies a real elementary reflector `H = I - tau * v * v ^ T` to a real M by N matrix `C` using alternative indexing semantics.
5858
*
59-
* @param side - use `left` to form `H * C` and `right` to from `C * H`
59+
* @param side - specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
6060
* @param M - number of rows in `C`
6161
* @param N - number of columns in `C`
6262
* @param V - the vector `v` in the representation of `H`
@@ -88,7 +88,7 @@ interface Routine {
8888
/**
8989
* Applies a real elementary reflector `H = I - tau * v * v ^ T` to a real M by N matrix `C`.
9090
*
91-
* @param side - use `left` to form `H * C` and `right` to from `C * H`
91+
* @param side - specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
9292
* @param M - number of rows in `C`
9393
* @param N - number of columns in `C`
9494
* @param V - the vector `v` in the representation of `H`

lib/node_modules/@stdlib/lapack/base/dlarf1f/examples/index.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ var order = 'row-major';
2929
var strides = shape2strides( shape, order );
3030

3131
// Create a matrix stored in linear memory:
32-
var C = new Float64Array( [ 1.0, 5.0, 9.0, 2.0, 6.0, 10.0, 3.0, 7.0, 11.0, 4.0, 8.0, 12.0 ] );
32+
var C = new Float64Array( [ 1.0, 5.0, 9.0, 2.0, 6.0, 10.0, 3.0, 7.0, 11.0, 4.0, 8.0, 12.0 ] ); // eslint-disable-line max-len
3333
console.log( ndarray2array( C, shape, strides, 0, order ) );
3434

3535
// Define the vector `v` and workspace array:

lib/node_modules/@stdlib/lapack/base/dlarf1f/lib/base.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ var dscal = require( '@stdlib/blas/base/dscal' ).ndarray;
4242
* - `C` is overwritten by `H * C` if side = `left` and `C * H` if side = `right`.
4343
*
4444
* @private
45-
* @param {string} side - use `left` to form `H * C` and `right` to from `C * H`
45+
* @param {string} side - specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
4646
* @param {NonNegativeInteger} M - number of rows in `C`
4747
* @param {NonNegativeInteger} N - number of columns in `C`
4848
* @param {Float64Array} V - the vector `v` in the representation of `H`

lib/node_modules/@stdlib/lapack/base/dlarf1f/lib/dlarf1f.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ var base = require( './base.js' );
4141
* - `C` is overwritten by `H * C` if side = `left` and `C * H` if side = `right`.
4242
*
4343
* @param {string} order - storage layout
44-
* @param {string} side - use `left` to form `H * C` and `right` to from `C * H`
44+
* @param {string} side - specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
4545
* @param {NonNegativeInteger} M - number of rows in `C`
4646
* @param {NonNegativeInteger} N - number of columns in `C`
4747
* @param {Float64Array} V - the vector `v` in the representation of `H`

lib/node_modules/@stdlib/lapack/base/dlarf1f/lib/ndarray.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ var base = require( './base.js' );
3737
* - `V` should have `1 + (M-1) * abs(strideV)` indexed elements if side = `left` and `1 + (N-1) * abs(strideV)` indexed elements if side = `right`.
3838
* - `C` is overwritten by `H * C` if side = `left` and `C * H` if side = `right`.
3939
*
40-
* @param {string} side - use `left` to form `H * C` and `right` to from `C * H`
40+
* @param {string} side - specifies the side of multiplication with `C`. Use `left` to form `H * C` and `right` to from `C * H`.
4141
* @param {NonNegativeInteger} M - number of rows in `C`
4242
* @param {NonNegativeInteger} N - number of columns in `C`
4343
* @param {Float64Array} V - the vector `v` in the representation of `H`

0 commit comments

Comments
 (0)