File: The-Multinomial-Distribution.html

package info (click to toggle)
gsl-ref-html 2.3-1
links: PTS
area: non-free
in suites: bookworm, bullseye, buster, forky, sid, trixie
size: 6,876 kB
ctags: 4,574
sloc: makefile: 35
file content (118 lines) | stat: -rw-r--r-- 6,076 bytes
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".

(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library &ndash; Reference Manual: The Multinomial Distribution</title>

<meta name="description" content="GNU Scientific Library &ndash; Reference Manual: The Multinomial Distribution">
<meta name="keywords" content="GNU Scientific Library &ndash; Reference Manual: The Multinomial Distribution">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Random-Number-Distributions.html#Random-Number-Distributions" rel="up" title="Random Number Distributions">
<link href="The-Negative-Binomial-Distribution.html#The-Negative-Binomial-Distribution" rel="next" title="The Negative Binomial Distribution">
<link href="The-Binomial-Distribution.html#The-Binomial-Distribution" rel="previous" title="The Binomial Distribution">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="The-Multinomial-Distribution"></a>
<div class="header">
<p>
Next: <a href="The-Negative-Binomial-Distribution.html#The-Negative-Binomial-Distribution" accesskey="n" rel="next">The Negative Binomial Distribution</a>, Previous: <a href="The-Binomial-Distribution.html#The-Binomial-Distribution" accesskey="p" rel="previous">The Binomial Distribution</a>, Up: <a href="Random-Number-Distributions.html#Random-Number-Distributions" accesskey="u" rel="up">Random Number Distributions</a> &nbsp; [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Multinomial-Distribution-1"></a>
<h3 class="section">20.33 The Multinomial Distribution</h3>
<dl>
<dt><a name="index-gsl_005fran_005fmultinomial"></a>Function: <em>void</em> <strong>gsl_ran_multinomial</strong> <em>(const gsl_rng * <var>r</var>, size_t <var>K</var>, unsigned int <var>N</var>, const double <var>p</var>[], unsigned int <var>n</var>[])</em></dt>
<dd><a name="index-Multinomial-distribution"></a>

<p>This function computes a random sample <var>n</var>[] from the multinomial
distribution formed by <var>N</var> trials from an underlying distribution
<var>p</var>[<var>K</var>]. The distribution function for <var>n</var>[] is,
</p>
<div class="example">
<pre class="example">P(n_1, n_2, ..., n_K) = 
  (N!/(n_1! n_2! ... n_K!)) p_1^n_1 p_2^n_2 ... p_K^n_K
</pre></div>

<p>where <em>(n_1, n_2, ..., n_K)</em> 
are nonnegative integers with 
<em>sum_{k=1}^K n_k = N</em>,
and
<em>(p_1, p_2, ..., p_K)</em>
is a probability distribution with <em>\sum p_i = 1</em>.  
If the array <var>p</var>[<var>K</var>] is not normalized then its entries will be
treated as weights and normalized appropriately.  The arrays <var>n</var>[]
and <var>p</var>[] must both be of length <var>K</var>.
</p>
<p>Random variates are generated using the conditional binomial method (see
C.S. Davis, <cite>The computer generation of multinomial random
variates</cite>, Comp. Stat. Data Anal. 16 (1993) 205&ndash;217 for details).
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fran_005fmultinomial_005fpdf"></a>Function: <em>double</em> <strong>gsl_ran_multinomial_pdf</strong> <em>(size_t <var>K</var>, const double <var>p</var>[], const unsigned int <var>n</var>[]) </em></dt>
<dd><p>This function computes the probability 
<em>P(n_1, n_2, ..., n_K)</em>
of sampling <var>n</var>[<var>K</var>] from a multinomial distribution 
with parameters <var>p</var>[<var>K</var>], using the formula given above.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fran_005fmultinomial_005flnpdf"></a>Function: <em>double</em> <strong>gsl_ran_multinomial_lnpdf</strong> <em>(size_t <var>K</var>, const double <var>p</var>[], const unsigned int <var>n</var>[]) </em></dt>
<dd><p>This function returns the logarithm of the probability for the
multinomial distribution <em>P(n_1, n_2, ..., n_K)</em> with parameters <var>p</var>[<var>K</var>].
</p></dd></dl>




</body>
</html>