From 796e665cdad379916056b6dea696c3c08d3265bb Mon Sep 17 00:00:00 2001 From: stdlib-bot <82920195+stdlib-bot@users.noreply.github.com> Date: Thu, 20 Feb 2025 02:25:10 +0000 Subject: [PATCH 1/3] docs: update related packages sections --- .../@stdlib/blas/ext/base/ssort2ins/README.md | 131 ------------------ .../@stdlib/constants/float32/e/README.md | 12 ++ .../@stdlib/number/float64/base/mul/README.md | 6 - 3 files changed, 12 insertions(+), 137 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md b/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md index 78476fc5da7f..6f891c574113 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md @@ -193,137 +193,6 @@ console.log( y ); * * * - - -
- -## C APIs - - - -
- -
- - - - - -
- -### Usage - -```c -#include "stdlib/blas/ext/base/ssort2ins.h" -``` - -#### stdlib_strided_ssort2ins( N, order, \*X, strideX, \*Y, strideY ) - -Simultaneously sorts two single-precision floating-point strided arrays based on the sort order of the first array using insertion sort. - -```c -float x[] = { 1.0f, -2.0f, 3.0f, -4.0f }; -float y[] = { 0.0f, 1.0f, 2.0f, 3.0f }; - -stdlib_strided_ssort2ins( 4, 1.0f, x, 1, y, 1 ); -``` - -The function accepts the following arguments: - -- **N**: `[in] CBLAS_INT` number of indexed elements. -- **order**: `[in] float` sort order. If `order < 0.0`, the input strided array `X` is sorted in **decreasing** order. If `order > 0.0`, the input strided array `X` is sorted in **increasing** order. If `order == 0.0`, the input strided arrays are left unchanged. -- **X**: `[inout] float*` first input array. -- **strideX**: `[in] CBLAS_INT` stride length for `X`. -- **Y**: `[inout] float*` second input array. -- **strideY**: `[in] CBLAS_INT` stride length for `Y`. - -```c -stdlib_strided_ssort2ins( const CBLAS_INT N, const float order, float *X, const CBLAS_INT strideX, float *Y, const CBLAS_INT strideY ); -``` - - - -#### stdlib_strided_ssort2ins_ndarray( N, order, \*X, strideX, offsetX, \*Y, strideY, offsetY ) - - - -Simultaneously sorts two single-precision floating-point strided arrays based on the sort order of the first array using insertion sort and alternative indexing semantics. - -```c -float x[] = { 1.0f, -2.0f, 3.0f, -4.0f }; -float y[] = { 0.0f, 1.0f, 2.0f, 3.0f }; - -stdlib_strided_ssort2ins_ndarray( 4, 1.0f, x, 1, 0, y, 1, 0 ); -``` - -The function accepts the following arguments: - -- **N**: `[in] CBLAS_INT` number of indexed elements. -- **order**: `[in] float` sort order. If `order < 0.0`, the input strided array `X` is sorted in **decreasing** order. If `order > 0.0`, the input strided array `X` is sorted in **increasing** order. If `order == 0.0`, the input strided arrays are left unchanged. -- **X**: `[inout] float*` first input array. -- **strideX**: `[in] CBLAS_INT` stride length for `X`. -- **offsetX**: `[in] CBLAS_INT` starting index for `X`. -- **Y**: `[inout] float*` second input array. -- **strideY**: `[in] CBLAS_INT` stride length for `Y`. -- **offsetY**: `[in] CBLAS_INT` starting index for `Y`. - -```c -stdlib_strided_ssort2ins_ndarray( const CBLAS_INT N, const float order, float *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, float *Y, const CBLAS_INT strideY, const CBLAS_INT offsetY ); -``` - -
- - - - - -
- -
- - - - - -
- -### Examples - -```c -#include "stdlib/blas/ext/base/ssort2ins.h" -#include - -int main( void ) { - // Create strided arrays: - float x[] = { 1.0f, -2.0f, 3.0f, -4.0f, 5.0f, -6.0f, 7.0f, -8.0f }; - float y[] = { 0.0f, 1.0f, 2.0f, 3.0f, 4.0f, 5.0f, 6.0f, 7.0f }; - - // Specify the number of elements: - int N = 8; - - // Specify the strides: - int strideX = 1; - int strideY = 1; - - // Sort the arrays: - stdlib_strided_ssort2ins( N, 1.0f, x, strideX, y, strideY ); - - // Print the result: - for ( int i = 0; i < 8; i++ ) { - printf( "x[ %i ] = %f\n", i, x[ i ] ); - printf( "y[ %i ] = %f\n", i, y[ i ] ); - } -} -``` - -
- - - -
- - - ## See Also - [`@stdlib/blas/ext/base/dsort2ins`][@stdlib/blas/ext/base/dsort2ins]: simultaneously sort two double-precision floating-point strided arrays based on the sort order of the first array using insertion sort. diff --git a/lib/node_modules/@stdlib/constants/float32/e/README.md b/lib/node_modules/@stdlib/constants/float32/e/README.md index 08480086c0f8..30c74a9f504e 100644 --- a/lib/node_modules/@stdlib/constants/float32/e/README.md +++ b/lib/node_modules/@stdlib/constants/float32/e/README.md @@ -120,6 +120,12 @@ Macro for Euler's number. @@ -130,6 +136,12 @@ Macro for Euler's number. [e]: https://en.wikipedia.org/wiki/E_%28mathematical_constant%29 + + +[@stdlib/constants/float64/e]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/constants/float64/e + + + diff --git a/lib/node_modules/@stdlib/number/float64/base/mul/README.md b/lib/node_modules/@stdlib/number/float64/base/mul/README.md index b7afa48152b6..2c1cbc1e3023 100644 --- a/lib/node_modules/@stdlib/number/float64/base/mul/README.md +++ b/lib/node_modules/@stdlib/number/float64/base/mul/README.md @@ -209,12 +209,6 @@ int main( void ) { -[@stdlib/number/float64/base/add]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/number/float64/base/add - -[@stdlib/number/float64/base/div]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/number/float64/base/div - -[@stdlib/math/base/ops/sub]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/ops/sub - From d57780a94e62f172bfebd5f02866d3f18143dc93 Mon Sep 17 00:00:00 2001 From: Athan Date: Wed, 19 Feb 2025 19:52:49 -0800 Subject: [PATCH 2/3] Discard changes to lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md --- .../@stdlib/blas/ext/base/ssort2ins/README.md | 131 ++++++++++++++++++ 1 file changed, 131 insertions(+) diff --git a/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md b/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md index 6f891c574113..78476fc5da7f 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/ssort2ins/README.md @@ -193,6 +193,137 @@ console.log( y ); * * * + + +
+ +## C APIs + + + +
+ +
+ + + + + +
+ +### Usage + +```c +#include "stdlib/blas/ext/base/ssort2ins.h" +``` + +#### stdlib_strided_ssort2ins( N, order, \*X, strideX, \*Y, strideY ) + +Simultaneously sorts two single-precision floating-point strided arrays based on the sort order of the first array using insertion sort. + +```c +float x[] = { 1.0f, -2.0f, 3.0f, -4.0f }; +float y[] = { 0.0f, 1.0f, 2.0f, 3.0f }; + +stdlib_strided_ssort2ins( 4, 1.0f, x, 1, y, 1 ); +``` + +The function accepts the following arguments: + +- **N**: `[in] CBLAS_INT` number of indexed elements. +- **order**: `[in] float` sort order. If `order < 0.0`, the input strided array `X` is sorted in **decreasing** order. If `order > 0.0`, the input strided array `X` is sorted in **increasing** order. If `order == 0.0`, the input strided arrays are left unchanged. +- **X**: `[inout] float*` first input array. +- **strideX**: `[in] CBLAS_INT` stride length for `X`. +- **Y**: `[inout] float*` second input array. +- **strideY**: `[in] CBLAS_INT` stride length for `Y`. + +```c +stdlib_strided_ssort2ins( const CBLAS_INT N, const float order, float *X, const CBLAS_INT strideX, float *Y, const CBLAS_INT strideY ); +``` + + + +#### stdlib_strided_ssort2ins_ndarray( N, order, \*X, strideX, offsetX, \*Y, strideY, offsetY ) + + + +Simultaneously sorts two single-precision floating-point strided arrays based on the sort order of the first array using insertion sort and alternative indexing semantics. + +```c +float x[] = { 1.0f, -2.0f, 3.0f, -4.0f }; +float y[] = { 0.0f, 1.0f, 2.0f, 3.0f }; + +stdlib_strided_ssort2ins_ndarray( 4, 1.0f, x, 1, 0, y, 1, 0 ); +``` + +The function accepts the following arguments: + +- **N**: `[in] CBLAS_INT` number of indexed elements. +- **order**: `[in] float` sort order. If `order < 0.0`, the input strided array `X` is sorted in **decreasing** order. If `order > 0.0`, the input strided array `X` is sorted in **increasing** order. If `order == 0.0`, the input strided arrays are left unchanged. +- **X**: `[inout] float*` first input array. +- **strideX**: `[in] CBLAS_INT` stride length for `X`. +- **offsetX**: `[in] CBLAS_INT` starting index for `X`. +- **Y**: `[inout] float*` second input array. +- **strideY**: `[in] CBLAS_INT` stride length for `Y`. +- **offsetY**: `[in] CBLAS_INT` starting index for `Y`. + +```c +stdlib_strided_ssort2ins_ndarray( const CBLAS_INT N, const float order, float *X, const CBLAS_INT strideX, const CBLAS_INT offsetX, float *Y, const CBLAS_INT strideY, const CBLAS_INT offsetY ); +``` + +
+ + + + + +
+ +
+ + + + + +
+ +### Examples + +```c +#include "stdlib/blas/ext/base/ssort2ins.h" +#include + +int main( void ) { + // Create strided arrays: + float x[] = { 1.0f, -2.0f, 3.0f, -4.0f, 5.0f, -6.0f, 7.0f, -8.0f }; + float y[] = { 0.0f, 1.0f, 2.0f, 3.0f, 4.0f, 5.0f, 6.0f, 7.0f }; + + // Specify the number of elements: + int N = 8; + + // Specify the strides: + int strideX = 1; + int strideY = 1; + + // Sort the arrays: + stdlib_strided_ssort2ins( N, 1.0f, x, strideX, y, strideY ); + + // Print the result: + for ( int i = 0; i < 8; i++ ) { + printf( "x[ %i ] = %f\n", i, x[ i ] ); + printf( "y[ %i ] = %f\n", i, y[ i ] ); + } +} +``` + +
+ + + +
+ + + ## See Also - [`@stdlib/blas/ext/base/dsort2ins`][@stdlib/blas/ext/base/dsort2ins]: simultaneously sort two double-precision floating-point strided arrays based on the sort order of the first array using insertion sort. From 1f196bd2b1a0715eeae3ed9c70c531f53e3f8fb2 Mon Sep 17 00:00:00 2001 From: Athan Date: Wed, 19 Feb 2025 19:53:33 -0800 Subject: [PATCH 3/3] Discard changes to lib/node_modules/@stdlib/number/float64/base/mul/README.md --- lib/node_modules/@stdlib/number/float64/base/mul/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/lib/node_modules/@stdlib/number/float64/base/mul/README.md b/lib/node_modules/@stdlib/number/float64/base/mul/README.md index 2c1cbc1e3023..b7afa48152b6 100644 --- a/lib/node_modules/@stdlib/number/float64/base/mul/README.md +++ b/lib/node_modules/@stdlib/number/float64/base/mul/README.md @@ -209,6 +209,12 @@ int main( void ) { +[@stdlib/number/float64/base/add]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/number/float64/base/add + +[@stdlib/number/float64/base/div]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/number/float64/base/div + +[@stdlib/math/base/ops/sub]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/ops/sub +