breaks
|
if the explanatory variable is numeric, this controls how it is discretized. breaks is passed to hist and can be a list of arguments.
|
tol.ylab
|
convenience tolerance parameter for y-axis annotation. If the distance between two labels drops under this threshold, they are plotted equidistantly.
|
off
|
vertical offset between the bars (in per cent). It is fixed to 0 for spinograms and defaults to 2 for spine plots.
|
xlevels, xord
|
arguments controlling the order of the x variable, and hence of the x-axis. Supply one or the other; if both arguments are provided, xlevels takes precedence and xord is silently ignored.
-
xlevels specifies the levels literally, either a character vector of level names in the desired order (e.g., c(“C”, “B”, “A”)), or a numeric vector of the corresponding level indexes (e.g. 3:1).
-
xord instead accepts a keyword or custom function, which then derives the order from the data. Options are:
-
“desc” and “asc” rank the categories by (weighted) frequency, i.e. most or least common first. (Long forms like “descending” and “increasing” are also accepted.)
-
“asis” or “rev” permute the existing levels without consulting the data at all. The former takes the categories in the order that they appear in the data, while the latter reverses the current level order.
-
a custom function that determines both the ranking statistic and its direction. The statistic is always sorted ascending, so function(y) -median(y) ranks by median, largest first.
Note that x is only reordered when it is categorical (i.e., factor or character). Both arguments are thus ignored for spinograms, which have a (binned) numeric x axis. Each argument defaults to NULL, i.e. keep the existing factor levels.
|
ylevels, yord
|
as for xlevels / xord above, but for the y variable. Note that y is always coerced to a factor for spineplots and spinograms, so these arguments are always binding if provided. Be aware that a numeric y gives one level per distinct value.
|
col
|
a vector of fill colors of the same length as levels(y). The default is to call gray.colors.
|
weights
|
numeric. A vector of frequency weights for each observation in the data. If NULL all weights are implicitly assumed to be 1. If x is already a 2-way table, the weights are ignored.
|
lighten
|
logical. For grouped spineplots where the y variable is itself the grouping variable (i.e. y == by), should the fills use a lighter, opaque tint of the series colour(s)? Default is FALSE, i.e. the fills use the fully-saturated palette colour(s). (Unlike the other area types such as type_barplot, where lightening is the default, spineplot tiles abut one another with no gap, so the darker saturated fills read better against their matching border colours.) Set to TRUE to opt in to the lighter tint. Note that lighten has no effect on other spineplot displays (single-group or x == by), which always use a sequential shading ramp of the base colour.
|
xaxlabels, yaxlabels
|
[Deprecated] character vectors for annotation of the x and y axis. Use the top-level xaxl / yaxl arguments instead, which apply consistently across tinyplot types. These two type-specific arguments will be removed in a future release.
|