Skip to content

Main content

Branch Length Tip Distance Tool

Sum a supplied phylogenetic path selection without inferring a tree, topology or molecular clock.

Loading tool…

Description

Sum included and omitted branch lengths separately.

Evolutionary time and branch length are linked through a supplied clock or calibration. A unit conversion, path sum or residual assumes the underlying tree and rate model rather than recovering them from biological data.

Sum included and omitted branch lengths separately.

When to use this tool

Use Branch Length Tip Distance when you need one branch-time, path or calibration term.

How to use the tool and how it works

  1. Enter branchLengths, includedPath. Keep parallel arrays aligned. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read pathDistance, omittedLength. Use the output convention below.

Require aligned nonnegative branch lengths and path flags. Sum included and omitted branch lengths separately.1

Input fieldMeaning and unitsAccepted input
branchLengthsBranch LengthsRequired. Array of finite number; maximum items 256.
includedPathIncluded PathRequired. Array of boolean; maximum items 256.
Output fieldInterpretationReturned shape
pathDistancePath DistanceRequired. Finite number.
omittedLengthOmitted LengthRequired. Finite number.
json
{
  "input": {
    "branchLengths": [
      0.2,
      0.3,
      0.5
    ],
    "includedPath": [
      true,
      false,
      true
    ]
  },
  "output": {
    "pathDistance": 0.7,
    "omittedLength": 0.3
  }
}

Limitations and assumptions

  • Flags define the intended path; actual tree topology and connectivity are not checked. Units must be common and repeated records are counted separately.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Use a complete phylogenetic or dating method with the relevant sequence, fossil and rate evidence. Verify topology, branch units, calibration assumptions and uncertainty separately.

References

  1. Calculation and input contract: evolutionary-biology/branch-length-tip-distance — tool.io

Similar or alternative tools