Description
Return state at an exact recorded sampling time.
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.
Return state at an exact recorded sampling time.
When to use this tool
Use Momentary Sampling Point State Tag when checking the stated behavioral-research observation, assignment, coverage or coding convention.
How to use the tool and how it works
- Enter times, states, sampleTime. Follow any array-alignment requirements below. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read found, state, index. Inspect found, state before interpreting the associated values.
Return state at an exact recorded sampling time. Require aligned arrays with strictly increasing times; index is exact sampleTime lookup, state is its Boolean or false with found false and index -1.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| times | Times | Required. Array of finite number; maximum items 256. |
| states | States | Required. Array of boolean; maximum items 256. |
| sampleTime | Sample Time | Required. Finite number. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| found | Found | Required. Boolean. |
| state | Supplied Boolean at exact sample time, or false placeholder when found=false. | Required. Boolean. |
| index | Zero-based exact match, or -1 when absent. | Required. Safe integer. |
{
"input": {
"times": [
1,
2,
3
],
"states": [
false,
true,
false
],
"sampleTime": 2
},
"output": {
"found": true,
"state": true,
"index": 1
}
}Limitations and assumptions
- No interpolation or nearest-time lookup occurs; missing false is not an observed inactive state.
- 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
- Momentary Sample Boundary State
Check a momentary sample against a state interval.
- Observation Bin Occupancy
Bin supplied event times on a half-open grid.