scales: Scale Functions for Visualization

Graphical scales map data to aesthetics, and provide methods for automatically determining breaks and labels for axes and legends.

Install the latest version of this package by entering the following in R:
AuthorHadley Wickham [aut, cre], RStudio [cph]
Date of publication2016-11-09 18:28:56
MaintainerHadley Wickham <>
LicenseMIT + file LICENSE

View on CRAN

Man pages

abs_area: Point area palette (continuous), with area proportional to...

alpha: Modify colour transparency. Vectorised in both colour and...

area_pal: Point area palette (continuous).

asn_trans: Arc-sin square root transformation.

as.trans: Convert character string to transformer.

atanh_trans: Arc-tangent transformation.

boxcox_trans: Box-Cox power transformation.

brewer_pal: Color Brewer palette (discrete).

cbreaks: Compute breaks for continuous scale.

censor: Censor any values outside of range.

col2hcl: Modify standard R colour in hcl colour space.

col_numeric: Color mapping

colour_ramp: Fast color interpolation

comma_format: Comma formatter: format number with commas separating...

date_breaks: Regularly spaced dates.

date_format: Formatted dates.

date_trans: Transformation for dates (class Date).

discard: Discard any values outside of range.

div_gradient_pal: Diverging colour gradient (continous).

dollar_format: Currency formatter: round to nearest cent and display dollar...

dscale: Discrete scale.

expand_range: Expand a range with a multiplicative or additive constant.

exp_trans: Exponential transformation (inverse of log transformation).

extended_breaks: Extended breaks. Uses Wilkinson's extended breaks algorithm...

format_format: Format with using any arguments to 'format'.

fullseq: Generate sequence of fixed size intervals covering range.

gradient_n_pal: Arbitrary colour gradient palette (continous).

grey_pal: Grey scale palette (discrete).

hms_trans: Transformation for times (class hms).

hue_pal: Hue palette (discrete).

identity_pal: Identity palette.

identity_trans: Identity transformation (do nothing).

linetype_pal: Line type palette (discrete).

log1p_trans: Log plus one transformation.

log_breaks: Log breaks (integer breaks on log-transformed scales).

log_trans: Log transformation.

manual_pal: Manual palette (manual).

math_format: Add arbitrary expression to a label. The symbol that will be...

muted: Mute standard colour.

ordinal_format: Ordinal formatter: add ordinal suffixes (-st, -nd, -rd, -th)...

package-scales: Generic plot scaling methods

parse_format: Parse a text label to produce expressions for plotmath.

percent_format: Percent formatter: multiply by one hundred and display...

pretty_breaks: Pretty breaks. Uses default R break algorithm as implemented...

probability_trans: Probability transformation.

Range-class: Mutable ranges.

reciprocal_trans: Reciprocal transformation.

rescale: Rescale numeric vector to have specified minimum and maximum.

rescale_max: Rescale numeric vector to have specified maximum.

rescale_mid: Rescale numeric vector to have specified minimum, midpoint,...

rescale_none: Don't peform rescaling

rescale_pal: Rescale palette (continuous).

reverse_trans: Reverse transformation.

scientific_format: Scientific formatter.

seq_gradient_pal: Sequential colour gradient palette (continous).

shape_pal: Shape palette (discrete).

show_col: Show colours.

sqrt_trans: Square-root transformation.

squish: Squish values into range.

squish_infinite: Squish infinite values to range.

time_trans: Transformation for date-times (class POSIXt).

train_continuous: Train (update) a continuous scale

train_discrete: Train (update) a discrete scale

trans_breaks: Pretty breaks on transformed scale.

trans_format: Format labels after transformation.

trans_range: Compute range of transformed values.

unit_format: Add units to the labels

wrap_format: Wrap text to a specified width, adding newlines for spaces if...

zero_range: Determine if range of vector is close to zero, with a...


