You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: lib/node_modules/@stdlib/stats/base/README.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -228,7 +228,7 @@ The namespace contains the following statistical functions:
228
228
- <spanclass="signature">[`sstdev( N, correction, x, stride )`][@stdlib/stats/base/sstdev]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array.</span>
229
229
- <spanclass="signature">[`sstdevch( N, correction, x, strideX )`][@stdlib/stats/strided/sstdevch]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass trial mean algorithm.</span>
230
230
- <spanclass="signature">[`sstdevpn( N, correction, x, strideX )`][@stdlib/stats/strided/sstdevpn]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a two-pass algorithm.</span>
231
-
- <spanclass="signature">[`sstdevtk( N, correction, x, strideX )`][@stdlib/stats/base/sstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
231
+
- <spanclass="signature">[`sstdevtk( N, correction, x, strideX )`][@stdlib/stats/strided/sstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
232
232
- <spanclass="signature">[`sstdevwd( N, correction, x, stride )`][@stdlib/stats/base/sstdevwd]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using Welford's algorithm.</span>
233
233
- <spanclass="signature">[`sstdevyc( N, correction, x, strideX )`][@stdlib/stats/base/sstdevyc]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass algorithm proposed by Youngs and Cramer.</span>
234
234
- <spanclass="signature">[`stdev( N, correction, x, stride )`][@stdlib/stats/base/stdev]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a strided array.</span>
Copy file name to clipboardExpand all lines: lib/node_modules/@stdlib/stats/base/snanstdevtk/README.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -247,7 +247,7 @@ console.log( v );
247
247
- <spanclass="package-name">[`@stdlib/stats/base/nanstdevtk`][@stdlib/stats/base/nanstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a strided array ignoring NaN values and using a one-pass textbook algorithm.</span>
248
248
- <spanclass="package-name">[`@stdlib/stats/base/snanstdev`][@stdlib/stats/base/snanstdev]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array ignoring NaN values.</span>
249
249
- <spanclass="package-name">[`@stdlib/stats/base/snanvariancetk`][@stdlib/stats/base/snanvariancetk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the variance of a single-precision floating-point strided array ignoring NaN values and using a one-pass textbook algorithm.</span>
250
-
- <spanclass="package-name">[`@stdlib/stats/base/sstdevtk`][@stdlib/stats/base/sstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
250
+
- <spanclass="package-name">[`@stdlib/stats/strided/sstdevtk`][@stdlib/stats/strided/sstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
Copy file name to clipboardExpand all lines: lib/node_modules/@stdlib/stats/base/stdevtk/README.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -183,7 +183,7 @@ var v = stdevtk.ndarray( N, 1, x, 2, 1 );
183
183
- If `N <= 0`, both functions return `NaN`.
184
184
- If `N - c` is less than or equal to `0` (where `c` corresponds to the provided degrees of freedom adjustment), both functions return `NaN`.
185
185
- Some caution should be exercised when using the one-pass textbook algorithm. Literature overwhelmingly discourages the algorithm's use for two reasons: 1) the lack of safeguards against underflow and overflow and 2) the risk of catastrophic cancellation when subtracting the two sums if the sums are large and the variance small. These concerns have merit; however, the one-pass textbook algorithm should not be dismissed outright. For data distributions with a moderately large standard deviation to mean ratio (i.e., **coefficient of variation**), the one-pass textbook algorithm may be acceptable, especially when performance is paramount and some precision loss is acceptable (including a risk of computing a negative variance due to floating-point rounding errors!). In short, no single "best" algorithm for computing the standard deviation exists. The "best" algorithm depends on the underlying data distribution, your performance requirements, and your minimum precision requirements. When evaluating which algorithm to use, consider the relative pros and cons, and choose the algorithm which best serves your needs.
186
-
- Depending on the environment, the typed versions ([`dstdevtk`][@stdlib/stats/strided/dstdevtk], [`sstdevtk`][@stdlib/stats/base/sstdevtk], etc.) are likely to be significantly more performant.
186
+
- Depending on the environment, the typed versions ([`dstdevtk`][@stdlib/stats/strided/dstdevtk], [`sstdevtk`][@stdlib/stats/strided/sstdevtk], etc.) are likely to be significantly more performant.
187
187
188
188
</section>
189
189
@@ -240,7 +240,7 @@ console.log( v );
240
240
241
241
- <spanclass="package-name">[`@stdlib/stats/strided/dstdevtk`][@stdlib/stats/strided/dstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a double-precision floating-point strided array using a one-pass textbook algorithm.</span>
242
242
- <spanclass="package-name">[`@stdlib/stats/base/nanstdevtk`][@stdlib/stats/base/nanstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a strided array ignoring NaN values and using a one-pass textbook algorithm.</span>
243
-
- <spanclass="package-name">[`@stdlib/stats/base/sstdevtk`][@stdlib/stats/base/sstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
243
+
- <spanclass="package-name">[`@stdlib/stats/strided/sstdevtk`][@stdlib/stats/strided/sstdevtk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
244
244
- <spanclass="package-name">[`@stdlib/stats/base/stdev`][@stdlib/stats/base/stdev]</span><spanclass="delimiter">: </span><spanclass="description">calculate the standard deviation of a strided array.</span>
245
245
- <spanclass="package-name">[`@stdlib/stats/base/variancetk`][@stdlib/stats/base/variancetk]</span><spanclass="delimiter">: </span><spanclass="description">calculate the variance of a strided array using a one-pass textbook algorithm.</span>
Copy file name to clipboardExpand all lines: lib/node_modules/@stdlib/stats/base/svariancetk/README.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -381,7 +381,7 @@ int main( void ) {
381
381
382
382
- <span class="package-name">[`@stdlib/stats/strided/dvariancetk`][@stdlib/stats/strided/dvariancetk]</span><span class="delimiter">: </span><span class="description">calculate the variance of a double-precision floating-point strided array using a one-pass textbook algorithm.</span>
383
383
- <span class="package-name">[`@stdlib/stats/base/snanvariancetk`][@stdlib/stats/base/snanvariancetk]</span><span class="delimiter">: </span><span class="description">calculate the variance of a single-precision floating-point strided array ignoring NaN values and using a one-pass textbook algorithm.</span>
384
-
- <span class="package-name">[`@stdlib/stats/base/sstdevtk`][@stdlib/stats/base/sstdevtk]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
384
+
- <span class="package-name">[`@stdlib/stats/strided/sstdevtk`][@stdlib/stats/strided/sstdevtk]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
385
385
- <span class="package-name">[`@stdlib/stats/base/svariance`][@stdlib/stats/base/svariance]</span><span class="delimiter">: </span><span class="description">calculate the variance of a single-precision floating-point strided array.</span>
386
386
- <span class="package-name">[`@stdlib/stats/base/variancetk`][@stdlib/stats/base/variancetk]</span><span class="delimiter">: </span><span class="description">calculate the variance of a strided array using a one-pass textbook algorithm.</span>
Copy file name to clipboardExpand all lines: lib/node_modules/@stdlib/stats/strided/dstdevtk/README.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -352,7 +352,7 @@ int main( void ) {
352
352
- <span class="package-name">[`@stdlib/stats/strided/dnanstdevtk`][@stdlib/stats/strided/dnanstdevtk]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a double-precision floating-point strided array ignoring NaN values and using a one-pass textbook algorithm.</span>
353
353
- <span class="package-name">[`@stdlib/stats/base/dstdev`][@stdlib/stats/base/dstdev]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a double-precision floating-point strided array.</span>
354
354
- <span class="package-name">[`@stdlib/stats/strided/dvariancetk`][@stdlib/stats/strided/dvariancetk]</span><span class="delimiter">: </span><span class="description">calculate the variance of a double-precision floating-point strided array using a one-pass textbook algorithm.</span>
355
-
- <span class="package-name">[`@stdlib/stats/base/sstdevtk`][@stdlib/stats/base/sstdevtk]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
355
+
- <span class="package-name">[`@stdlib/stats/strided/sstdevtk`][@stdlib/stats/strided/sstdevtk]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a single-precision floating-point strided array using a one-pass textbook algorithm.</span>
356
356
- <span class="package-name">[`@stdlib/stats/base/stdevtk`][@stdlib/stats/base/stdevtk]</span><span class="delimiter">: </span><span class="description">calculate the standard deviation of a strided array using a one-pass textbook algorithm.</span>
0 commit comments