Field Data Source Grain Gap Tool

Description

Compare positive source and target row supports.

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.

Compare positive source and target row supports.

When to use this tool

Use Field Data Source Grain Gap when checking the stated clock, period, reporting-support or season-label convention.

How to use the tool and how it works

Enter sourceRowSeconds, targetRowSeconds, sourceRowMeters, targetRowMeters. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read timeRatio, spatialRatio, timeGap, spatialGap. Use the output convention below.

Compare positive source and target row supports. Return source/target time and spatial ratios plus signed source-minus-target gaps, using seconds and metres respectively.^[1]

Input field	Meaning and units	Accepted input
sourceRowSeconds	Source Row Seconds	Required. Finite number; strictly above 0.
targetRowSeconds	Target Row Seconds	Required. Finite number; strictly above 0.
sourceRowMeters	Source Row Meters	Required. Finite number; strictly above 0.
targetRowMeters	Target Row Meters	Required. Finite number; strictly above 0.

Output field	Interpretation	Returned shape
timeRatio	Source row duration/target row duration.	Required. Finite number.
spatialRatio	Source row spatial support/target spatial support.	Required. Finite number.
timeGap	Time Gap	Required. Finite number.
spatialGap	Spatial Gap	Required. Finite number.

json

{
  "input": {
    "sourceRowSeconds": 20,
    "targetRowSeconds": 10,
    "sourceRowMeters": 4,
    "targetRowMeters": 2
  },
  "output": {
    "timeRatio": 2,
    "spatialRatio": 2,
    "timeGap": 10,
    "spatialGap": 2
  }
}

Limitations and assumptions

This compares supplied support scales; it does not resample data or prove comparable spatial or temporal observations.
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

Calculation and input contract: agroinformatics/field-data-source-grain-gap — tool.io

Similar or alternative tools

Farm Sensor Record Grain Gap
Return reporting/sample and reporting-floor(reporting/sample)*sample as the residual beyond complete sample intervals.
Agricultural Raster Cell To Field Fraction Tool
Calculate agricultural raster cell to field fraction from explicit caller-supplied inputs.