Terminology¶
scCS uses a small set of names for the graph-based future-fate formulation. The names describe distinct quantities and should not be collapsed into one generic “commitment score.”
Discounted Future-Fate Propagation¶
Discounted Future-Fate Propagation (DFFP) is the recommended future-identity mode. It propagates transition probability on the original RNA-velocity graph with geometric stopping. It is not a transformation of UMAP arrows and does not use the star to define neighbors.
Conditional Fate Affinity¶
Conditional Fate Affinity (CFA) is the normalized distribution across the
supervised fates after conditioning on selected-fate reach. The package exposes
it as future_fate_affinity and the exact alias
conditional_fate_affinity.
Discounted Fate Reach¶
Discounted Fate Reach (DFR) is the probability of reaching any supervised
fate anchor before geometric stopping. It is exposed as future_fate_reach
and discounted_fate_reach. Reach depends on the effective horizon and is
interpreted as time-bounded resolution, not as physical time.
Future-Fate Specificity¶
Future-Fate Specificity (FFS) is one minus normalized Shannon entropy of Conditional Fate Affinity. It measures decisiveness among supplied fates but does not measure how much probability reaches those fates.
Resolved Commitment¶
Resolved Commitment (RC) is the product of Discounted Fate Reach and
Future-Fate Specificity. It is exposed as reach_supported_specificity and
the alias resolved_commitment. Report reach and specificity separately
alongside this composite.
Signed Ordering Flux¶
Signed Ordering Flux (SOF) is the expected one-step change in the supplied
ordering after conditioning on transitions retained within the selected
furcation. It is exposed as signed_progression and
signed_ordering_flux. Positive values are forward; negative values preserve
retrograde motion; values near zero can indicate stationary, mixed, turning, or
loop-like dynamics.
Unresolved Future Probability¶
Unresolved Future Probability (UFP) is the probability that geometric
stopping occurs before any supplied selected or competing anchor is reached. It
is exposed as unresolved_probability and
unresolved_future_probability.
Display-only velocity projection¶
The scVelo grid, root rose, and branch-relative velocity profiles on the star are visualization diagnostics. They show how the source velocity graph appears after the standardized layout is drawn. They do not define DFFP probabilities, CFA, DFR, FFS, RC, or SOF.