isColorBlank: Determine if colors are blank colors

In jmw86069/jamenrich: Analysis and Visualization of Multiple Gene Set Enrichments

Determine if colors are blank colors

Description

Determine if colors are blank colors

Usage

isColorBlank(
  x,
  c_max = 7,
  l_min = 95,
  alpha_max = 0.1,
  blankColor = c("#FFFFFF", "#FFFFFFFF", "transparent"),
  ...
)

Arguments

x	character vector of R colors.
c_max	maximum chroma as determined by HCL color space, in range of no color 0 to maximum color 100.
l_min	numeric minimum luminance required for a color to be considered blank, combined with the c_max argument. This threshold prevents grey colors from being considered blank, unless their luminance is above this threshold.
alpha_max	numeric value indicating the alpha transparency below which a color is considered blank, in range of fully transparent 0, to fully non-transparent 1.
blankColor	character vector of R colors directly matched to the input x vector. The value "transparent" is useful here, because it is not easily converted to HCL color space.
...	additional arguments are ignored.

Details

This function takes a vector of colors and determines if each color is considered a "blank color", based upon direct match and the color chroma saturation and luminance. For example, extremely pale colors from colorjam::vals2colorLevels() may be considered "blank" if the color saturation is extremely low. Similarly, colors with extremely high alpha transparency may be considered "blank".

See Also

Other jam utility functions: avg_angles(), avg_colors_by_list(), call_fn_ellipsis_deprecated(), cell_fun_bivariate(), collapse_mem_clusters(), colorRamp2D(), deconcat_df2(), display_colorRamp2D(), enrichList2geneHitList(), filter_mem_genes(), filter_mem_sets(), find_colname(), get_hull_data(), get_igraph_layout(), gsubs_remove(), handle_igraph_param_list(), make_legend_bivariate(), make_point_hull(), mem_find_overlap(), order_colors(), rank_mem_clusters(), rotate_coordinates(), subgraph_jam(), subset_mem(), summarize_node_spacing(), xyAngle()

jmw86069/jamenrich documentation built on Nov. 6, 2024, 7:07 p.m.