Relative Median Income Gap Calculator
Signed relative median poor-income gap against independently applicable same-unit threshold; selection of poor cohort and median external. Negative discrepancy retained, not silently classified as impossible evidence.
Description
A relative median income gap relates an independently verified poor-group median to a poverty threshold.
A relative median income gap relates an independently verified poor-group median to a poverty threshold.1
It summarizes that group rather than averaging all individual poverty gaps.
When to use Relative Median Income Gap Calculator
Use this tool to obtain conditionalRelativeMedianGapPercent from the supplied records using the stated calculation. Establish the population, period, variable definitions, sample coverage and independently applicable instrument or calibration.
How to use Relative Median Income Gap Calculator and understand its results
- Establish the population, period, variable definitions, sample coverage and independently applicable instrument or calibration.
- Enter independentlyVerifiedMedianPoorIncome, callerApplicablePovertyThreshold, using the field meanings and rules below, then run the tool.
- Read result.conditionalRelativeMedianGapPercent. Use the units and sign conventions below, and review any unknown records separately.
- Correct any reported input issue and run again. Before using a successful result, check the stated units, signs, reference scope and observation coverage.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| independentlyVerifiedMedianPoorIncome | Independently verified median poor income | number | Required |
| callerApplicablePovertyThreshold | Caller applicable poverty threshold | number | Required |
Require nonnegative independently verified poor-group median income and a positive applicable poverty threshold on the same basis. Return one hundred times threshold-minus-median divided by threshold. A median above threshold yields a negative gap; no group membership or median is computed.
medianGapPercent=100×(povertyLine−poorGroupMedian)/povertyLine Use the matching field units and the exact boundary, ordering and reference rules above.
| Output field | Meaning | Value type |
|---|---|---|
| result | Calculated observation or qualified reference | object |
| result.conditionalRelativeMedianGapPercent | Poverty-line-minus-poor-group-median divided by the line, times 100. | number |
{
"input": {
"independentlyVerifiedMedianPoorIncome": 60,
"callerApplicablePovertyThreshold": 100
},
"output": {
"result": {
"conditionalRelativeMedianGapPercent": 40
}
}
}Limitations and assumptions
Population definitions, survey design, calibration and observation coverage are independently established. A result describes the supplied record or conditional model without demonstrating causation, validating an instrument or supplying representative population evidence.
Missing required fields, unknown fields, wrong types and violated rules return input issues. Numeric values and outputs must be finite. Extremely large composite outputs are rejected.
Alternative or Complementary methods
For a related step, use Local Income Rank Status Anxiety Calculator: A local income midrank locates one observation within a declared reference sample. For a complementary comparison, use Relative Deprivation Rung Index Calculator: A ladder-based deprivation comparison uses declared reference and personal rungs.
References
-
Relative Median Income Gap Calculator — tool.io
Similar or alternative tools
- Local Income Rank Status Anxiety Calculator
A local income midrank locates one observation within a declared reference sample.
- Relative Deprivation Rung Index Calculator
A ladder-based deprivation comparison uses declared reference and personal rungs.