linf.landmarks: Landmark points for dCST dominance-lineages

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

Landmark points for dCST dominance-lineages

Description

Computes representative landmark points for the dominance-lineages of a "linf.csts" object at a chosen depth and view.

Landmark types are defined with respect to the leaf feature of the dCST path: the last feature ID in the lineage ID path. Lineages whose leaf token is rare.label are reported but skipped for landmark computation because they do not correspond to a unique target feature.

Usage

linf.landmarks(
  M,
  csts,
  depth = NULL,
  view = c("active", "rare", "absorb"),
  landmark.types = c("endpoint.max", "endpoint.min", "mean.rep", "median.rep"),
  tie.method = c("first", "random", "error"),
  backend = c("auto", "dense", "sparse")
)

Arguments

M	Numeric matrix (samples x features) used to build or refine the dCSTs.
csts	A "linf.csts" object.
depth	Integer. dCST depth to inspect. Defaults to the leaf depth csts$cst.depth.
view	Character. One of "active", "rare", or "absorb".
landmark.types	Character vector containing any of "endpoint.max", "endpoint.min", "mean.rep", or "median.rep".
tie.method	Character. Tie handling for landmark selection: "first", "random", or "error".
backend	Character. Matrix backend to use: "auto", "dense", or "sparse". The default "auto" preserves sparse input and otherwise uses the dense path.

Value

A list of class "linf.landmarks" with components:

• depth, view, sep, rare.label

• feature.ids, feature.labels

• cells: one row per dominance-lineage with computability metadata; the component name is retained for backward compatibility

• landmarks: one row per computed landmark point

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