Farm Yield Grid Missing Cell Mask Tool

Description

Return zero-based included indices for observed nonexcluded cells, missing indices for unobserved nonexcluded cells, and all excluded indices regardless of observation.

Farm data records connect field, event, sensor and source identifiers with observation and verification flags. Literal keys and supported-record shares help reconcile those records without authenticating a source, identifying a physical object or establishing measurement quality. Repeated IDs may need a different denominator from repeated rows.

Return zero-based included indices for observed nonexcluded cells, missing indices for unobserved nonexcluded cells, and all excluded indices regardless of observation.

When to use this tool

Use Farm Yield Grid Missing Cell Mask when checking the stated agricultural source, identity or record-support convention.

How to use the tool and how it works

Enter values, observed, excluded. 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 included, missing, excludedIndices. Use the output convention below.

Require aligned values, observed and excluded arrays. Return zero-based included indices for observed nonexcluded cells, missing indices for unobserved nonexcluded cells, and all excluded indices regardless of observation.^[1]

Input field	Meaning and units	Accepted input
values	Values	Required. Array of finite number; maximum items 256.
observed	Observed	Required. Array of boolean; maximum items 256.
excluded	Excluded	Required. Array of boolean; maximum items 256.

Output field	Interpretation	Returned shape
included	Included	Required. Array of safe integer; maximum items 256.
missing	Zero-based unobserved nonexcluded cell positions; excluded cells are kept in excludedIndices instead.	Required. Array of safe integer; maximum items 256.
excludedIndices	Excluded Indices	Required. Array of safe integer; maximum items 256.

json

{
  "input": {
    "values": [
      1,
      0,
      3
    ],
    "observed": [
      true,
      false,
      true
    ],
    "excluded": [
      false,
      false,
      true
    ]
  },
  "output": {
    "included": [
      0
    ],
    "missing": [
      1
    ],
    "excludedIndices": [
      2
    ]
  }
}

Limitations and assumptions

Values are not imputed or analyzed; missingness and exclusions follow caller-supplied flags.
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

Inspect original records, authoritative identifier schemes and calibrated measurements before merging data or drawing agricultural conclusions.

References

Calculation and input contract: agroinformatics/farm-yield-grid-missing-cell-mask — tool.io

Similar or alternative tools

Farm Event Support Share
Count distinct event IDs and distinct IDs with at least one row having all three flags true; return their share, or zero with defined=false when empty.
Farm Event Period Overlap Tool
Calculate farm event period overlap from explicit caller-supplied inputs.