Description
Check budget-unit comparability and return a normalized amount.
Community projects combine participation counts, access assertions, funding bases and shared-resource policies. Local allocation or coverage arithmetic can organize those records, while equitable access, actual contribution value and valid funding rights require evidence and the applicable rules.
Check budget-unit comparability and return a normalized amount.
When to use this tool
Use Resident Ballot Budget Unit Token when checking one explicit community-project capacity, funding, access or scheduling convention.
How to use the tool and how it works
- Enter allocated, unit, expectedUnit, suppliedConversion, conversionKnown. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read comparable, normalized. Inspect comparable before interpreting the associated values.
Check budget-unit comparability and return a normalized amount. Require suppliedConversion > 0; comparable means unit labels match or conversionKnown, normalized uses identity for matching labels and the supplied factor otherwise, or zero if incomparable.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| allocated | Allocated | Required. Finite number. |
| unit | Unit | Required. Text; maximum UTF-16 length 8192. |
| expectedUnit | Expected Unit | Required. Text; maximum UTF-16 length 8192. |
| suppliedConversion | Supplied Conversion | Required. Finite number; strictly above 0. |
| conversionKnown | Conversion Known | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| comparable | Comparable | Required. Boolean. |
| normalized | Converted amount only when comparable; zero placeholder otherwise. | Required. Finite number. |
{
"input": {
"allocated": 100,
"unit": "credits",
"expectedUnit": "currency",
"suppliedConversion": 2,
"conversionKnown": true
},
"output": {
"comparable": true,
"normalized": 200
}
}Limitations and assumptions
- Zero with comparable false is a placeholder; a claimed conversion is not verified and no budget policy is selected.
- 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 actual project records, participant needs and governing funding/resource rules to assess practical adequacy, fairness and eligibility.
References
Similar or alternative tools
- Community Match Funding In Kind Share
Return in-kind share on a matched resource-unit basis.
- Survey Response Area Weight
Return one neighborhood's basis-weighted response contribution.