Description
Return observed/eligible, or zero with defined=false when eligible is zero.
Agroforestry observations combine sampled areas, cohort counts, source uncertainty and caller-supplied response assumptions. A sample expansion or conditional yield term can be computed independently of sampling representativeness or a validated tree-crop interaction. Unknown source flags must retain their reporting meaning.
Return observed/eligible, or zero with defined=false when eligible is zero.
When to use this tool
Use Tree Cohort Observation Share when checking the stated cohort, sample-expansion or assumed-response convention.
How to use the tool and how it works
- Enter observed, eligible. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read share, defined. Inspect defined before interpreting the associated values.
Require whole counts 0<=observed<=eligible. Return observed/eligible, or zero with defined=false when eligible is zero.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| observed | Observed | Required. Safe integer; minimum 0. |
| eligible | Eligible | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| 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. |
{
"input": {
"observed": 80,
"eligible": 100
},
"output": {
"share": 0.8,
"defined": true
}
}Limitations and assumptions
- This is observed coverage on the supplied eligible population, not a detection-probability estimate.
- 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 representative verified samples and an appropriate complete ecological/statistical model for abundance, yield response and uncertainty.
References
Similar or alternative tools
- Tree Cohort Source Unknown Share
Sum counts exactly, including those whose source ID equals unknownToken; export both totals as decimal text and their numeric share, or zero with defined=false for no trees.
- Agroforestry Establishment Cost Tree Share Tool
Calculate agroforestry establishment cost tree share from explicit caller-supplied inputs.