\HeaderA{bounds}{Deterministic bounds for units satisfying row thresholds}{bounds}
\keyword{models}{bounds}
\begin{Description}\relax
Calculates the deterministic bounds on the proportion of
row members within a specified column.
\end{Description}
\begin{Usage}
\begin{verbatim}
bounds(formula, data, rows, column, excluded = NULL, 
    threshold = 0.9, total = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{formula}] a formula of the form \code{cbind(col1, col2, ...) \textasciitilde{}
      cbind(row1, row2, ...)}.  Column and row marginals must have the
same total for each ecological unit.
\item[\code{data}] a data frame containing the variables specified in
\code{formula} and (optionally) \code{total}
\item[\code{rows}] a character vector specifying the rows of interest
\item[\code{column}] a character string specifying the column marginal of
interest
\item[\code{excluded}] an optional character string (or vector of character
strings) specifying the columns to be excluded from the bounds
calculation.  For example, if the quantity of interest is Democratic
share of the two-party vote, non-voters would be excluded.
\item[\code{threshold}] the minimum proportion of the unit that row members must
comprise for the bounds to be calculated for the unit.  If
\code{threshold = 0}, bounds will be calculated for all units.
\item[\code{total}] if row and/or column marginals are given as proportions,
\code{total} identifies the name of the variable in \code{data} containing the
total number of individuals in each unit
\end{ldescription}
\end{Arguments}
\begin{Value}
A list with elements 
\begin{ldescription}
\item[\code{bounds}] a list of deterministic bounds for all units in which
row proportions meet the threshold
\item[\code{intersection}] if the intersection of the deterministic bounding
intervals is non-empty, the intersection is returned.  Otherwise,
\code{NA} is returned.
\end{ldescription}
\end{Value}
\begin{Author}\relax
Ryan T. Moore \textless{}\email{rtm@wustl.edu}\textgreater{}
\end{Author}
\begin{References}\relax
Otis Dudley Duncan and Beverley Davis.  1953.  ``An Alternative to Ecological
Correlation.'' \emph{American Sociological Review} 18: 665-666.
\end{References}
\begin{SeeAlso}\relax
\code{plot.bounds}
\end{SeeAlso}

