diff --git a/stats/base/dists/pareto-type1/stdev/coverage.ndjson b/stats/base/dists/pareto-type1/stdev/coverage.ndjson new file mode 100644 index 000000000..f07aab4f4 --- /dev/null +++ b/stats/base/dists/pareto-type1/stdev/coverage.ndjson @@ -0,0 +1 @@ +[203,203,100,12,12,100,2,2,100,203,203,100,"5ebf34e758b2a328d2f4d9fa3500cb0233c687cf","2024-12-17 08:57:00 -0500"] diff --git a/stats/base/dists/pareto-type1/stdev/index.html b/stats/base/dists/pareto-type1/stdev/index.html new file mode 100644 index 000000000..20e07f2ae --- /dev/null +++ b/stats/base/dists/pareto-type1/stdev/index.html @@ -0,0 +1,146 @@ + + + + +
++ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +File | ++ | Statements | ++ | Branches | ++ | Functions | ++ | Lines | ++ |
---|---|---|---|---|---|---|---|---|---|
index.js | +
+
+ |
+ 100% | +46/46 | +100% | +1/1 | +100% | +0/0 | +100% | +46/46 | +
main.js | +
+
+ |
+ 100% | +86/86 | +100% | +9/9 | +100% | +1/1 | +100% | +86/86 | +
native.js | +
+
+ |
+ 100% | +71/71 | +100% | +2/2 | +100% | +1/1 | +100% | +71/71 | +
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x + | /** +* @license Apache-2.0 +* +* Copyright (c) 2019 The Stdlib Authors. +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + +'use strict'; + +/** +* Pareto (Type I) distribution standard deviation. +* +* @module @stdlib/stats/base/dists/pareto-type1/stdev +* +* @example +* var stdev = require( '@stdlib/stats/base/dists/pareto-type1/stdev' ); +* +* var v = stdev( 4.0, 12.0 ); +* // returns 32.0 +* +* v = stdev( 8.0, 2.0 ); +* // returns ~0.109 +* +* v = stdev( 0.8, 1.0 ); +* // returns Infinity +*/ + +// MODULES // + +var main = require( './main.js' ); + + +// EXPORTS // + +module.exports = main; + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1015x +1015x +1015x +1015x +1015x +1015x +1006x +1015x +12x +12x +1015x +2x +2x +1001x +1001x +1015x +1x +1x +1x +1x +1x + | /** +* @license Apache-2.0 +* +* Copyright (c) 2019 The Stdlib Authors. +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + +'use strict'; + +// MODULES // + +var isnan = require( '@stdlib/math/base/assert/is-nan' ); +var sqrt = require( '@stdlib/math/base/special/sqrt' ); +var pow = require( '@stdlib/math/base/special/pow' ); +var PINF = require( '@stdlib/constants/float64/pinf' ); + + +// MAIN // + +/** +* Returns the standard deviation of a Pareto (Type I) distribution. +* +* @param {PositiveNumber} alpha - shape parameter +* @param {PositiveNumber} beta - scale parameter +* @returns {PositiveNumber} standard deviation +* +* @example +* var v = stdev( 4.0, 12.0 ); +* // returns ~5.657 +* +* @example +* var v = stdev( 8.0, 2.0 ); +* // returns ~0.33 +* +* @example +* var v = stdev( 1.0, 1.0 ); +* // returns Infinity +* +* @example +* var v = stdev( 1.0, -0.1 ); +* // returns NaN +* +* @example +* var v = stdev( -0.1, 1.0 ); +* // returns NaN +* +* @example +* var v = stdev( 2.0, NaN ); +* // returns NaN +* +* @example +* var v = stdev( NaN, 2.0 ); +* // returns NaN +*/ +function stdev( alpha, beta ) { + var out; + if ( + isnan( alpha ) || + alpha <= 0.0 || + isnan( beta ) || + beta <= 0.0 + ) { + return NaN; + } + if ( alpha < 2.0 ) { + return PINF; + } + out = ( (beta*beta) * alpha ) / ( pow( alpha-1.0, 2.0 ) * ( alpha-2.0 ) ); + return sqrt( out ); +} + + +// EXPORTS // + +module.exports = stdev; + |
+ Press n or j to go to the next uncovered block, b, p or k for the previous block. +
+ +1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 | 1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1x +1015x +1015x +1015x +1x +1x +1x +1x +1x + | /** +* @license Apache-2.0 +* +* Copyright (c) 2024 The Stdlib Authors. +* +* Licensed under the Apache License, Version 2.0 (the "License"); +* you may not use this file except in compliance with the License. +* You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ + +'use strict'; + +// MODULES // + +var addon = require( './../src/addon.node' ); + + +// MAIN // + +/** +* Returns the standard deviation of a Pareto (Type I) distribution. +* +* @private +* @param {PositiveNumber} alpha - shape parameter +* @param {PositiveNumber} beta - scale parameter +* @returns {PositiveNumber} standard deviation +* +* @example +* var v = stdev( 4.0, 12.0 ); +* // returns ~5.657 +* +* @example +* var v = stdev( 8.0, 2.0 ); +* // returns ~0.33 +* +* @example +* var v = stdev( 1.0, 1.0 ); +* // returns Infinity +* +* @example +* var v = stdev( 1.0, -0.1 ); +* // returns NaN +* +* @example +* var v = stdev( -0.1, 1.0 ); +* // returns NaN +* +* @example +* var v = stdev( 2.0, NaN ); +* // returns NaN +* +* @example +* var v = stdev( NaN, 2.0 ); +* // returns NaN +*/ +function stdev( alpha, beta ) { + return addon( alpha, beta ); +} + + +// EXPORTS // + +module.exports = stdev; + |