https://github.com/mitchelloharawild/hexwall
R script to neatly align hexagon stickers
https://github.com/mitchelloharawild/hexwall
Last synced: 8 days ago
JSON representation
R script to neatly align hexagon stickers
- Host: GitHub
- URL: https://github.com/mitchelloharawild/hexwall
- Owner: mitchelloharawild
- Created: 2018-05-25T05:19:52.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-09-23T12:02:42.000Z (over 3 years ago)
- Last Synced: 2025-04-13T16:07:32.274Z (8 days ago)
- Language: R
- Size: 729 KB
- Stars: 72
- Watchers: 2
- Forks: 21
- Open Issues: 2
-
Metadata Files:
- Readme: README.Rmd
Awesome Lists containing this project
- jimsghstars - mitchelloharawild/hexwall - R script to neatly align hexagon stickers (R)
README
---
output: github_document
---```{r setup, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)
```
# hexwallThe `hexwall.R` file contains one function `hexwall()`, which can be used to generate an image that neatly arranges a folder of hexagons. It makes use of the [ImageMagick](https://www.imagemagick.org/) library via the ROpenSci package [magick](https://github.com/ropensci/magick) to arrange the images.
There are several arguments allowing some control over the function's operation.
* path: The path to a folder of hexagon stickers (png files are recommended)
* sticker_row_size: The number of stickers in the longest row
* sticker_width: The width of each sticker in pixels
* remove_small: Should hexagons smaller than the sticker_width be removed?
* remove_size: Should hexagons of an abnormal size be removed?
* coords: A data.frame of coordinates defining the placement of hexagons
* scale_coords: Should the coordinates be scaled to the hexagon size?
* sort_mode: How should the files be sorted?```{r example}
source("hexwall.R")
hexwall("samplehex", sticker_row_size = 3, sticker_width = 200)
```# Usage
1. [Download the repository](https://github.com/mitchelloharawild/hexwall/archive/master.zip)
2. Unzip and open the R project (`hexwall.Rproj`)
3. Run `source("hexwall.R")`
4. Ready to go, use the `hexwall()` function to make your hexagon wall.