tesselle / khroma Goto Github PK

View Code? Open in Web Editor NEW

201.0 201.0 8.0 11 MB

:art: Colour Schemes for Scientific Data Visualization

Home Page: https://packages.tesselle.org/khroma/

License: GNU General Public License v3.0

R 99.43% TeX 0.57%

accessibility colour-schemes data-visualization r-package

khroma's Introduction

tesselle

Overview

The tesselle suite is a collection of packages for research and teaching in archaeology. These packages focus on quantitative analysis methods developed for archaeology. The tesselle packages are designed to work seamlessly together and to complement general-purpose and other specialized statistical packages. These packages can be used to explore and analyze common data types in archaeology: count data, compositional data and chronological data.

The tesselle package is designed to make it easy to install and load key packages from the tesselle suite in a single step.

To cite tesselle in publications use:

  Frerebeau N (2024). _tesselle: Easily Install and Load 'tesselle'
  Packages_. Université Bordeaux Montaigne, Pessac, France.
  doi:10.5281/zenodo.6500491 <https://doi.org/10.5281/zenodo.6500491>,
  R package version 1.5.0, <https://packages.tesselle.org/tesselle/>.

This package is a part of the tesselle project
<https://www.tesselle.org>.

Installation

You can install the released version of tesselle from CRAN with:

install.packages("tesselle")

And the development version from GitHub with:

# install.packages("remotes")
remotes::install_github("tesselle/tesselle")

Usage

library(tesselle) will load the core packages:

tabula: analysis and visualization of archaeological count data;
kairos: analysis of chronological patterns from archaeological count data;
nexus: analysis of compositional data;

And two companion packages:

dimensio: multivariate analysis;
isopleuros: ternary plots.

library(tesselle)
#> --- Attaching packages -------------------------------------- tesselle 1.5.0 ---
#> * dimensio    0.6.0
#> * isopleuros  1.2.0
#> * kairos      2.1.0
#> * nexus       0.2.0
#> * tabula      3.0.1

Contributing

Please note that the tesselle project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

khroma's People

Contributors

Stargazers

Watchers

Forkers

siddhartha-kar hulaba hadley patarol ustervbo odavalos harmveer

khroma's Issues

Allow to adjust the rainbow colour scheme

From Paul Tol's technical note:

If the lowest data value occurs often, start at off-white instead of purple. If the highest data value occurs often, end at red instead of brown. For colour-blind people, the light purples and light blues should not be mixed much.

Reduce dependencies

ggplot2, scales and spacesXYZ should be suggested packages, so that khroma only imports grDevices and grid.

We need to check if a suggested package is available before using it:

if (!requireNamespace("pkg", quietly = TRUE)) {
  stop("Package \"pkg\" needed for this function to work. Please install it.", call. = FALSE)
}

An alternative would be to create a new package without dependencies (such as viridis and viridisLite) containing only the colour() function.

Using diverging scale with discrete data

It would be great to have the option to use diverging colors scales with discrete data, by adding functions such as scale_fill_discretePRGn()

`scale_name` argument of `discrete_scale()` is deprecated in ggplot2

Describe the bug

The scale_name argument of discrete_scale() is deprecated as of ggplot2 3.5.0.

To Reproduce

library(ggplot2)
options("lifecycle_verbosity"="warning")

plot_df <- data.frame(
fill_col = c("A", "A", "B", "B"),
pattern_col = c("a", "b", "a", "b"),
value = c(1, 2, 3, 4)
)

options(
list(
ggplot2.discrete.fill = function() {
khroma::scale_fill_picker(palette = "light")
}
))

ggplot(plot_df) +
aes(x = fill_col, y = value, fill = pattern_col) +
geom_col(position = "dodge")

Expected behavior

No warning is raised.

Add edge colour scales

Add colour scales for ggraph edge geoms.

Conflict with `convert()`

khroma::convert() maskes aion::convert().

New medium-contrast color palette from Paul Tol

A new version 3.2 of Paul Tol's palettes has been released few days ago: https://personal.sron.nl/~pault/data/colourschemes.pdf

It includes a new qualitative medium-contrast palette. It could be worth to include it in khroma.

Best regards

Typo in light palette, "light cyant"

With a recent khroma from CTAN:

light <- colour("light")
light(6)
light blue orange pink light cyant pear pale grey
"#77AADD" "#EE8866" "#FFAABB" "#99DDFF" "#BBCC33" "#DDDDDD"

Use sequential colour schemes with discrete data

I get the error message in the title when using sequential and diverging scale_fills with a data set that requires 33 values. I've tried scale_fill_sunset(), scale_fill_iridescent(), and scale_fill_smoothrainbow().

The default ggplot2 scale_fill works fine, as does scale_fill_grey(), so I am expecting the khroma scale_fill functions that are capable of yielding more than the default number of colors to work as well.

User error?