-
Notifications
You must be signed in to change notification settings - Fork 5
/
README.Rmd
92 lines (55 loc) · 4.65 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
<img src="man/figures/lterpalettefinder_hex.png" align="right" width="15%"/>
```{r, include = FALSE}
knitr::opts_chunk$set(collapse = TRUE, comment = "#>",
fig.path = "man/figures/README-")
```
# `lterpalettefinder` - Extract Color Palettes from Photos and Pick Official LTER Palettes
<!-- badges: start -->
[](https://github.com/lter/lterpalettefinder/actions)
[](https://cran.r-project.org/package=lterpalettefinder)
<!-- badges: end -->
The goal of `lterpalettefinder` is to provide high quality color palettes derived from photos at Long Term Ecological Research (LTER) sites. This allows users to create beautiful graphics that have close visual ties to photos from the places where data were collected. This package also allows users to generate their own palettes from any photo (PNG, JPEG, TIFF, or HEIC) if the current palettes in the function do not meet their needs. For more information on the LTER Network, check out [our website](https://lternet.edu/)!
## Installation
You can install the development version of `lterpalettefinder` from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github("lter/lterpalettefinder")
```
## R Shiny App
To help demonstrate some of the functionalities of `lterpalettefinder` we have created a [standalone R Shiny app](https://cosima.nceas.ucsb.edu/lterpalettefinder-shiny/) that allows for extracting a palette and demonstrating it entirely through a browser. While we developed this app primarily to support non-R users interested in `lterpalettefinder` we hope it is interesting and valuable to R experts as well! The GitHub repo for the Shiny app can be found [here](https://github.com/lter/lterpalettefinder-shiny).
## Functions
This package currently includes the following functions:
### Use an Existing Palette
- **`palette_find`** returns "official" palette(s) that we have already created that meet criteria you specify
### Create Your Own Palette
- **`palette_extract`** extracts 25 colors' hexadecimal codes from a picture of your choosing (PNG, JPEG, TIFF, and HEIC formats are currently supported)
- **`palette_sort`** sorts output of `palette_extract` by hue and saturation to approximate how human eyes group colors
- **`palette_subsample`** randomly picks a user-specified number of hexadecimal codes from a vector of such codes
### Demonstrate a Palette
- **`palette_demo`** creates an exploratory **base R** graph from a vector of hexadecimal codes (like that returned by either `palette_extract`, `..._sort`, or `..._subsample`) and provides an option to export that plot if desired
- **`palette_ggdemo`** creates an exploratory **`ggplot2`** graph from a vector of hexadecimal codes (like that returned by either `palette_extract`, `..._sort`, or `..._subsample`)
Note that the vector of hexadecimal codes provided by `palette_find` when *only one* official palette meets criteria set by user will also be accepted by either `palette_demo` or `...ggdemo`
## Acknowledgements
Creation of this package was funded by National Science Foundation grant [#1929393](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1929393) awarded to F. Davis, J. Caselle, and M. Downs.
[Gabriel De La Rosa](https://www.gabrieldelarosa.com/) designed our hex logo and provided valuable feedback on early versions of the package.
Thanks also to the whole LTER Network Office team and the broader NCEAS community!
## Palette Examples
These palette examples were generated from photos at LTER sites.
### [Santa Barbara Coastal LTER](https://sbclter.msi.ucsb.edu/) + `palette_demo`
**Image** | **Palette**
:-------------:|:------------:
<img src="man/figures/SBC-kelp-forest.jpeg" alt="Photo credit: SBC LTER"/> | <img src="man/figures/SBC_kelp-forest-palette.jpg"/>
### [Arctic LTER](https://arc-lter.ecosystems.mbl.edu/) + `palette_ggdemo`
**Image** | **Palette**
:-------------:|:------------:
<img src="man/figures/ARC-sunrise.jpeg" alt="Photo credit: Lindsay VanFossen"/> | <img src="man/figures/ARC_sunrise-palette.jpeg"/>
### [Kellogg Biological Station LTER](https://lter.kbs.msu.edu/) + `palette_demo`
**Image** | **Palette**
:-------------:|:------------:
<img src="man/figures/KBS-burn.jpeg" alt="Photo credit: G.P. Robertson"/> | <img src="man/figures/KBS_burn-palette.jpg"/>