palettephines: Analytical Color Palettes for Philippine Phenology

Overview

In spatial analysis, abstract color gradients (like viridis in R) are essential for mathematical clarity but often fail to provide immediate meaning at the local, community level. This package was developed not by teaching the locals how to read statistics, but by teaching visualization how to speak their language - through anchoring the scales to the natural colors of terrestrial and marine life.

Note: The palettephines package is not a replacement for statistical techniques such as Local Indicators of Spatial Association (LISA) and Moran's I but acts as a final touch for presentations, maps, among other things. For the full features, you may check vignette.

Installation

You may install the package using:

install.packages("palettephines")

Getting Started

# 1. Set up required libraries
library(palettephines)
library(ggplot2)

# 2. Capture current settings and setup the layout
# We use no.readonly = TRUE to ensure we only try to reset writeable parameters
oldpar <- par(no.readonly = TRUE) 
par(mfrow = c(3, 2), mar = c(4, 4, 3, 1))

# 3. Call the preview functions
invisible(lapply(names(phines_metadata), function(pal_name) {
  show_phines(pal_name)
}))

# 4. Reset to original user settings
par(oldpar)

Exploring the Palette

As of v0.1.3, the package covers five (5) major transition in the Philippines:


Image 1: The five major palette of the palettephines package in R.

Application

The primary usage of this package is to transform datasets stuck in spreadsheets into visualizations that could be used for decision-making and communication. Here, we used the mangga_pico palette to determine the growth status for each places.


Image 2: Visualizing the `mangga_pico` palette in the Philippine map using the `palettephines` package .


Image 2: Visualizing the `palay_harvest` palette in the Philippine map using the `palettephines` package .

Acknowledgements

The developer extends his deepest gratitude to the local farmers, fisherfolks, and other blue-collar workers who continue to keep our country alive. This software does not exist to teach you anything new; it exists to honor your expertise and ensure that our software is packaged to see your reality.

Contributions are welcome!

If you want to include a specific palette - from Philippine biomes to your favorite fruit - feel free to create a pull request or submit an issue here.

References

Meier, U. (2023). Growth stages of mono- and dicotyledonous plants: BBCH Monograph. OpenAgrar. https://www.openagrar.de/servlets/MCRFileNodeServlet/openagrar_derivate_00010428/BBCH-Skala_en.pdf

McField, M., & Kramer, P. R. (2007). Healthy Reefs for Healthy People: A guide to indicators of reef health and social well-being in the Mesoamerican Reef. Healthy Reefs Initiative. https://www.healthyreefs.org

Schwartz, M. W. (2013). Ecological state-transition modeling. In Encyclopedia of Biodiversity (2nd ed.). Springer. https://doi.org/10.1007/978-94-007-6925-0