ggvoronoi
ggvoronoi: Voronoi Diagrams and Heatmaps with ggplot2 - Published in JOSS (2018)
Science Score: 95.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 4 DOI reference(s) in README and JOSS metadata -
✓Academic publication links
Links to: joss.theoj.org -
✓Committers with academic emails
2 of 4 committers (50.0%) from academic institutions -
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Repository
Easy Voronoi diagram heatmaps with ggplot2
Basic Info
Statistics
- Stars: 43
- Watchers: 3
- Forks: 6
- Open Issues: 3
- Releases: 4
Metadata Files
README.md
ggvoronoi: Voronoi Diagrams and Heatmaps with 'ggplot2'
Overview
'ggvoronoi' is an R package that allows for easy creation and manipulation of Voronoi diagrams, which are tools for determining nearest neighbor regions for a given set of points. Voronoi diagram regions are calculated using the R package 'deldir' by Rolf Turner. The output from 'deldir' is converted to the spatial object format provided by the 'sp' package from Edzer Pebesma and Roger Bivand. This allows for additional functionality beyond what is provided in 'deldir': diagrams can now be extended to heatmaps and users can now specify a bounding region for the diagram. From there, visualization capabilities are implemented using the framework of 'ggplot2', a popular graphics package for R created by Hadley Wickham, or the user can analyze the diagram using any of R's spatial data analysis packages.
What is a Voronoi diagram?
A Voronoi diagram is a nearest neighbor diagram: given a set of generator points, the Voronoi diagram creates nearest neighbor cells. Each cell is formed around one generator point, and the set of points closest to that generator is fully contained in its cell. The resulting diagram can be used to find the nearest generator for an arbitrary point or to interpolate the blank space around each generator to create a heatmap.
Voronoi diagrams have a multitude of applications, but 'ggvoronoi' implements tools for data visualization and spatial data analysis in R. For data visualization, 'ggvoronoi' fits nicely within the 'ggplot2' framework, so R users experienced with the popular visualization package can create Voronoi diagrams and heatmaps around any point-level dataset within minutes. For spatial data analysis, R users can create a Voronoi diagram within the 'sp' framework as a SpatialPolygonsDataFrame object. From there, the user can find the nearest generator point to each location in a new SpatialPoints object or use tools, such as those contained in 'rgeos', to analyze the diagram.
Installation
To install 'ggvoronoi' from CRAN:
r
install.packages("ggvoronoi")
Or install the latest development version from this repository:
r
remotes::install_github("garretrc/ggvoronoi", dependencies = TRUE, build_opts = c("--no-resave-data"))
Finally, with either verison you can load the R package with the typical method:
r
library(ggvoronoi)
Getting Started
With the vignette, you can view some examples and create your first Voronoi diagram!
r
vignette("ggvoronoi")
Alternatively, the vignette is available here.
Contact info
For questions about usage/syntax or for reporting bugs, email Robert at rcg4@illinois.edu or raise an issue on this repository.
To contribute to the package or see past contributions, see the CONTRIBUTING.md file
Changes
v0.8.5: Fixes thanks to Duncan Murdoch, resubmitting to CRAN
v0.8.2: Added unit tests using 'testthat' and 'vdiffr'. Minor improvements to vignette and README.md
v0.8.1: Fixed bug when using a discrete value for fill mapping. Removed google maps API call in the vignette.
Owner
- Name: Robert Garrett
- Login: garretrc
- Kind: user
- Repositories: 2
- Profile: https://github.com/garretrc
Statistics PhD Candidate at the University of Illinois
JOSS Publication
ggvoronoi: Voronoi Diagrams and Heatmaps with ggplot2
Authors
Miami University, Department of Statistics
Miami University, Department of Statistics
Miami University, Department of Statistics
Miami University, Department of Statistics
Editor
Yo Yehudi
Tags
voronoi diagram ggplot2 deldirGitHub Events
Total
- Watch event: 6
- Issue comment event: 3
Last Year
- Watch event: 6
- Issue comment event: 3
Committers
Last synced: 7 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| garretrc | g****c@m****u | 78 |
| Garrett | r****4@i****u | 10 |
| Duncan Murdoch | m****n@g****m | 2 |
| Roger Bivand | R****d@g****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 16
- Total pull requests: 3
- Average time to close issues: 4 months
- Average time to close pull requests: about 3 hours
- Total issue authors: 9
- Total pull request authors: 2
- Average comments per issue: 2.0
- Average comments per pull request: 0.0
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- corybrunson (6)
- royfrancis (2)
- trinker (2)
- Bisaloo (1)
- AlanZandie (1)
- rsbivand (1)
- paleolimbot (1)
- BroVic (1)
- neuropil (1)
Pull Request Authors
- rsbivand (2)
- dmurdoch (2)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 412 last-month
- Total dependent packages: 3
- Total dependent repositories: 5
- Total versions: 6
- Total maintainers: 1
cran.r-project.org: ggvoronoi
Voronoi Diagrams and Heatmaps with 'ggplot2'
- Homepage: https://github.com/garretrc/ggvoronoi/
- Documentation: http://cran.r-project.org/web/packages/ggvoronoi/ggvoronoi.pdf
- License: MIT + file LICENSE
- Status: removed
-
Latest release: 0.8.5
published over 3 years ago
Rankings
Maintainers (1)
Dependencies
- R >= 2.10 depends
- ggplot2 >= 2.2.0 depends
- deldir * imports
- methods * imports
- raster * imports
- rgeos * imports
- sp * imports
- dplyr * suggests
- ggmap * suggests
- knitr * suggests
- mapproj * suggests
- rmarkdown * suggests
- scales * suggests
- testthat * suggests
- vdiffr * suggests