Description
missingWeight sums unobserved weights; share divides it by total weight when positive, otherwise returns zero with defined = false.
Ecological sampling summaries distinguish effort, weighted support, taxon counts and relative composition. A denominator-specific fraction or single-species contribution need not describe abundance, completeness or a whole-community index.
missingWeight sums unobserved weights; share divides it by total weight when positive, otherwise returns zero with defined = false.
When to use this tool
Use Trait Weight Missing Share when checking a supplied ecological effort, support or count convention.
How to use the tool and how it works
- Enter weights, observed. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read missingWeight, share, defined. Inspect defined before interpreting the associated values.
Require equally long nonnegative weights and observed flags. missingWeight sums unobserved weights; share divides it by total weight when positive, otherwise returns zero with defined = false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| weights | Position-aligned nonnegative weights under the specified model convention. | Required. Array of finite number; minimum 0; maximum items 256. |
| observed | Position-aligned flags specifying which records are observed. | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| missingWeight | Missing Weight | Required. Finite number. |
| share | Dimensionless selected contribution divided by the stated total; not percent. | Required. Finite number. |
| defined | Whether the stated denominator has positive support; read this before interpreting a zero placeholder. | Required. Boolean. |
{
"input": {
"weights": [
1,
3
],
"observed": [
true,
false
]
},
"output": {
"missingWeight": 3,
"share": 0.75,
"defined": true
}
}Limitations and assumptions
- The share concerns missing weight, not observed weight. It does not impute traits, infer random missingness or validate community representativeness.
- 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 an appropriate sampling, detection and community-analysis method for inference beyond these local summaries.
References
Similar or alternative tools
- Ecological Time Support Gap
Sum elapsed intervals, support and their difference into totalDuration, supportedDuration and missingDuration.
- Ecological Plot Effective Area
effectiveArea = grossArea-sum(excludedAreas)+overlapCorrection.