refine.linf.csts.iter: Iteratively refine dCSTs by one additional level

In linf: L-Infinity Normalization and Dominant Community State Types

Iteratively refine dCSTs by one additional level

Description

Appends one refinement level to an existing dCST hierarchy produced by refine.linf.csts or refine.linf.csts.iter. Dominance-lineages to refine can be provided explicitly or selected automatically based on refinement.factor * n0.

Usage

refine.linf.csts.iter(
  M,
  refined,
  cells.to.refine = NULL,
  n0 = 50,
  refinement.factor = 5,
  sep = "__",
  low.freq.policy = c("pure", "absorb"),
  rare.label = "RARE_DOMINANT",
  verbose = TRUE,
  backend = c("auto", "dense", "sparse")
)

Arguments

M	Numeric matrix used for refinement.
refined	A "linf.csts" object with an existing hierarchy.
cells.to.refine	Character vector of leaf dominance-lineage IDs to refine, or NULL for auto-selection. The argument name is retained for backward compatibility.
n0	Integer >= 1. Minimum support required to retain a child lineage.
refinement.factor	Numeric > 0. Auto-selection threshold multiplier.
sep	Character scalar used to concatenate hierarchical labels.
low.freq.policy	Character. One of "pure" or "absorb". Default: "pure". The legacy value "rare" is still accepted as a deprecated alias for "pure".
rare.label	Character scalar for rare buckets when low.freq.policy = "pure".
verbose	Logical. If TRUE, print progress information.
backend	Character. Matrix backend to use: "auto", "dense", or "sparse". The default "auto" inherits the backend from M or from refined when available.

Value

Updated "linf.csts" object with cst.depth increased by one.

linf documentation built on Aug. 5, 2026, 9:08 a.m.