Metadata-Version: 2.1
Name: censusdis
Version: 0.4.2
Summary: US Census utilities for a variety of data loading and mapping purposes.
Home-page: https://github.com/vengroff/censusdis
License: HL3-CL-ECO-EXTR-FFD-LAW-MIL-SV
Keywords: census,demographics
Author: vengroff
Author-email: vengroff@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.9
Provides-Extra: docs
Requires-Dist: Rtree (>=1.0.0,<2.0.0)
Requires-Dist: Sphinx (>=5.1.1,<6.0.0); extra == "docs"
Requires-Dist: divintseg (>=0.1.3,<0.2.0)
Requires-Dist: geopandas (>=0.11.1,<0.12.0)
Requires-Dist: matplotlib (>=3.5.3,<4.0.0)
Requires-Dist: requests (>=2.28.1,<3.0.0)
Requires-Dist: sphinx-rtd-theme (==1.0.0); extra == "docs"
Requires-Dist: sphinxcontrib-napoleon (==0.7); extra == "docs"
Project-URL: Repository, https://github.com/vengroff/censusdis
Description-Content-Type: text/markdown

# censusdis

[![Hippocratic License HL3-CL-ECO-EXTR-FFD-LAW-MIL-SV](https://img.shields.io/static/v1?label=Hippocratic%20License&message=HL3-CL-ECO-EXTR-FFD-LAW-MIL-SV&labelColor=5e2751&color=bc8c3d)](https://firstdonoharm.dev/version/3/0/cl-eco-extr-ffd-law-mil-sv.html)

## Introduction 

`censusdis` is a package for discovering, loading, analyzing, and computing
diversity, integration, and segregation metrics
to U.S. Census demographic data. 

It can be installed in any python 3.9+ virtual environment using

```shell
pip install censusdis
```

## Modules

The modules that make up the `censusdis` package are

| Module                | Description                                                                |
|-----------------------|:---------------------------------------------------------------------------|
| `censusdis.geography` | Code for managing geography hierarchies in which census data is organized. | 
| 'censusdis.data`      | Code for fetching data from the US Census API, including managing datasets, groups, and variable hierarchies. |
| `censusdis.maps`      | Code for downloading map data from the US, caching it locally, and using it to render maps. |
| `censusdis.states`    | Constants defining the US States. Used by the three other modules. |

## Demonstration Notebooks

There are several demonstration notebooks avaialable to illustrate how `censusdis` can
be used. They are found in the 
[notebook](https://github.com/vengroff/censusdis/tree/main/notebooks) 
directory of the source code.

The notebooks include

| Notebook Name                                                                                                      | Description                                                                                                                                                         |
|--------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [SoMa DIS Demo.ipynb](https://github.com/vengroff/censusdis/blob/main/notebooks/SoMa%20DIS%20Demo.ipynb)           | Load race and ethhicity data for two twons in Essex County, NJ and compute diversity and integration metrics.                                                       |
| [ACS Demo.ipynb](https://github.com/vengroff/censusdis/blob/main/notebooks/ACS%20Demo.ipynb)                       | Load American Community Survey (ACS) data for New Jersey and plot diversity statewide at the census block group level.                                              |
| [Seeing White.ipynb](https://github.com/vengroff/censusdis/blob/main/notebooks/Seeing%20White.ipynb)               | Load nationwide demographic data at the county level and plot of map of the US showing the percent of the population wh identify as white only at the county level. | 
| [Map Demo.ipynb](https://github.com/vengroff/censusdis/blob/main/notebooks/Map%20Demo.ipynb)                       | Demonstrate loading at plotting maps of New Jersey at different geographic granularity.                                                                             |
| [Exploring Variables.ipynb](https://github.com/vengroff/censusdis/blob/main/notebooks/Exploring%20Variables.ipynb) | Load metatdata on a group of variables, visualize the tree hierarchy of variables in the group, and load data from the leaves of the tree.                          |


## Diversity and Integration Metrics

Diversity and integration metrics from the `divintseg` package are 
demonstrated in some of the notebooks.

For more information on these metrics
see the [divintseg](https://github.com/vengroff/divintseg/) 
project.


