Skip to main content

Classes for working with US Census geoids

Project description

geoid

Classes for working with census geoids

This module provides dynamically generated classes for parsing and creating each of the approximately 85 Census summary levels. It can parse the forms of genoides that appear in the Decenial Census, the ACS, and Tiger files. Additionally, it can read and write a more compact format, civick, that use base62 representation for the numbers.

Use

The geoid module in file geoid/init.py, has a list of the geoid classes that you can instantiate. Or, to print the list:

$ python -c 'import geoid; print geoid.names'

The first dozen are the ones you'll use most frequently:

'us': 10,
'region': 20,
'division': 30,
'state': 40,
'county': 50,
'cosub': 60,
'place': 160,
'ua': 400,
'tract': 140,
'blockgroup': 150,
'block': 101,
'sdelm': 950,
'sdsec': 960,
'sduni': 970,
'zcta': 860

The classes are all dynamically generated, so you won't be able to find a class file.

from geoid import acs
g = acs.Blockgroup(53, 33, 1800, 3)
print g.state, g.county.g.tract.g.blockgroup

gs = str(g)
g = acs.AcsGeoid.parse(gs)

Creating

TBD

Parsing

TBD

Parse Generally, or parse to a specific class.

Access Members

Promotion, Conversion, Summarization, AllVals

Promote: create a higher level geoid from a lower level one Convert: Change the type, for instance from a Census geoid to an ACS geoid Summarize: Create a value to represent a summary level AllVal: Create a value to represent coverage of an entire region

Caveats

The geoids don't preserve the component, so, for instance, '03001US1' will get changed to '03000US1'

Running tests

git clone git@github.com:CivicKnowledge/geoid.git
cd geoid
python setup.py test

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geoid-1.1.5.tar.gz (45.6 kB view details)

Uploaded Source

File details

Details for the file geoid-1.1.5.tar.gz.

File metadata

  • Download URL: geoid-1.1.5.tar.gz
  • Upload date:
  • Size: 45.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.5

File hashes

Hashes for geoid-1.1.5.tar.gz
Algorithm Hash digest
SHA256 0767479413261cb58a507d27a2f3354285df97202058cae4a33a289eeed04791
MD5 cf7d9c22f066e133363bd80f0dfff887
BLAKE2b-256 8f36c4c905ad5036d801a23af0874bb2eb917487ff9edb162eb86a8615028237

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page