.. _variables-hypergeometric_uncertain: """""""""""""""""""""""" hypergeometric_uncertain """""""""""""""""""""""" Aleatory uncertain discrete variable - hypergeometric **Topics** - :ref:`discrete_variables ` - :ref:`aleatory_uncertain_variables ` .. toctree:: :hidden: :maxdepth: 1 variables-hypergeometric_uncertain-total_population variables-hypergeometric_uncertain-selected_population variables-hypergeometric_uncertain-num_drawn variables-hypergeometric_uncertain-initial_point variables-hypergeometric_uncertain-descriptors **Specification** - *Alias:* None - *Arguments:* INTEGER - *JSON argument key:* count **Child Keywords:** +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required/Optional | Description of Group | JSON Group Key | Dakota Keyword | Dakota Keyword Description | +=========================+========================+====================+================================+============================================================+ | Required | | | `total_population`__ | Parameter for the hypergeometric probability distribution | | | | | | describing the size of the total population | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required | | | `selected_population`__ | Distribution parameter for the hypergeometric distribution | | | | | | describing the size of the population subset of interest | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required | | | `num_drawn`__ | Distribution parameter for the hypergeometric distribution | | | | | | describing the number of draws from a combined population | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `initial_point`__ | Initial values for variables | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `descriptors`__ | Labels for the variables | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: variables-hypergeometric_uncertain-total_population.html __ variables-hypergeometric_uncertain-selected_population.html __ variables-hypergeometric_uncertain-num_drawn.html __ variables-hypergeometric_uncertain-initial_point.html __ variables-hypergeometric_uncertain-descriptors.html **Description** The hypergeometric probability density is used when sampling without replacement from a total population of elements where - The resulting element of each sample can be separated into one of two non-overlapping sets - The probability of success changes with each sample. The density function for the hypergeometric distribution is given by: .. math:: f(x) = \frac{\left(\begin{array}{c}m\\x\end{array}\right)\left(\begin{array}{c}{N-m}\\{n-x}\end{array}\right)}{\left(\begin{array}{c}N\\n\end{array}\right)}, where the three distribution parameters are: - :math:`N`: the total population - :math:`m`: the number of items in the selected population (e.g. the number of white balls in the full urn of :math:`N` items) - :math:`n` the size of the sample drawn (e.g. number of balls drawn) In addition, - :math:`x`, the abscissa of the density function, indicates the number of successes (e.g. drawing a white ball) - :math:`\left(\begin{array}{c}a\\b\end{array}\right)` indicates a binomial coefficient ("a choose b") **Theory** The hypergeometric is often described using an urn model. For example, say we have a total population containing :math:`N` balls, and we know that :math:`m` of the balls are white and the remaining balls are green. If we draw :math:`n` balls from the urn without replacement, the hypergeometric distribution describes the probability of drawing :math:`x` white balls.