Title: Descriptive Statistics Graphics and Utilities
License: GPL (โฅ 2)
๐งฉ Overview
pharos is the graphics layer of the DescToolsX ecosystem. It draws statistical graphics on top of base graphics โ distribution and density displays, bivariate and categorical plots, diagnostic and model evaluation panels โ and supplies the colour, geometry, formatting and HTML tools they are built from.
A theme system resolves colours, symbols and layout centrally, so the look of a whole analysis can be set once instead of being repeated at every call.
The package is self-contained and usable without the rest of the suite.
๐ Documentation: https://andrisignorell.github.io/pharos/
โ๏ธ Installation
install.packages("pharos")Or the development version from GitHub:
remotes::install_github("AndriSignorell/pharos")๐ Core Features
๐น Model and Diagnostic Displays
-
plotLift(),plotPropCI(),plotMiss(),plotCatDist() -
plot()methods for Bland-Altman and Lorenz curve objects,plotBinaryTree() -
lines()methods forlmandloessfits
๐น Layout and Faceting
-
plotFacet()โ panel layouts with a user-supplied panel function -
canvas(),plotArea(),mar(),abcCoords(),axisBreak(),axTicksPosixct(),axisFmt() -
spreadOut(),lineToUser(),isValidPlotRegion()
๐น Colour
- Conversions:
colToHex(),colToRgb(),colToHsv(),hexToRgb(),rgbToCmy(),cmykToRgb(),longToRgb() - Manipulation:
addOpacity(),fade(),darken(),lighten(),shade(),mixCol(),contrastCol(),grayScale() - Palettes:
pal(),palNames(),hcol(),findCol(),setBackCol()
๐น Geometry
-
arc(),bezier(),circle(),ellipse(),ring(),polygonX(),regPolygon(),polarGrid() -
rotate(),transformXY(), coordinate conversions, degree/radian conversion,convUnit()
๐น Formatting and Strings
-
fm(),fmCI(),unit(),ftable()method for lists -
strAbbr(),strAlign(),strCap(),strChop(),strPad(),strTrunc(),strRev(),strDist(),strSpell(),strExtract()
๐ Design Principles
- Consistent โ lowerCamelCase API and uniform argument conventions across the whole DescToolsX suite
-
Themed โ colours, symbols and layout resolved centrally through
getTheme(),setTheme()/resetTheme()andstyle() - Base graphics โ no grid, no extra graphics stack; plots compose with everything already in R
- Fast โ performance-critical routines implemented in Rcpp
๐งช Example
library(pharos)
# distribution overview: histogram, density, boxplot, ecdf in one panel
plotFreqDist(rnorm(500))
# named plot positions without arithmetic
plot(rnorm(20), type = "n")
xy <- abcCoords("topleft", inset = 1)
text(xy$xy$x, xy$xy$y, "annotation", adj = xy$adj)
# colour manipulation
fade(pal("dark"), 0.4)
# faceting: one panel per sample, drawn by a panel function
samples <- lapply(split(iris, iris$Species),
function(d) list(x = d$Sepal.Length, y = d$Petal.Length))
plotFacet(samples, dim = c(1, 3),
FUN = function(x, y, col, pch, ...) points(x, y, col = col, pch = pch),
xlab = "Sepal length", ylab = "Petal length")
# flows between stages: one row per flow
plotSankey(data.frame(from = c("A", "A", "B", "C", "D"),
to = c("C", "D", "D", "E", "F"),
value = c(5, 3, 4, 5, 7)))๐งฑ The Suite
pharos builds on bedrock (base utilities). DescToolsX (descriptive statistics), lumen (tests and intervals), alloy (modelling), pons (MS-Office) and swissValet (RStudio addins) complete the family.