abs_area Man page
alpha Man page
area_pal Man page
asn_trans Man page
as.trans Man page
atanh_trans Man page
boxcox_trans Man page
brewer_pal Man page
cbreaks Man page
censor Man page
col2hcl Man page
col_bin Man page
col_factor Man page
col_numeric Man page
colour_ramp Man page
col_quantile Man page
comma Man page
comma_format Man page
ContinuousRange Man page
date_breaks Man page
date_format Man page
date_trans Man page
discard Man page
DiscreteRange Man page
div_gradient_pal Man page
dollar Man page
dollar_format Man page
dscale Man page
expand_range Man page
exp_trans Man page
extended_breaks Man page
format_format Man page
fullseq Man page
gradient_n_pal Man page
grey_pal Man page
hms_trans Man page
hue_pal Man page
identity_pal Man page
identity_trans Man page
linetype_pal Man page
log10_trans Man page
log1p_trans Man page
log2_trans Man page
log_breaks Man page
logit_trans Man page
log_trans Man page
manual_pal Man page
math_format Man page
muted Man page
ordinal Man page
ordinal_format Man page
package-scales Man page
package-scales-package Man page
parse_format Man page
percent Man page
percent_format Man page
pretty_breaks Man page
probability_trans Man page
probit_trans Man page
Range Man page
Range-class Man page
reciprocal_trans Man page
rescale Man page
rescale_max Man page
rescale_mid Man page
rescale_none Man page
rescale_pal Man page
reverse_trans Man page
scales Man page
scientific Man page
scientific_format Man page
seq_gradient_pal Man page
shape_pal Man page
show_col Man page
sqrt_trans Man page
squish Man page
squish_infinite Man page
time_trans Man page
train_continuous Man page
train_discrete Man page
trans_breaks Man page
trans_format Man page
trans_range Man page
unit_format Man page
wrap_format Man page
zero_range Man page


tests/testthat/test-manual-pal.R tests/testthat/test-zero-range.r tests/testthat/test-colour-ramp.R tests/testthat/test-alpha.r tests/testthat/test-formatter.r tests/testthat/test-colors.r tests/testthat/test-scale.r tests/testthat/test-trans.r tests/testthat/test-breaks-log.r tests/testthat/test-discrete.R tests/testthat/test-trans-date.r tests/testthat/test-breaks-extended.R tests/testthat/test-rescale.R tests/testthat/test-bounds.r tests/testthat/test-range.r
R/pal-manual.r R/pal-brewer.r R/breaks.r R/scale-discrete.r R/colour-manip.r R/pal-hue.r R/pal-area.r R/trans.r R/date-time.r R/trans-numeric.r R/pal-shape.r R/pal-rescale.r R/bounds.r R/range.r R/pal-dichromat.r R/trans-date.r R/colour-mapping.r R/RcppExports.R R/pal-identity.r R/documentation.r R/full-seq.r R/scales.r R/formatter.r R/pal-linetype.r R/pal-gradient.r R/pal-grey.r R/scale-continuous.r
man/boxcox_trans.Rd man/grey_pal.Rd man/linetype_pal.Rd man/show_col.Rd man/manual_pal.Rd man/trans_range.Rd man/date_format.Rd man/date_breaks.Rd man/trans_breaks.Rd man/hms_trans.Rd man/train_discrete.Rd man/math_format.Rd man/col2hcl.Rd man/asn_trans.Rd man/probability_trans.Rd man/colour_ramp.Rd man/comma_format.Rd man/sqrt_trans.Rd man/wrap_format.Rd man/identity_trans.Rd man/log_trans.Rd man/log1p_trans.Rd man/log_breaks.Rd man/rescale_none.Rd man/squish_infinite.Rd man/censor.Rd man/dscale.Rd man/discard.Rd man/rescale_max.Rd man/as.trans.Rd man/muted.Rd man/reciprocal_trans.Rd man/exp_trans.Rd man/seq_gradient_pal.Rd man/scientific_format.Rd man/unit_format.Rd man/extended_breaks.Rd man/shape_pal.Rd man/div_gradient_pal.Rd man/alpha.Rd man/ordinal_format.Rd man/identity_pal.Rd man/area_pal.Rd man/train_continuous.Rd man/brewer_pal.Rd man/fullseq.Rd man/cbreaks.Rd man/rescale_mid.Rd man/time_trans.Rd man/rescale.Rd man/col_numeric.Rd man/expand_range.Rd man/atanh_trans.Rd man/hue_pal.Rd man/pretty_breaks.Rd man/rescale_pal.Rd
man/gradient_n_pal.Rd man/reverse_trans.Rd man/trans_format.Rd man/date_trans.Rd man/squish.Rd man/package-scales.Rd man/percent_format.Rd man/zero_range.Rd man/format_format.Rd man/Range-class.Rd man/dollar_format.Rd
man/abs_area.Rd man/parse_format.Rd

Questions? Problems? Suggestions? or email at

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.