1% Generated by roxygen2: do not edit by hand
2% Please edit documentation in R/model-normal-survey.R
3\docType{class}
4\name{Zelig-normal-survey-class}
5\alias{Zelig-normal-survey-class}
6\alias{znormalsurvey}
7\title{Normal Regression for Continuous Dependent Variables with Survey Weights}
8\arguments{
9\item{formula}{a symbolic representation of the model to be
10estimated, in the form \code{y \~\, x1 + x2}, where \code{y} is the
11dependent variable and \code{x1} and \code{x2} are the explanatory
12variables, and \code{y}, \code{x1}, and \code{x2} are contained in the
13same dataset. (You may include more than two explanatory variables,
14of course.) The \code{+} symbol means ``inclusion'' not
15``addition.'' You may also include interaction terms and main
16effects in the form \code{x1*x2} without computing them in prior
17steps; \code{I(x1*x2)} to include only the interaction term and
18exclude the main effects; and quadratic terms in the form
19\code{I(x1^2)}.}
20
21\item{model}{the name of a statistical model to estimate.
22For a list of other supported models and their documentation see:
23\url{http://docs.zeligproject.org/articles/}.}
24
25\item{data}{the name of a data frame containing the variables
26referenced in the formula or a list of multiply imputed data frames
27each having the same variable names and row numbers (created by
28\code{Amelia} or \code{\link{to_zelig_mi}}).}
29
30\item{...}{additional arguments passed to \code{zelig},
31relevant for the model to be estimated.}
32
33\item{by}{a factor variable contained in \code{data}. If supplied,
34\code{zelig} will subset
35the data frame based on the levels in the \code{by} variable, and
36estimate a model for each subset. This can save a considerable amount of
37effort. You may also use \code{by} to run models using MatchIt
38subclasses.}
39
40\item{cite}{If is set to 'TRUE' (default), the model citation will be printed
41to the console.}
42}
43\value{
44Depending on the class of model selected, \code{zelig} will return
45  an object with elements including \code{coefficients}, \code{residuals},
46  and \code{formula} which may be summarized using
47  \code{summary(z.out)} or individually extracted using, for example,
48  \code{coef(z.out)}. See
49  \url{http://docs.zeligproject.org/articles/getters.html} for a list of
50  functions to extract model components. You can also extract whole fitted
51  model objects using \code{\link{from_zelig_model}}.
52}
53\description{
54Normal Regression for Continuous Dependent Variables with Survey Weights
55}
56\details{
57Additional parameters avaialable to this model include:
58\itemize{
59  \item \code{weights}: vector of weight values or a name of a variable in the dataset
60  by which to weight the model. For more information see:
61  \url{http://docs.zeligproject.org/articles/weights.html}.
62  \item \code{bootstrap}: logical or numeric. If \code{FALSE} don't use bootstraps to
63  robustly estimate uncertainty around model parameters due to sampling error.
64  If an integer is supplied, the number of boostraps to run.
65  For more information see:
66  \url{http://docs.zeligproject.org/articles/bootstraps.html}.
67}
68}
69
70\examples{
71library(Zelig)
72data(api, package = "survey")
73z.out1 <- zelig(api00 ~ meals + yr.rnd, model = "normal.survey",eights = ~pw, data = apistrat)
74summary(z.out1)
75
76}
77\seealso{
78Vignette: \url{http://docs.zeligproject.org/articles/zelig_normalsurvey.html}
79}
80