Description
Calculate verified trade-quantity support after converting all records to a common supplied unit.
Archival comparability and coverage depend on source labels, time boundaries, verification assertions and common-unit conversions. Matching text or balanced totals can support record review without authenticating sources or proving completeness.
Calculate verified trade-quantity support after converting all records to a common supplied unit.
When to use this tool
Use Archival Trade Quantity Share when checking a supplied archival record or support convention.
How to use the tool and how it works
- Enter quantities, unitToCommon, verified. 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 totalCommonQuantity, verifiedCommonQuantity, verifiedShare, defined. Inspect defined before interpreting the associated values.
Require equally long quantities, unitToCommon and verified arrays, nonnegative quantities and positive conversion factors. Sum quantity*factor into totalCommonQuantity and verified records into verifiedCommonQuantity; verifiedShare is their ratio, or zero with defined = false for zero total.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| quantities | Quantities | Required. Array of finite number; minimum 0; maximum items 256. |
| unitToCommon | Unit To Common | Required. Array of finite number; maximum items 256. |
| verified | Verified | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| totalCommonQuantity | Total Common Quantity | Required. Finite number. |
| verifiedCommonQuantity | Verified Common Quantity | Required. Finite number. |
| verifiedShare | Verified Share | Required. Finite number. |
| defined | Whether the stated denominator has positive support; read this before interpreting a zero placeholder. | Required. Boolean. |
{
"input": {
"quantities": [
2,
3
],
"unitToCommon": [
2,
1
],
"verified": [
true,
false
]
},
"output": {
"totalCommonQuantity": 7,
"verifiedCommonQuantity": 4,
"verifiedShare": 0.5714285714285714,
"defined": true
}
}Limitations and assumptions
- Verification flags and conversion factors are supplied. Common-unit quantity share is not monetary trade share, source authenticity or proof of complete archival coverage.
- 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
Inspect the original sources and document the historical meaning of labels, dates and conversion factors.
References
Similar or alternative tools
- Raster Pixel Ground Support Share
validGroundArea sums valid pixels; observedGroundArea additionally requires observed; share is their ratio when positive, otherwise zero with defined = false.
- Residual Score Moment Term
Summarize one weighted residual-score moment and its denominator-aware mean.