Yield Class Lookup

Audit caller regional yield-class productivity reference. Audit caller independently verified matched reference against actual observation, not a fabricated specification. Caller independently verifies units, applicability and matching conditions; no operational recipe, safety certification, causal efficacy or legal/resource classification is inferred.

Description

A yield class refers to productivity under a particular species, region and management reference.

A yield class refers to productivity under a particular species, region and management reference.^[1]

Matching a supplied class record preserves that context instead of supplying a universal forest yield table. Use this tool to compare an observation with an exact caller-supplied numeric reference.

When to use Yield Class Lookup

Use this tool to compare an observation with an exact caller-supplied numeric reference. Establish the species/site, survey protocol, units, sampled area or exposure, and the independently chosen reference or model.

How to use Yield Class Lookup and understand its results

Establish the species/site, survey protocol, units, sampled area or exposure, and the independently chosen reference or model.
Enter callerYieldClassIds, callerYieldClassValues, queryYieldClassId, observedYieldClassValue, using the field meanings and rules below, then run the tool.
Read callerMatchedYieldClassValue, signedObservedMinusYieldClassReference. Interpret the fields using their units, signs and evidence conventions below.
If input validation fails, correct the reported field and run again. Before applying the result, check reference scope, model assumptions and any missing evidence or placeholder values.

Input field	Meaning	Value type	Requirement
callerYieldClassIds	Caller yield class ids	list of string	Required
callerYieldClassValues	Caller yield class values	list of number	Required
queryYieldClassId	Query yield class id	string	Required
observedYieldClassValue	Observed yield class value	number	Required

Enter nonempty aligned caller reference IDs and numeric reference values, an exact query ID and an observed value on the same unit and protocol basis. Reference values and the observation must be nonnegative; they need not be integers. IDs must be unique and nonblank, with at most 128 UTF-16 units each. The implementation uses case-sensitive exact matching without trimming, returns the matched reference value and subtracts it from the observation. An absent query or duplicate key fails. No regional dataset is installed, retrieved or authenticated.

reference=values[indexOfExact(queryId,ids)]; signedDifference=observed−reference

Use the exact units, boundary rules, ordering and missing-evidence conventions above.

Output field	Meaning	Value type
callerMatchedYieldClassValue	Caller Matched Yield Class Value; follow the units, sign, ordering and evidence convention stated above	number
signedObservedMinusYieldClassReference	Signed Observed Minus Yield Class Reference; follow the units, sign, ordering and evidence convention stated above	number

json

{
  "input": {
    "callerYieldClassIds": [
      "a",
      "b"
    ],
    "callerYieldClassValues": [
      2,
      4
    ],
    "queryYieldClassId": "b",
    "observedYieldClassValue": 5
  },
  "output": {
    "callerMatchedYieldClassValue": 4,
    "signedObservedMinusYieldClassReference": 1
  }
}

Limitations and assumptions

The numerical reference, unit basis and observation come from the caller. No authoritative regional table, standard edition, calibration or management rule is installed, retrieved or verified.

All listed fields require explicit values. Unexpected fields, incorrect types, nonfinite numbers and sparse evidence arrays fail validation; the specific bounds and alignment requirements are stated above. Extremely large inputs or outputs can also be rejected. An input error is distinct from a successful result reporting false, no matches or missing evidence.

Alternative or Complementary methods

Use Bavarian Volume Table Lookup for this related task: Regional timber-volume conventions associate measurement factors with a named reference method.

Use Stand Volume Table Lookup when its separate inputs and assumptions fit the question: A stand-volume table connects a specified reference key with a volume value under a particular inventory convention.

References

Yield Class Lookup — tool.io

Similar or alternative tools

Bavarian Volume Table Lookup
Regional timber-volume conventions associate measurement factors with a named reference method.
Stand Volume Table Lookup
A stand-volume table connects a specified reference key with a volume value under a particular inventory convention.