update

Former-commit-id: bdede6ed1b6f578f2ef046c338caf02d0b29d453 [formerly 7187de361b53e9c8ec121df379b762f2db736ea2]
Former-commit-id: 447d58460fbbfd05ffe08428a1288e392637561d

_embed/public/ace/demo/kitchen-sink/docs/rdoc.Rd

@@ -0,0 +1,64 @@
+\name{picker}
+\alias{picker}
+\title{Create a picker control}
+\description{
+  Create a picker control to enable manipulation of plot variables based on a set of fixed choices.
+}
+
+\usage{
+picker(..., initial = NULL, label = NULL)
+}
+
+
+\arguments{
+  \item{\dots}{
+    Arguments containing objects to be presented as choices for the picker (or a list containing the choices). If an element is named then the name is used to display it within the picker. If an element is not named then it is displayed within the picker using \code{\link{as.character}}. 
+}
+  \item{initial}{
+    Initial value for picker. Value must be present in the list of choices specified. If not specified defaults to the first choice.
+}
+  \item{label}{
+    Display label for picker. Defaults to the variable name if not specified.
+}
+}
+
+\value{
+  An object of class "manipulator.picker" which can be passed to the \code{\link{manipulate}} function.
+}
+
+\seealso{
+\code{\link{manipulate}}, \code{\link{slider}}, \code{\link{checkbox}}, \code{\link{button}}
+}
+
+
+\examples{
+\dontrun{
+
+## Filtering data with a picker
+manipulate(
+  barplot(as.matrix(longley[,factor]), 
+          beside = TRUE, main = factor),
+  factor = picker("GNP", "Unemployed", "Employed"))
+
+## Create a picker with labels
+manipulate(
+  plot(pressure, type = type), 
+  type = picker("points" = "p", "line" = "l", "step" = "s"))
+  
+## Picker with groups
+manipulate(
+  barplot(as.matrix(mtcars[group,"mpg"]), beside=TRUE),
+  group = picker("Group 1" = 1:11, 
+                 "Group 2" = 12:22, 
+                 "Group 3" = 23:32))
+
+## Histogram w/ picker to select type
+require(lattice)
+require(stats)
+manipulate(
+  histogram(~ height | voice.part, 
+            data = singer, type = type),
+  type = picker("percent", "count", "density"))
+
+}
+}