Description
Sum duration*weight across all windows into weightedTotal and only observed windows into weightedCovered.
Environmental monitoring coverage depends on what counts in the denominator. Time, effort, area, sampled volume and exposure weights describe different support measures; excluding missing or ineligible portions changes the question answered by a fraction.
Sum duration*weight across all windows into weightedTotal and only observed windows into weightedCovered.
When to use this tool
Use Noise Window Weight Coverage Token when checking a monitoring or sampling share with an explicit inclusion and overlap convention.
How to use the tool and how it works
- Enter windowDurations, observed, suppliedWeights. 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 weightedCovered, weightedTotal, fraction, defined. Inspect defined before interpreting the associated values.
Require equally long windowDurations, observed and suppliedWeights arrays, with nonnegative durations and weights. Sum duration*weight across all windows into weightedTotal and only observed windows into weightedCovered. Return fraction = weightedCovered/weightedTotal when positive, otherwise fraction = 0 and defined = false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| windowDurations | Window Durations | Required. Array of finite number; maximum items 256. |
| observed | Position-aligned flags identifying which supplied records are observed. | Required. Array of boolean; maximum items 256. |
| suppliedWeights | Nonnegative linear duration weights, not decibel energy or acoustic penalties. | Required. Array of finite number; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| weightedCovered | Weighted Covered | Required. Finite number. |
| weightedTotal | Weighted Total | Required. Finite number. |
| fraction | Dimensionless ratio under the stated denominator convention; not multiplied by 100. | Required. Finite number. |
| defined | Whether the denominator is positive and the returned ratio is defined; inspect this before using a zero placeholder. | Required. Boolean. |
{
"input": {
"windowDurations": [
2,
3
],
"observed": [
true,
false
],
"suppliedWeights": [
2,
1
]
},
"output": {
"weightedCovered": 4,
"weightedTotal": 7,
"fraction": 0.5714285714285714,
"defined": true
}
}Limitations and assumptions
- Weights are caller-defined linear importance weights, not decibel energy or a standardized noise penalty. A zero weighted total is undefined even if windows exist; overlap and measurement validity are not inferred.
- 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
Review source intervals and sampling design, and compute overlaps from actual records when an aggregate deduction cannot be justified.
References
Similar or alternative tools
- Environmental Noise Log Energy One Period
Sum durations and choose max as the largest level among positive-duration records.
- Filter Uptime Exposure Share
Sum flowRate*duration across all records into possibleVolume and only operating records into filteredVolume.