singerep/censaurus

A comprehensive, feature-rich, and user-oriented Python package that wraps the U.S. Census Bureau's Data and Geographic APIs.

Censaurus

Not just another Census data tool. Seriously.

censaurus is a comprehensive, feature-rich, and user-oriented Python package that wraps the U.S. Census Bureau's Data and Geographic APIs.

Documentation

Check out the censaurus documentation. There you'll find an introduction to the package, a walkthrough of a censaurus workflow, and full API reference.

Installation

censaurus is available on the Python Package Index, so it can be installed by running the following in the command line:

pip install censaurus

Get Involved

All contributions are welcomed! Please feel free to submit a pull request or point out an issue.

censaurus's Issues

template missing when following the tutorial steps

From the tutorial:

from censaurus import ACS5
acs = ACS5()
acs.variables.filter_by_group(group='B01001').visualize()

Resulting error:

File "lib/python3.11/site-packages/censaurus/graph_utils.py", line 64, in visualize_graph
    g.show(filename)
  File "lib/python3.11/site-packages/pyvis/network.py", line 546, in show
    self.write_html(name, open_browser=False,notebook=True)
  File "lib/python3.11/site-packages/pyvis/network.py", line 515, in write_html
    self.html = self.generate_html(notebook=notebook)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "lib/python3.11/site-packages/pyvis/network.py", line 479, in generate_html
    self.html = template.render(height=height,
                ^^^^^^^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'render'

missing ref in documents

Reading through the Tutorial, noticed this missing reference:

censaurus looks really good, I look forward to trying it out in the future!

Future inclusion of Annual Business Survey (ABS) APIs

Any plans to include Annual Business Survey (ABS) APIs?

using SIMPLE_RENAMER.rename as per the tutorial returns same variable names

acs = ACS5()
male_age_vars = acs.variables.children_of(variable='B01001_002E')
northeast = acs.areas.region('Northeast')
data = acs.tracts(within=northeast, variables=male_age_vars, return_geometry=True)
data = SIMPLE_RENAMER.rename(data)
data

outputs

	B01001_003E	B01001_004E	B01001_005E	B01001_006E	...	GEO_ID	state	county	tract
0	32	15	24	8	...	1400000US23001010100	23	001	010100
...	...	...	...	...	...	...	...	...	...

[14704 rows x 29 columns]