star layer for ggplot2

1. Introduction

ggstar provides geoms for ggplot2 to create more easily discernible shapes:

geom_star

p1 <- show_starshapes()
p1

And the default is: c(1, 2, 9, 4, 3, 5, 6, 11, 12)[seq_len(n)]. n is the number of shapes you want to use.

2. Install

ggstar has been submitted on CRAN, you can use the following to install it.

# Release
install.packages("ggstar")

# Or for devel
if(!requireNamespace("remotes", quietly=TRUE)){
    install.packages("remotes")
}
remotes::install_github("xiangpin/ggstar")

3. Usage

geom_star is similar to geom_point of ggplot2. The difference point is geom_star use starshape to mapping the starshapes. The another is geom_star use scale_starshape_manual for manual scale. And the shapes will be not distorted on cartesian coordinates or polar coordinates.

3.1 Cartesian coordinates

library(ggplot2)
library(ggstar)
p2 <- ggplot(data=iris, aes(x=Sepal.Width,y=Sepal.Length)) + 
      geom_star(aes(starshape=Species, fill=Species), size=2.5) +
      scale_fill_manual(values=c("#E41A1C", "#377EB8", "#4DAF4A")) +
      theme(legend.spacing.y = unit(0.02, "cm"))
p2

3.2 Polar coordinates

p3 <- ggplot(data=mtcars, aes(x=wt, y=mpg)) +
      geom_star(aes(fill=cyl), size=2.5) +
      scale_fill_gradient(low="blue", high="red") +
      coord_polar() +
      theme(panel.border=element_blank(),
            legend.spacing.y = unit(0.02, "cm"))
p3

4. Need helps?

If you have questions/issues, please visit github issue tracker.

5. Session information

Here is the output of sessionInfo() on the system on which this document was compiled:

## R version 4.0.3 (2020-10-10)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.1 LTS
## 
## Matrix products: default
## BLAS:   /opt/softwares/Development/R/4.0.3/lib/R/lib/libRblas.so
## LAPACK: /opt/softwares/Development/R/4.0.3/lib/R/lib/libRlapack.so
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
##  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
##  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
##  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
##  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] ggstar_1.0.1  ggplot2_3.3.3
## 
## loaded via a namespace (and not attached):
##  [1] knitr_1.31        magrittr_2.0.1    tidyselect_1.1.0  munsell_0.5.0    
##  [5] colorspace_2.0-0  R6_2.5.0          rlang_0.4.10      highr_0.8        
##  [9] dplyr_1.0.4       stringr_1.4.0     tools_4.0.3       grid_4.0.3       
## [13] gtable_0.3.0      xfun_0.20         withr_2.4.1       htmltools_0.5.1.1
## [17] ellipsis_0.3.1    yaml_2.2.1        digest_0.6.27     tibble_3.0.6     
## [21] lifecycle_0.2.0   crayon_1.4.0      gridExtra_2.3     farver_2.0.3     
## [25] purrr_0.3.4       vctrs_0.3.6       prettydoc_0.4.1   glue_1.4.2       
## [29] evaluate_0.14     rmarkdown_2.6     labeling_0.4.2    stringi_1.5.3    
## [33] compiler_4.0.3    pillar_1.4.7      generics_0.1.0    scales_1.1.1     
## [37] pkgconfig_2.0.3