Package: recolorize 0.1.0

recolorize: Color-Based Image Segmentation

Automatic, semi-automatic, and manual functions for generating color maps from images. The idea is to simplify the colors of an image according to a metric that is useful for the user, using deterministic methods whenever possible. Many images will be clustered well using the out-of-the-box functions, but the package also includes a toolbox of functions for making manual adjustments (layer merging/isolation, blurring, fitting to provided color clusters or those from another image, etc). Also includes export methods for other color/pattern analysis packages (pavo, patternize, colordistance).

Authors:Hannah Weller [aut, cre]

recolorize_0.1.0.tar.gz
recolorize_0.1.0.zip(r-4.5)recolorize_0.1.0.zip(r-4.4)recolorize_0.1.0.zip(r-4.3)
recolorize_0.1.0.tgz(r-4.4-any)recolorize_0.1.0.tgz(r-4.3-any)
recolorize_0.1.0.tar.gz(r-4.5-noble)recolorize_0.1.0.tar.gz(r-4.4-noble)
recolorize_0.1.0.tgz(r-4.4-emscripten)recolorize_0.1.0.tgz(r-4.3-emscripten)
recolorize.pdf |recolorize.html✨
recolorize/json (API)
NEWS

# Install 'recolorize' in R:

install.packages('recolorize', repos = c('https://hiweller.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/hiweller/recolorize/issues

Datasets:

werner - Werner's nomenclature of colors

On CRAN:

39 exports 36 stars 2.81 score 64 dependencies 69 scripts 339 downloads

Last updated 2 months agofrom:71f6d35eca. Checks:OK: 7. Indexed: yes.

Target	Result	Date
Doc / Vignettes	OK	Sep 01 2024
R-4.5-win	OK	Sep 01 2024
R-4.5-linux	OK	Sep 01 2024
R-4.4-win	OK	Sep 01 2024
R-4.4-mac	OK	Sep 01 2024
R-4.3-win	OK	Sep 01 2024
R-4.3-mac	OK	Sep 01 2024

Exports:absorbLayer add_image adjust_color assignPixels backgroundCondition backgroundIndex blurImage brick_to_array classify_recolorize colorClusters colorResiduals constructImage editLayer editLayers hclust_color imDist imHeatmap imposeColors match_colors medianColors mergeLayers plotColorClusters plotColorPalette plotImageArray raster_to_array readImage recluster recoloredImage recolorize recolorize_adjacency recolorize_to_patternize recolorize_to_png recolorize2 recolorizeVector reorder_colors rerun_recolorize splitByColor thresholdRecolor wernerColor

Dependencies:abind bmp class classInt cli cluster codetools colorRamps cpp11 curl DBI digest downloader e1071 farver future future.apply geometry globals glue igraph imager jpeg KernSmooth lattice lifecycle lightr linprog listenv lpSolve magic magick magrittr MASS Matrix mgcv misc3d nlme parallelly pavo pkgconfig plot3D plotfunctions png progressr proxy purrr raster Rcpp RcppProgress readbitmap rlang s2 sf sp stringi stringr terra tiff units vctrs viridisLite wk xml2

Introduction

Rendered fromIntroduction.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2023-10-10
Started: 2021-04-08

Step 0: Image acquisition and preparation

Rendered fromstep00_prep.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2021-12-06
Started: 2021-11-30

Step 1: Loading & processing images

Rendered fromstep01_loading.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2021-12-06
Started: 2021-11-30

Step 2: Initial clustering

Rendered fromstep02_initial_cluster.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2021-12-06
Started: 2021-11-30

Step 3: Refinement

Rendered fromstep03_refinement.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2021-12-06
Started: 2021-11-30

Step 4: Tweaks & edits

Rendered fromstep04_manual_tweak.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2022-06-02
Started: 2021-11-30

Step 5: Exporting & visualizing output

Rendered fromstep05_visualization_export.Rmdusingknitr::rmarkdownon Sep 01 2024.

Last update: 2021-12-06
Started: 2021-11-30

Citation

Development and contributors

Readme and manuals

Help Manual

Help page	Topics
Absorb a layer into its surrounding color patches	absorbLayer
Add a raster image to a plot	add_image
Adjust the saturation and brightness of a color	adjust_color
Apply imager operations to layers of an image	apply_imager_operation
Converts from a raster array to a cimg object	array_to_cimg
Convert from an array to a raster stack	array_to_RasterStack
Assign a 2D matrix of pixels to specified colors	assignPixels
Generate a background condition for masking	backgroundCondition
Index and remove background pixels for color clustering	backgroundIndex
Blur an image	blurImage
Convert from a RasterBrick to an array	brick_to_array
Generate a 'coldist' object for CIE Lab colors	cielab_coldist
Converts from cimg to raster array	cimg_to_array
Convert a 'recolorize' object to a 'classify' object	classify_recolorize
Clean up parameters passed to mergeLayers	clean_merge_params
Modified convertColor	col2col
Generate color clusters from an image	colorClusters
Cluster pixel colors using histogram binning	colorClustersHist
Cluster pixel colors using K-means clustering	colorClustersKMeans
Calculate squared residuals for color centers	colorResiduals
Generate an image from pixel assignments and color matrix	constructImage
Edit a color patch using morphological operations	editLayer
Edit multiple color patches using morphological operations	editLayers
Expand aspects of a recolorize object for other functions	expand_recolorize
Plot and group colors by similarity	hclust_color
Calculates the distance between non-transparent pixels in images	imDist
Plot a heatmap of a matrix of color distances	imHeatmap
Recolor an image to a provided set of colors	imposeColors
Change colors of dendrogram tips	labelCol
Reorder a color palette to best match a reference palette	match_colors
Change color centers to median color of all pixels assigned to it	medianColors
Merge layers in a recolorized image	mergeLayers
Make pixel assignment matrix for recoloring	pixelAssignMatrix
Plot recolorized image results	plot.recolorize
Plot a 'recolorizeVector' object	plot.recolorizeVector
Plot color clusters in a color space	plotColorClusters
Plot a color palette	plotColorPalette
Plot a 3D array as an RGB image	plotImageArray
Convert from a (small-r) raster object to an RGB array	raster_to_array
Read in an image as a 3D array	readImage
Recluster color centers based on color similarity	recluster
Get recolored image from a recolorize object	recoloredImage
Simplify the colors of an image	recolorize
Run 'pavo''s adjacency and boundary strength analysis on a 'recolorize' object	recolorize_adjacency
Convert a recolorize object to a raster object	recolorize_to_patternize
Save a recolored image as a PNG	recolorize_to_png
Recolorize with automatic thresholding	recolorize2
Convert a recolorize object to a vector	recolorizeVector
Reorder colors in a recolorize object	reorder_colors
Rerun the sequence of calls used to produce a recolorize object	rerun_recolorize
Convert RGB colors to HSL	rgb2hsl
Split color clusters in a recolorize object into layers	splitByColor
Drop minor colors from a recolorize object	thresholdRecolor
Werner's nomenclature of colors	werner
Remap an image to Werner's nomenclature	wernerColor

Usage by other packages (reverse dependencies)