# `censusdis`
[](https://firstdonoharm.dev/version/3/0/cl-eco-extr-ffd-law-mil-sv.html)
[](https://censusdis.readthedocs.io/en/latest/?badge=latest)
censusdis is a package for discovering, loading, analyzing, and computing diversity, integration, and segregation metrics to U.S. Census demographic data.
It is designed
- to support **every dataset**, **every geography, and every year**. It's not just about ACS data through the last time the software
was updated and released;
- to support **all geographies, on and off-spine**, not just states, counties, and census tracts;
- to have **integrated mapping capabilities** that save you time and extra coding;
- to be intuitive, Pythonic, and fast.
## Note:
For the full README, please visit the
[censusdis source repository](https://github.com/vengroff/censusdis).
## Installation and First Example
censusdis can be installed with `pip`:
```shell
pip install censusdis
```
Every censusdis query needs four things:
1. What data set we want to query.
2. What vintage, or year.
3. What variables.
4. What geographies.
Here is an example of how we can use censusdis to download data once we know
those four things.
```python
import censusdis.data as ced
from censusdis.datasets import ACS5
from censusdis import states
df_median_income = ced.download(
# Data set: American Community Survey 5-Year
dataset=ACS5,
# Vintage: 2022
vintage=2022,
# Variable: median household income
download_variables=['NAME', 'B19013_001E'],
# Geography: All counties in New Jersey.
state=states.NJ,
county='*'
)
```
There are many more examples in the tuturial and in the sample notebooks.
## Tutorial (A Great Place to Start!)
For a tutorial, please see the [censusdis-tutorial](https://github.com/vengroff/censusdis-tutorial) repository.
This tutorial was presented at [PyData Seattle 2023](https://pydata.org/seattle2023/). If you want to try it out for yourself, the README.md
contains links that let you run the tutorial notebooks live on [mybinder.org](https://mybinder.org/) in your browser without needing to set up a
local development environment or download or install any code.
### Tutorial Video
A 86 minute
[video](https://www.youtube.com/watch?v=3vyC7ON0Tvg)
of the tutorial as presented at
[PyData Seattle 2023](https://pydata.org/seattle2023/)
is also available.
[](https://www.youtube.com/watch?v=3vyC7ON0Tvg)
## More Details
For the full README, lots of maps, demo notebooks, and more, please visit the
[censusdis source repository](https://github.com/vengroff/censusdis).
Raw data
{
"_id": null,
"home_page": "https://github.com/vengroff/censusdis",
"name": "censusdis",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "census, demographics",
"author": "Darren Vengroff",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b8/20/d9984b4cb726298fa5cf578f376d32beb9d23292a4128711566537cada0f/censusdis-1.2.1.tar.gz",
"platform": null,
"description": "# `censusdis`\n\n\n\n[](https://firstdonoharm.dev/version/3/0/cl-eco-extr-ffd-law-mil-sv.html)\n\n\n\n\n\n\n\n\n\n\n[](https://censusdis.readthedocs.io/en/latest/?badge=latest)\n\ncensusdis is a package for discovering, loading, analyzing, and computing diversity, integration, and segregation metrics to U.S. Census demographic data. \nIt is designed\n\n- to support **every dataset**, **every geography, and every year**. It's not just about ACS data through the last time the software\nwas updated and released;\n- to support **all geographies, on and off-spine**, not just states, counties, and census tracts;\n- to have **integrated mapping capabilities** that save you time and extra coding;\n- to be intuitive, Pythonic, and fast.\n \n## Note:\n\nFor the full README, please visit the \n[censusdis source repository](https://github.com/vengroff/censusdis).\n\n## Installation and First Example\n\ncensusdis can be installed with `pip`:\n\n```shell\npip install censusdis\n```\n\nEvery censusdis query needs four things:\n\n1. What data set we want to query.\n2. What vintage, or year.\n3. What variables.\n4. What geographies.\n\nHere is an example of how we can use censusdis to download data once we know\nthose four things.\n\n```python\nimport censusdis.data as ced\nfrom censusdis.datasets import ACS5\nfrom censusdis import states\n\ndf_median_income = ced.download(\n # Data set: American Community Survey 5-Year\n dataset=ACS5,\n \n # Vintage: 2022\n vintage=2022, \n \n # Variable: median household income\n download_variables=['NAME', 'B19013_001E'], \n \n # Geography: All counties in New Jersey.\n state=states.NJ,\n county='*'\n)\n```\n\nThere are many more examples in the tuturial and in the sample notebooks.\n\n## Tutorial (A Great Place to Start!)\n\nFor a tutorial, please see the [censusdis-tutorial](https://github.com/vengroff/censusdis-tutorial) repository.\nThis tutorial was presented at [PyData Seattle 2023](https://pydata.org/seattle2023/). If you want to try it out for yourself, the README.md\ncontains links that let you run the tutorial notebooks live on [mybinder.org](https://mybinder.org/) in your browser without needing to set up a\nlocal development environment or download or install any code.\n\n### Tutorial Video\n\nA 86 minute \n[video](https://www.youtube.com/watch?v=3vyC7ON0Tvg) \nof the tutorial as presented at \n[PyData Seattle 2023](https://pydata.org/seattle2023/)\nis also available.\n\n[](https://www.youtube.com/watch?v=3vyC7ON0Tvg)\n\n## More Details\n\nFor the full README, lots of maps, demo notebooks, and more, please visit the \n[censusdis source repository](https://github.com/vengroff/censusdis).\n\n",
"bugtrack_url": null,
"license": "HL3-CL-ECO-EXTR-FFD-LAW-MIL-SV",
"summary": "US Census utilities for a variety of data loading, analysis, and mapping purposes.",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://github.com/vengroff/censusdis",
"Repository": "https://github.com/vengroff/censusdis"
},
"split_keywords": [
"census",
" demographics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec2f49a6c01124f1a77e23d0241599bfb9bd3d28851e965c04cb8a4789402279",
"md5": "7ec8651fa0498884e0cc8992f69dd7d1",
"sha256": "519767aa5c15e548e8443e9cd77e0bcf4580a49bd3a484385d6cc89caff314b9"
},
"downloads": -1,
"filename": "censusdis-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ec8651fa0498884e0cc8992f69dd7d1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 427971,
"upload_time": "2024-07-21T23:48:59",
"upload_time_iso_8601": "2024-07-21T23:48:59.560041Z",
"url": "https://files.pythonhosted.org/packages/ec/2f/49a6c01124f1a77e23d0241599bfb9bd3d28851e965c04cb8a4789402279/censusdis-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b820d9984b4cb726298fa5cf578f376d32beb9d23292a4128711566537cada0f",
"md5": "cd6adaaf14e1e5fee412db4aff71023c",
"sha256": "4e8139a2fb791364586b2338585d3475a971ddc3cb6a4cfaf2c4a3c41ea59ad6"
},
"downloads": -1,
"filename": "censusdis-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "cd6adaaf14e1e5fee412db4aff71023c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 390413,
"upload_time": "2024-07-21T23:49:01",
"upload_time_iso_8601": "2024-07-21T23:49:01.457765Z",
"url": "https://files.pythonhosted.org/packages/b8/20/d9984b4cb726298fa5cf578f376d32beb9d23292a4128711566537cada0f/censusdis-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-21 23:49:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vengroff",
"github_project": "censusdis",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "censusdis"
}
JSON
