\HeaderA{build\_df}{Build data frame}{build.Rul.df}
\keyword{hplot}{build\_df}
\keyword{internal}{build\_df}
\begin{Description}\relax
Build data frome for a plot with given data and ... (dots) arguments
\end{Description}
\begin{Usage}
\begin{verbatim}build_df(plot, data, aesthetics)\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{plot}] plot object
\item[\code{data}] data frame to use
\item[\code{aesthetics}] extra arguments supplied by user that should be used first
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Depending on the arguments supplied to \code{\LinkA{plot\_add}{plot.Rul.add}} we need
to stitch together a data frame using the defaults from plot\$defaults
where the user hasn't explicitly specified otherwise.

Arguments in dots are evaluated in the context of \code{data} so that
column names can easily be references.

Also makes sure that it contains all the columns required to correctly
place the output into the row+column structure defined by the formula,
by using \code{\LinkA{expand.grid.df}{expand.grid.df}} to add in extra columns if needed.
\end{Details}
\begin{Author}\relax
Hadley Wickham <h.wickham@gmail.com>
\end{Author}
\begin{Examples}
\begin{ExampleCode}\end{ExampleCode}
\end{Examples}

