Description
Compare lineage depths with an expected increment.
Developmental stages and lineages can be represented by labels, ordered events and observation intervals. Index and time differences preserve a declared representation but do not discover lineage, assign stage or establish biological equivalence.
Compare lineage depths with an expected increment.
When to use this tool
Use Cell Lineage Depth Increment when checking an explicit stage, lineage or observation-coordinate convention.
How to use the tool and how it works
- Enter parentDepth, childDepth, suppliedExpectedIncrement. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read increment, residual. Use the output convention below.
Compare lineage depths with an expected increment. Require nonnegative whole parentDepth, childDepth and expected increment; increment = child-parent and residual subtracts the expectation.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| parentDepth | Parent Depth | Required. Safe integer; minimum 0. |
| childDepth | Child Depth | Required. Safe integer; minimum 0. |
| suppliedExpectedIncrement | Supplied Expected Increment | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| increment | Increment | Required. Safe integer. |
| residual | Signed difference in the direction defined above, using the same units as its compared quantities. | Required. Safe integer. |
{
"input": {
"parentDepth": 3,
"childDepth": 5,
"suppliedExpectedIncrement": 1
},
"output": {
"increment": 2,
"residual": 1
}
}Limitations and assumptions
- Negative increments are retained; the tool does not validate a lineage graph or actual parentage.
- 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
Review the original biological evidence and its staging or lineage model before drawing mechanistic conclusions.
References
Similar or alternative tools
- Cell Lineage Binary Generation Index
Map a binary lineage generation position to zero-based heap indexes.
- Lineage Sibling Order Tie
Order lineage sibling IDs by birth times and an explicit tie policy.