Skip to content

docs: correct coalescent-opt and skyline CLI help#861

Closed
ivan-aksamentov wants to merge 1 commit into
rustfrom
docs/timetree-coalescent-cli-help
Closed

docs: correct coalescent-opt and skyline CLI help#861
ivan-aksamentov wants to merge 1 commit into
rustfrom
docs/timetree-coalescent-cli-help

Conversation

@ivan-aksamentov

Copy link
Copy Markdown
Member

docs/timetree-coalescent-cli-help -> rust

The --coalescent-opt help described Brent's method with an initial guess, and the --coalescent-skyline and --n-skyline help called the model piecewise linear. Both describe superseded implementations.

The constant-Tc optimizer is the closed-form maximum-likelihood estimate $\hat{T_c} = I/M$ with no iteration and no initial guess, and the skyline emits a piecewise-constant $T_c(t)$. This updates the help text to match the shipped behavior.

Work items

  • Rewrite --coalescent-opt help to describe the closed-form $\hat{T_c} = I/M$ solve [src]
  • Correct --coalescent-skyline and --n-skyline help from piecewise-linear to piecewise-constant [src]

The --coalescent-opt help described Brent's method, but the estimator is the closed-form Tc = I/M solve with no iteration or initial guess. The skyline help called the model piecewise linear, but Tc(t) is emitted piecewise-constant.
@rneher

rneher commented Jul 23, 2026

Copy link
Copy Markdown
Member

makes sense.

@ivan-aksamentov
ivan-aksamentov deleted the docs/timetree-coalescent-cli-help branch July 24, 2026 15:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants