Farm Event Support Share Tool

Description

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 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.

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.

When to use this tool

Use Farm Event Support Share when checking the stated agricultural source, identity or record-support convention.

How to use the tool and how it works

Enter eventIds, timestampPresent, locationPresent, unitKnown. 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 events, supportedEvents, share, defined. Inspect defined before interpreting the associated values.

Require aligned event IDs and timestamp/location/unit flags. 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.^[1]

Input field	Meaning and units	Accepted input
eventIds	Event Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
timestampPresent	Timestamp Present	Required. Array of boolean; maximum items 256.
locationPresent	Location Present	Required. Array of boolean; maximum items 256.
unitKnown	Unit Known	Required. Array of boolean; maximum items 256.

Output field	Interpretation	Returned shape
events	Distinct event IDs, rather than number of rows.	Required. Safe integer.
supportedEvents	Distinct IDs with at least one fully supported row; partial rows are not combined.	Required. Safe integer.
share	Dimensionless share using the operation-specific denominator stated above; not a percentage number.	Required. Finite number.
defined	Whether the corresponding reporting denominator/value is defined; inspect before interpreting zero placeholders.	Required. Boolean.

json

{
  "input": {
    "eventIds": [
      "a",
      "b"
    ],
    "timestampPresent": [
      true,
      true
    ],
    "locationPresent": [
      true,
      false
    ],
    "unitKnown": [
      true,
      true
    ]
  },
  "output": {
    "events": 2,
    "supportedEvents": 1,
    "share": 0.5,
    "defined": true
  }
}

Limitations and assumptions

Duplicate IDs are merged by membership; partial evidence spread across separate rows is not combined into a complete row.
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.

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-event-support-share — tool.io

Similar or alternative tools

Farm Yield Grid Missing Cell Mask
Return zero-based included indices for observed nonexcluded cells, missing indices for unobserved nonexcluded cells, and all excluded indices regardless of observation.
Farm Event Period Overlap Tool
Calculate farm event period overlap from explicit caller-supplied inputs.