In coolbutuseless/ggblur: Blurry Geoms for Ggplot2
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
library(ggplot2)
library(ggblur)
# Quick logo generation. Borrowed heavily from Nick Tierney's Syn logo process
library(magick)
library(showtext)
font_add_google("Racing Sans One", "gf")
# pkgdown::build_site(override = list(destination = "../coolbutuseless.github.io/package/ggblur"))
img <- image_read("man/figures/white.png")
hexSticker::sticker(subplot = img,
s_x = 0.92,
s_y = 1.2,
s_width = 1.5,
s_height = 0.95,
package = "ggblur",
p_x = 1,
p_y = 1,
p_color = "#223344",
p_family = "gf",
p_size = 9,
h_size = 1.2,
h_fill = "#ffffff",
h_color = "#223344",
filename = "man/figures/logo.png")
image_read("man/figures/logo.png")
ggblur 
ggblur provides geom_point_blur() for use in ggplot - this geom allows you
to control the blurriness of the drawn points, but is otherwise
identical to the standard geom_point().
What's in the box?
geom_point_blur()
- same as
geom_point() but now accepts blur_size as an aesthetic
- also allows for control of the smoothness of the blur (
blur_steps)
scale_blur_size_continuous(), scale_blur_size_discrete() and scale_blur_size_manual()
for controlling blur_size when used as a mapped aesthetic/
Similar packages
- ggecho is an earlier experiment of
mine from 2019 where I echo components using a custom stat
stat_echo. This
solution works across multiple geoms, but didn't allow for adjusting the
echo for individual points.
- ggfx adds blur at the layer level i.e.
no individual control over the amount of blur for each point.
How it works
Blur is simulated by keeping the original point, and drawing a sequence of
larger, faded points behind it (illustrated below).
The number of
points rendered is controlled by blur_steps and the distance to which the
blur extends beyond the edge of the original point is controlled by blur_size.
Note: Paul Murrell has some experiments to add radial gradients to grid graphics
(see his github) and if this
becomes part of grid it may be a better method of simulating blur.
## Installation
You can install the development version from [GitHub](https://github.com/coolbutuseless/ggblur) with:
wzxhzdk:3
## Example 1 - constant `blur_size`
When not used as a mapped aesthetic within `aes()`, the same `blur_size` is
applied to every point.
wzxhzdk:4
## Example 2 - mapping `blur_size` as an aesthetic
When used as a mapped aesthetic within `aes()`, the `blur_size` is calculated
individually for each point.
wzxhzdk:5
## Example 3 - control over blur parameters
`blur_steps` and `scale_blue_size_continuous/discrete/manual()`
can be used to further customise the appearance.
wzxhzdk:6
## Example 4 - blur with colour
wzxhzdk:7
coolbutuseless/ggblur documentation built on Feb. 16, 2020, 12:21 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
knitr::opts_chunk$set( collapse = TRUE, comment = "#>", fig.path = "man/figures/README-", out.width = "100%" ) library(ggplot2) library(ggblur)
# Quick logo generation. Borrowed heavily from Nick Tierney's Syn logo process library(magick) library(showtext) font_add_google("Racing Sans One", "gf") # pkgdown::build_site(override = list(destination = "../coolbutuseless.github.io/package/ggblur"))
img <- image_read("man/figures/white.png") hexSticker::sticker(subplot = img, s_x = 0.92, s_y = 1.2, s_width = 1.5, s_height = 0.95, package = "ggblur", p_x = 1, p_y = 1, p_color = "#223344", p_family = "gf", p_size = 9, h_size = 1.2, h_fill = "#ffffff", h_color = "#223344", filename = "man/figures/logo.png") image_read("man/figures/logo.png")
ggblur
ggblur provides geom_point_blur() for use in ggplot - this geom allows you
to control the blurriness of the drawn points, but is otherwise
identical to the standard geom_point().
What's in the box?
geom_point_blur()- same as
geom_point()but now acceptsblur_sizeas an aesthetic - also allows for control of the smoothness of the blur (
blur_steps)
- same as
scale_blur_size_continuous(),scale_blur_size_discrete()andscale_blur_size_manual()for controllingblur_sizewhen used as a mapped aesthetic/
Similar packages
- ggecho is an earlier experiment of
mine from 2019 where I echo components using a custom stat
stat_echo. This solution works across multiple geoms, but didn't allow for adjusting the echo for individual points. - ggfx adds blur at the layer level i.e. no individual control over the amount of blur for each point.
How it works
Blur is simulated by keeping the original point, and drawing a sequence of larger, faded points behind it (illustrated below).
The number of
points rendered is controlled by blur_steps and the distance to which the
blur extends beyond the edge of the original point is controlled by blur_size.
Note: Paul Murrell has some experiments to add radial gradients to grid graphics (see his github) and if this becomes part of grid it may be a better method of simulating blur.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.