man/theta.k.Rd

   1 \name{theta.k}
   2 \alias{theta.k}
   3 \title{Population Parameter THETA using Expected Number of Alleles}
   4 \usage{
   5 theta.k(x, n = NULL, k = NULL)
   6 }
   7 \arguments{
   8   \item{x}{a vector or a factor.}
   9   \item{n}{a numeric giving the sample size.}
  10   \item{k}{a numeric giving the number of alleles.}
  11 }
  12 \description{
  13   This function computes the population parameter THETA using the
  14   expected number of alleles.
  15 }
  16 \value{
  17   a numeric vector of length one with the estimated theta.
  18 }
  19 \details{
  20   This function can be used in two ways: either with a vector giving the
  21   individual genotypes from which the sample size and number of alleles
  22   are derived (\code{theta.k(x)}), or giving directly these two
  23   quantities (\code{theta.k(n, k)}).
  24
  25   The argument \code{x} can be either a factor or a vector. If it is a
  26   factor, then it is taken to give the individual alleles in the
  27   population. If it is a numeric vector, then its values are taken to be
  28   the numbers of each allele in the population. If it is a non-numeric
  29   vector, it is a coerced as a factor.
  30
  31   Both arguments \code{n} and \code{k} must be single numeric values.
  32 }
  33 \note{
  34   For the moment, no standard-error or confidence interval is computed.
  35 }
  36 \references{
  37   Ewens, W. J. (1972) The sampling theory of selectively neutral
  38   alleles. \emph{Theoretical Population Biology}, \bold{3}, 87--112.
  39 }
  40 \author{Emmanuel Paradis \email{Emmanuel.Paradis@mpl.ird.fr}}
  41 \seealso{
  42   \code{\link{theta.h}}, \code{\link{theta.s}}
  43 }
  44 \keyword{manip}
  45 \keyword{univar}