Description
Separate activity bouts using a supplied gap threshold.
Zoological records separate specimen identity, preparation, anatomical side, behavioral codes and the sources assigning those labels. A specimen name or status is a claim with provenance, while an observation share depends on a stated denominator. Preserving these conventions helps compare records without treating a transcription or visibility count as taxonomic identification or an animal-health assessment.
Separate activity bouts using a supplied gap threshold.
When to use this tool
Use Animal Activity Bout Gap Threshold when you already have previousBoutEnd, nextBoutStart, suppliedGapThreshold and need to separate activity bouts using a supplied gap threshold.
How to use the tool and how it works
- Enter previousBoutEnd, nextBoutStart, suppliedGapThreshold. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read observedGap, distinctUnderSuppliedRule. Inspect distinctUnderSuppliedRule before interpreting the associated values.
Require suppliedGapThreshold>=0; observedGap=nextBoutStart-previousBoutEnd and distinctUnderSuppliedRule means gap>=threshold, including equality.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| previousBoutEnd | Previous Bout End | Required. Finite number. |
| nextBoutStart | Next Bout Start | Required. Finite number. |
| suppliedGapThreshold | Supplied Gap Threshold | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| observedGap | Observed Gap | Required. Finite number. |
| distinctUnderSuppliedRule | Distinct Under Supplied Rule | Required. Boolean. |
{
"input": {
"previousBoutEnd": 10,
"nextBoutStart": 20,
"suppliedGapThreshold": 7
},
"output": {
"observedGap": 10,
"distinctUnderSuppliedRule": true
}
}Limitations and assumptions
- Times share a caller-defined basis; overlapping bouts produce negative gaps, and the threshold is not a validated behavioral rule.
- 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
For identity or type status, inspect the original specimen record and cited nomenclatural authority. For behavior or visibility, review the actual observation series and its codebook; this helper preserves one stated label or counting convention.
References
Similar or alternative tools
- Ethogram State Event Class Label
Label an ethogram behavior as a recorded state, event or unknown kind.
- Animal Resting Respiration Observation Share
Calculate usable respiration-observation time as a share of resting observation time.