https://github.com/datadesk/census-error-analyzer
Analyze the margin of error in U.S. census data
https://github.com/datadesk/census-error-analyzer
census data-journalism journalism mapping-la-pipeline margin-of-error math news python statistics
Last synced: 6 months ago
JSON representation
Analyze the margin of error in U.S. census data
- Host: GitHub
- URL: https://github.com/datadesk/census-error-analyzer
- Owner: datadesk
- License: mit
- Created: 2019-06-20T14:55:37.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2023-02-23T19:47:56.000Z (over 2 years ago)
- Last Synced: 2025-03-24T10:21:26.632Z (7 months ago)
- Topics: census, data-journalism, journalism, mapping-la-pipeline, margin-of-error, math, news, python, statistics
- Language: Python
- Homepage:
- Size: 136 KB
- Stars: 18
- Watchers: 3
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# census-error-analyzer
Analyze the margin of error in U.S. census data
## Installation
```bash
pipenv install census-error-analyzer
```
## Usage
Import the library.
```python
import census_error_analyzer
```
### Test statistical difference
Are two values, considering their respective margins of error, statistically different? The Census Bureau advises that this test be conducted for all comparisons. This test answers the question and returns `True` or `False`.
Accepts two lists, each expected to be a pair with a value and its margin of error.
```python
us_medianage, us_medianage_moe = 37.9, 0.1
nyc_medianage, nyc_medianage_moe = 38.4, 0.1
census_error_analyzer.is_statistically_different(
(us_medianage, us_medianage_moe), (nyc_medianage, nyc_medianage_moe)
)
True
```
The precise difference can also be accessed. According to the Census Bureau, values greater than 1.0 can be considered to be statistically significant.
```python
census_error_analyzer.statistical_difference(
(us_medianage, us_medianage_moe), (nyc_medianage, nyc_medianage_moe)
)
3.535533905932737
```
### Get statistical range
The minimum and maximum values in an estimate's statistical range given its margin of error. Expects two arguments: The estimate first. The margin of error second.
```python
census_error_analyzer.statistical_range(us_medianage, us_medianage_moe)
37.8, 38.0
```
### Convert to alternative confidence levels
The margins of error published by the Census are at the 90% confidence level. They can be converted to the 95% and 99% levels using tools in this library.
```python
census_error_analyzer.convert_to_95_percent_confidence(3778)
4501.446808510638
census_error_analyzer.convert_to_99_percent_confidence(3778)
5925.373860182372
```
## References
This module was designed to conform with the Census Bureau's April 18, 2018, presentation ["Using American Community Survey Estimates and Margin of Error."](https://www.documentcloud.org/documents/6162551-20180418-MOE.html)
Prior to publication, the code was reviewed by Brian Dumbacher, a mathematical statistician in the U.S. Census Bureau's Economic Statistical Methods Division.
## Links
* Issues: [github.com/datadesk/census-error-analyzer/issues](https://github.com/datadesk/census-error-analyzer/issues)
* Packaging: [pypi.python.org/pypi/census-error-analyzer](https://pypi.python.org/pypi/census-error-analyzer)
* Testing: [github.com/datadesk/census-error-analyzer/actions](https://github.com/datadesk/census-error-analyzer/actions)