Description
Bin supplied event times on a half-open grid.
Behavioral-study coding depends on observation intervals, missing samples, event records and assignment rules. Partial-, whole- and momentary-sampling summaries answer different questions; local agreement or coverage does not establish actual behavior, a diagnosis or an effective intervention.
Bin supplied event times on a half-open grid.
When to use this tool
Use Observation Bin Occupancy when checking the stated behavioral-research observation, assignment, coverage or coding convention.
How to use the tool and how it works
- Enter times, origin, binWidth, binCount. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read counts, outsideCount. Use the output convention below.
Bin supplied event times on a half-open grid. Require binWidth > 0 and whole binCount 1..256; index = floor((time-origin)/width), increment a bin when within range and otherwise outsideCount.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| times | Times | Required. Array of finite number; maximum items 256. |
| origin | Origin | Required. Finite number. |
| binWidth | Bin Width | Required. Finite number; strictly above 0. |
| binCount | Bin Count | Required. Safe integer; minimum 1; maximum 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| counts | Counts | Required. Array of safe integer; maximum items 256. |
| outsideCount | Outside Count | Required. Safe integer. |
{
"input": {
"times": [
0,
1,
2,
4,
-1
],
"origin": 0,
"binWidth": 2,
"binCount": 2
},
"output": {
"counts": [
2,
1
],
"outsideCount": 2
}
}Limitations and assumptions
- The final upper boundary is outside; no actual event detection, duration weighting or behavioral inference is performed.
- 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 verified observations and the study’s complete sampling/coding protocol, with appropriate statistical and professional interpretation for health or intervention decisions.
References
Similar or alternative tools
- Interval Observation Partial Credit
Return duration fraction and optional full-interval-only credit.
- Partial Interval Observation One Hit
Return partial-interval occurrence among known samples.