Metadata-Version: 1.1
Name: census-pgeoloader
Version: 0.1.3
Summary: Load Census shapefiles into PostGIS
Home-page: https://github.com/The-Politico/census_pgeoloader/
Author: Jon McClure
Author-email: jmcclure@politico.com
License: GPLv3
Description: ![POLITICO](https://rawgithub.com/The-Politico/src/master/images/logo/badge.png)
        
        # census_pgeoloader
        
        Command line utility to download Census TIGER/Line shapefiles by state from the U.S. Census Bureau and aggregate them into a single table in a PostGIS-enabled database.
        
        # Requirements
        
        Uses [shp2pgsql](http://www.bostongis.com/pgsql2shp_shp2pgsql_quickguide.bqg). Assumes PostgreSQL + PostGIS.
        
        # To install
        
        ```bash
        $ pip install census_pgeoloader
        ```
        
        # To use
        
        Pass a connection URI to your PostgreSQL database as well as the states you'd like to aggregate. This will dowload tract-level shapefiles by default.
        
        ```bash
        $ pgeoloader postgres://postgres@localhost:5432/database KS MO TX VA ...
        ```
        
        Valid values for states are FIPS codes, postal abbreviations or names. Pass `+` to collect all states.
        
        # Options
        
        ```bash
        Options:
          -t, --table TEXT               Name of table to create in DB. Default is
                                         "census_shapes".
          -p, --temp TEXT                Directory to download files to. Default is
                                         "./shapefiles"
          -y, --year TEXT                Year. Default is "2016".
          -g, --geo [tract|group|block]  Geographic unit. Default is "tract".
          -s, --srid TEXT                Specify an SRID transform, e.g., "4269:4326".
                                         Default is "4269".
          --help                         Show this message and exit.
        ```
        
        #### Notes:
        
        - `--table` Drops any existing table by that name in the database.
        - `--geo` Can pull tracts, block groups or blocks.
        - `--srid` Default SRID should be 4269, but you can specify a transform with this option as available in [shp2pgsql](http://www.bostongis.com/pgsql2shp_shp2pgsql_quickguide.bqg).
        
        ©2017 POLITICO
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Sociology
