Description
Divide dwellTime by observedTime when the latter is positive, requiring both nonnegative and dwellTime no greater than observedTime.
Specimen measurements and animal observations depend on a defined body part, reference value, unit, and observation window. A mass fraction, size ratio, or timing share summarizes those inputs. The counting and measurement conventions must stay explicit when comparing specimens or records.
Divide dwellTime by observedTime when the latter is positive, requiring both nonnegative and dwellTime no greater than observedTime.
When to use this tool
Use Observation Dwell Time Share when you need to compare supplied specimen measurements or observation records under an explicit reference and denominator.
How to use the tool and how it works
- Enter dwellTime, observedTime. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read share, defined. Inspect defined before interpreting the associated values.
Divide dwellTime by observedTime when the latter is positive, requiring both nonnegative and dwellTime no greater than observedTime.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| dwellTime | Dwell Time | Required. Finite number; minimum 0. |
| observedTime | Observed Time | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| share | Dimensionless fraction using the denominator stated in the mechanics; not a percentage numeral. | Required. Finite number. |
| defined | Whether the associated denominator or quantity is defined; inspect before interpreting a placeholder. | Required. Boolean. |
{
"input": {
"dwellTime": 3,
"observedTime": 12
},
"output": {
"share": 0.25,
"defined": true
}
}Limitations and assumptions
- An all-zero interval returns share zero with defined false. The caller supplies the observation window and event definition; no behavior or location is detected from a track.
- The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.
- 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. Signed zero is exported as zero.
Alternative or Complementary methods
Use compatible measurements and observation records to verify the chosen denominator and reference before interpreting a specimen comparison.
References
Similar or alternative tools
- Animal Observation Window Share
Audit supplied animal observation time coverage without classifying behavior.
- Acoustic Call Pulse Duty Factor Term
Pulse-union occupancy using an explicit aggregate overlap correction; no acoustic event detection.