README.md (3391B)
1 <!-- 2 3 @license Apache-2.0 4 5 Copyright (c) 2018 The Stdlib Authors. 6 7 Licensed under the Apache License, Version 2.0 (the "License"); 8 you may not use this file except in compliance with the License. 9 You may obtain a copy of the License at 10 11 http://www.apache.org/licenses/LICENSE-2.0 12 13 Unless required by applicable law or agreed to in writing, software 14 distributed under the License is distributed on an "AS IS" BASIS, 15 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 16 See the License for the specific language governing permissions and 17 limitations under the License. 18 19 --> 20 21 # Mode 22 23 > [Chi][chi-distribution] distribution [mode][mode]. 24 25 <!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. --> 26 27 <section class="intro"> 28 29 The [mode][mode] for a [chi][chi-distribution] random variable is 30 31 <!-- <equation class="equation" label="eq:chi_mode" align="center" raw="\operatorname{mode}\left( X \right) = \sqrt{k-1}" alt="Mode for a chi distribution."> --> 32 33 <div class="equation" align="center" data-raw-text="\operatorname{mode}\left( X \right) = \sqrt{k-1}" data-equation="eq:chi_mode"> 34 <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@51534079fef45e990850102147e8945fb023d1d0/lib/node_modules/@stdlib/stats/base/dists/chi/mode/docs/img/equation_chi_mode.svg" alt="Mode for a chi distribution."> 35 <br> 36 </div> 37 38 <!-- </equation> --> 39 40 for degrees of freedom `k >= 1`. For other values of `k`, the mode is not defined. 41 42 </section> 43 44 <!-- /.intro --> 45 46 <!-- Package usage documentation. --> 47 48 <section class="usage"> 49 50 ## Usage 51 52 ```javascript 53 var mode = require( '@stdlib/stats/base/dists/chi/mode' ); 54 ``` 55 56 #### mode( k ) 57 58 Returns the [mode][mode] of a [chi][chi-distribution] distribution with degrees of freedom `k`. 59 60 ```javascript 61 var v = mode( 9.0 ); 62 // returns ~2.828 63 64 v = mode( 1.5 ); 65 // returns ~0.707 66 ``` 67 68 If provided `k < 1`, the function returns `NaN`. 69 70 ```javascript 71 var v = mode( -1.0 ); 72 // returns NaN 73 74 v = mode( 0.9 ); 75 // returns NaN 76 ``` 77 78 </section> 79 80 <!-- /.usage --> 81 82 <!-- Package usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. --> 83 84 <section class="notes"> 85 86 </section> 87 88 <!-- /.notes --> 89 90 <!-- Package usage examples. --> 91 92 <section class="examples"> 93 94 ## Examples 95 96 <!-- eslint no-undef: "error" --> 97 98 ```javascript 99 var randu = require( '@stdlib/random/base/randu' ); 100 var round = require( '@stdlib/math/base/special/round' ); 101 var mode = require( '@stdlib/stats/base/dists/chi/mode' ); 102 103 var k; 104 var v; 105 var i; 106 107 for ( i = 0; i < 10; i++ ) { 108 k = randu() * 20.0; 109 v = mode( k ); 110 console.log( 'k: %d, mode(X,k): %d', k.toFixed( 4 ), v.toFixed( 4 ) ); 111 } 112 ``` 113 114 </section> 115 116 <!-- /.examples --> 117 118 <!-- Section to include cited references. If references are included, add a horizontal rule *before* the section. Make sure to keep an empty line after the `section` element and another before the `/section` close. --> 119 120 <section class="references"> 121 122 </section> 123 124 <!-- /.references --> 125 126 <!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. --> 127 128 <section class="links"> 129 130 [chi-distribution]: https://en.wikipedia.org/wiki/Chi_distribution 131 132 [mode]: https://en.wikipedia.org/wiki/Mode_%28statistics%29 133 134 </section> 135 136 <!-- /.links -->