Skip to main content

censusdis

U.S. Map of Integration

Hippocratic License HL3-CL-ECO-EXTR-FFD-LAW-MIL-SV PyPI PyPI - Python Version

PyPI - Status PyPI - Format PyPI - Downloads

GitHub last commit Tests Badge Coverage Badge Documentation Status

censusdis is a package for discovering, loading, and analyzing U.S. Census 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.

Installation and First Example

censusdis can be installed with pip:

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.

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 repository. This tutorial was presented at PyData Seattle 2023. 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 in your browser without needing to set up a local development environment or download or install any code.

Tutorial Video

A 86 minute video of the tutorial as presented at PyData Seattle 2023 is also available.

PyData Seattle Tutorial Video

More Details

For the full README, lots of maps, demo notebooks, and more, please visit the censusdis source repository.

Metadata

Release files for censusdis 1.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for censusdis 1.4.2
File Size Uploaded
censusdis-1.4.2.tar.gz 399.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for censusdis 1.4.2
File Interpreter ABI Platform
censusdis-1.4.2-py3-none-any.whl Python 3 none any Details

Total release size: 835.3 kB

Release files / censusdis-1.4.2.tar.gz

Download URL censusdis-1.4.2.tar.gz
Size 399.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4049d94b7dd1eee57455f728c0cb2f2b4924c4b4f7576c9ba83fe004f02bc6f4
BLAKE2b-256 checksum
How to use checksums
0b5f5804be451947bf33181b69b4d10778d16502b11cbf4d4695a2a29fac4873
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.11.4 Darwin/24.5.0

Release files / censusdis-1.4.2-py3-none-any.whl

Download URL censusdis-1.4.2-py3-none-any.whl
Size 435.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d737e803b4edfb69f69b7689d2db0accc870cc61f47ec4278c68ae9ed934db3a
BLAKE2b-256 checksum
How to use checksums
25b77307a30e86ef25ded7732dc54f61aecada587239fe10268cffa5ebc17928
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.11.4 Darwin/24.5.0

Release history Release notifications | RSS feed

This release

1.4.2 This release

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3.0

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.13

2 release files

1.1.12

2 release files

1.1.11

2 release files

1.1.10

2 release files

1.1.9

2 release files

1.1.8

2 release files

1.1.7

2 release files

1.1.6

2 release files

1.1.5

2 release files

1.1.4

2 release files

1.1.3

2 release files

1.1.1

2 release files

1.0.1

2 release files

0.99.9

2 release files

0.99.8

2 release files

0.99.7

2 release files

0.99.0

2 release files

0.15.1

2 release files

0.14.0

2 release files

0.13.4

2 release files

0.13.3

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.1

2 release files

0.12.0

2 release files

0.11.0

2 release files

0.10.6

2 release files

0.10.5

2 release files

0.10.3

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.8

2 release files

0.8.7

2 release files

0.8.6

2 release files

0.8.5

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.7.7

2 release files

0.7.5

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page