Description
Return reporting/sample and reporting-floor(reporting/sample)*sample as the residual beyond complete sample intervals.
Agricultural time series depend on clock origins, reporting intervals, source vintage and crop-season labeling. A supplied clock offset can reconcile timestamps, while matching source labels alone cannot prove clock synchronization. Calendar-year labels and start-year/end-year crop-season labels use different boundary conventions.
Return reporting/sample and reporting-floor(reporting/sample)*sample as the residual beyond complete sample intervals.
When to use this tool
Use Farm Sensor Record Grain Gap when checking the stated clock, period, reporting-support or season-label convention.
How to use the tool and how it works
- Enter samplePeriod, reportingPeriod. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read ratio, residual. Use the output convention below.
Require positive sample and reporting periods in the same time unit. Return reporting/sample and reporting-floor(reporting/sample)*sample as the residual beyond complete sample intervals.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| samplePeriod | Sample Period | Required. Finite number; strictly above 0. |
| reportingPeriod | Reporting Period | Required. Finite number; strictly above 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| ratio | Ratio | Required. Finite number. |
| residual | Signed supplied/calculated difference in the direction specified above. | Required. Finite number. |
{
"input": {
"samplePeriod": 3,
"reportingPeriod": 10
},
"output": {
"ratio": 3.3333333333333335,
"residual": 1
}
}Limitations and assumptions
- No sampling synchronization, aggregation or integer-multiple requirement is inferred.
- 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 time metadata, calibrated clocks and the relevant complete crop/calendar conventions for actual temporal alignment and interpretation.
References
Similar or alternative tools
- Field Data Source Grain Gap
Compare positive source and target row supports.
- Farm Sensor Channel Code Source Pair Tool
Compare supplied farm sensor channel/source identifiers.