Description
Sum population with both flags true and divide by total, or return share zero and defined false for zero total.
Population indicators depend on compatible boundaries, time periods, counted groups, and denominator choices. A share or density can change when exclusions or daytime populations change, even without arithmetic error.
Sum population with both flags true and divide by total, or return share zero and defined false for zero total.
When to use this tool
Use Neighborhood Population Support Share when you need one transparent population-accounting component.
How to use the tool and how it works
- Enter populations, boundaryMatched, periodMatched. 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 populationTotal, supportedPopulation, share, defined. Inspect defined before interpreting the associated values.
Require aligned nonnegative populations and boundaryMatched and periodMatched flags. Sum population with both flags true and divide by total, or return share zero and defined false for zero total.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| populations | Populations | Required. Array of finite number; minimum 0; maximum items 256. |
| boundaryMatched | Boundary Matched | Required. Array of boolean; maximum items 256. |
| periodMatched | Period Matched | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| populationTotal | Population Total | Required. Finite number. |
| supportedPopulation | Supported Population | Required. Finite number. |
| share | Dimensionless share under the stated denominator and exclusion convention. | Required. Finite number. |
| defined | Whether the associated ratio has its required denominator; inspect before using a zero placeholder. | Required. Boolean. |
{
"input": {
"populations": [
10,
20,
30
],
"boundaryMatched": [
true,
true,
false
],
"periodMatched": [
true,
false,
true
]
},
"output": {
"populationTotal": 60,
"supportedPopulation": 10,
"share": 0.16666666666666666,
"defined": true
}
}Limitations and assumptions
- This is population-weighted supplied support, not a row-count fraction or independent verification of geographic and temporal comparability.
- 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 definitions, geography, temporal alignment, and uncertainty before making a demographic or service-access conclusion.
References
Similar or alternative tools
- Population Grid Cell Area Share
Return eligibleCellArea and eligibleCellArea/studyArea.
- Settlement Boundary Ageflag
Return observationYear-boundaryVintageYear, mark futureVintage for a negative age, and currentUnderLimit only for a nonnegative age no greater than suppliedMaxAge.