David Hodge




simplevis is a package of ggplot2 and leaflet wrapper functions that aims to make visualisation easier with less brainpower required.

Visualisation families

simplevis supports many visualisation family types.

4 functions per family: colouring, facetting, neither or both

Each visualisation family generally has four functions.

This is based on whether or not a visualisation is to be:

The premise is that these are the most common types of visualisation for each of the families.

All arguments for variables are required unqutoted and follow an *_var format (i.e. x_var, y_var, col_var and facet_var)

For example, code below shows these combinations with code and output for the gg_point*() family.

         x_var = bill_length_mm, 
         y_var = body_mass_g)

             x_var = bill_length_mm, 
             y_var = body_mass_g, 
             col_var = sex)

               x_var = bill_length_mm, 
               y_var = body_mass_g, 
               facet_var = species)

                   x_var = bill_length_mm, 
                   y_var = body_mass_g, 
                   col_var = sex, 
                   facet_var = species)

Customising plots

simplevis plots are designed to work and look clean with the bare minimum of code.

However, there is plenty of flexibility to customise.


Change the colour palette by supplying a vector of hex code colours to the pal argument.

Numerous colour palettes are available from the pals package.

simplevis also supports easy colouring of numeric variables for gg_point*(), gg_bar*(), gg_hbar*(), gg_sf*() and gg_stars*() (and equivalent leaflet functions).

The col_method argument allows you to specify the method for colouring with a default of continuous.

Other methods available are bin and quantile.

For bin and quantile, you can fine-tune using the col_breaks_n or col_cuts arguments.

You can also adjust the opacity of objects in the visualisation through the alpha_*() arguments.

Refer to the colour article for further information.


You can adjust the theme of any simplevis plot by providing a ggplot2 theme to the theme argument.

You can also create your own quick themes with the gg_theme() function.

Refer to the themes article for further information.

Consistent prefixes

There are lots of arguments available to modify the defaults.

In general, arguments have consistent prefixes based on x_*, y_*, col_* or facet_*, and as such the autocomplete can help identify what you need.

Some examples of transformations available are: