NEWS

---

HeatmapR 1.1.0 (2026-03-24)

New Features

• Added support for cosine distance metric in hierarchical clustering via dist = "cosine" parameter in heat_map_clust() and heat_map().
  • When using cosine distance, tree_cut values between 0 and 1 are interpreted as absolute cosine distance thresholds rather than proportional tree heights. This allows for more intuitive clustering based on actual cosine distance values.
  • Non-cosine distance metrics retain the original proportional height behavior.
• Added manual cluster split functionality - clusters can now be manually defined by:
  • Specifying the number of columns/rows in each cluster (e.g., tree_cut_x = c(3,4,5))
  • Supplying a vector of cluster indices to assign each column/row to a specific cluster (e.g., tree_cut_x = c(1,1,1,2,2,2,2,3,3,3))
• Enhanced dendrogram rendering to support manual splits while preserving the option to display dendrograms with manually defined clusters.
• Added cell_border_mask parameter to selectively apply colored borders to specific cells. Accepts a logical matrix of the same dimensions as the input data, where TRUE indicates a cell should have a colored border and FALSE indicates a transparent border.
• Added cell_col_scale_limits parameter to set custom limits for colour scales, enabling consistent colour scales across multiple heatmaps (e.g., cell_col_scale_limits = c(0, 100)).
• Added cell_size_scale_limits parameter to set custom limits for size scales when using cell_size = TRUE, ensuring consistent size scaling across multiple plots.

Improvements

• Improved internal distance calculation with optimized cosine distance computation.
• Better handling of zero-length vectors in distance calculations.
• Scale limits (colour and size) are now computed from unrounded data before any rounding occurs, preventing empty legends when all values round to the same value.
• Colour and size assignments now use unrounded values for accuracy, while rounding only affects displayed cell text. This preserves visual distinctions even when rounded text appears identical.

HeatmapR 1.0.0

• Create HeatmapR to easily construct high resolution complex heatmaps using base graphics.