Title: Collection of Artistic and Nature-Inspired Color Palettes
Version: 0.3.0
Description: Offers a variety of color palettes inspired by art, nature, and personal inspirations. Each palette is accompanied by a unique backstory, enriching the understanding and significance of the colors.
License: MIT + file LICENSE
Encoding: UTF-8
RoxygenNote: 7.3.3
URL: https://github.com/loukesio/ltc-color-palettes
BugReports: https://github.com/loukesio/ltc-color-palettes/issues
Imports: grDevices, ggplot2, ggforce, dplyr, colorspace, crayon
Language: en-US
Suggests: spelling
NeedsCompilation: no
Packaged: 2026-01-11 22:50:03 UTC; theodosiou
Author: Loukas Theodosiou ORCID iD [aut, cre], Kristian Ullrich ORCID iD [aut]
Maintainer: Loukas Theodosiou <theodosiou@evolbio.mpg.de>
Repository: CRAN
Date/Publication: 2026-01-16 11:30:20 UTC

Adjust Lightness of Palette Colors

Description

Darken or lighten an entire palette or specific colors within it. Uses the colorspace package for perceptually uniform adjustments.

Usage

adjust_ltc(palette_name, amount = 0, which = NULL)

Arguments

palette_name

Character or unquoted name. Name of the ltc palette to adjust.

amount

Numeric. Amount to adjust lightness (-100 to 100). Negative values darken, positive values lighten. Default is 0 (no change).

which

Integer vector. Which colors to adjust (e.g., c(1, 3) for 1st and 3rd). If NULL (default), adjusts all colors.

Value

A vector of adjusted hex color codes with class "ltc"

Examples


# Darken entire palette
adjust_ltc(alger, amount = -20)

# Lighten entire palette
adjust_ltc("maya", amount = 30)

# Darken only specific colors
adjust_ltc(remains, amount = -25, which = c(2, 4))


Plot a Colour Palette as a Bird

Description

Visualizes a selected colour palette in the form of a bird drawing. Requires at least 5 colors in the palette.

Usage

bird(chrom)

Arguments

chrom

An ltc palette object

Value

A ggplot2 object showing a bird drawing using the selected colours.

Examples


# Create a bird visualization
pal <- ltc(paloma)
bird(pal)


Create Custom Palette with Individual Color Adjustments

Description

Apply different lightness adjustments to each color in a palette.

Usage

custom_adjust_ltc(palette_name, adjustments)

Arguments

palette_name

Character or unquoted name. Name of the ltc palette.

adjustments

Numeric vector. Lightness adjustments for each color (-100 to 100). Length must match the palette length.

Value

A vector of adjusted hex color codes with class "ltc"

Examples


# Different adjustment for each color
custom_adjust_ltc(remains, c(-30, 0, 40, 0))

# Create gradient effect
custom_adjust_ltc("maya", c(-40, -20, 0, 20, 40))


Desaturate Palette Colors

Description

Reduce color saturation (make colors more gray).

Usage

desaturate_ltc(palette_name, amount = 0.5, which = NULL)

Arguments

palette_name

Character or unquoted name. Name of the ltc palette.

amount

Numeric. Desaturation amount (0 to 1). 0 = no change, 1 = completely gray.

which

Integer vector. Which colors to desaturate. If NULL (default), affects all colors.

Value

A vector of desaturated hex color codes with class "ltc"

Examples


# Desaturate entire palette
desaturate_ltc(luminaries, amount = 0.5)

# Desaturate only specific colors
desaturate_ltc("heatmap2", amount = 0.7, which = c(1, 2))


Information about the Colour Palettes

Description

This dataframe contains the backstory or inspiration behind each color palette.

Usage

info

Format

An object of class data.frame with 31 rows and 2 columns.


List of colour palettes

Description

A list containing predefined colour palettes with artistic backstories.

This function provides the desired colour palette by name. You can call it with or without quotes: ltc(paloma) or ltc("paloma")

Usage

palettes

ltc(name, n, type = c("discrete", "continuous"))

Arguments

name

Character or unquoted name. The name of the desired palette.

n

Integer. The number of colors you want from the palette. If omitted, it uses all colors from the palette.

type

The type of palette. Either "discrete" or "continuous".

Format

An object of class list of length 31.

Details

ltc: A Collection of Art-inspired Colour Palettes

This package provides a collection of color palettes inspired by art, nature, and personal preferences. Each palette has a backstory, providing context and meaning to the colors.

Value

A vector of hex color codes with class "ltc"

Examples

# Load a palette (with or without quotes)
ltc(paloma)
ltc("maya")

# Select first 3 colors
ltc(maya, n = 3)

# Generate continuous palette
ltc(remains, n = 10, type = "continuous")

Plot a Colour Palette

Description

Visualizes a selected colour palette as a bar of colours.

Usage

## S3 method for class 'ltc'
plot(x, ...)

Arguments

x

An ltc palette object

...

Additional arguments (currently unused).

Value

A ggplot2 object showing the selected colours.

Examples


# Create and plot a palette
pal <- ltc(paloma)
plot(pal)


Print Method for ltc Objects

Description

Custom print method that displays the palette name followed by hex color codes with actual colors visible in the console.

Usage

## S3 method for class 'ltc'
print(x, ...)

Arguments

x

An ltc palette object

...

Additional arguments (currently unused)

Value

Invisibly returns the palette object