Metadata-Version: 1.1
Name: chicago
Version: 0.4.1
Summary: Chicago meta information and other fun stuff
Home-page: https://github.com/newsapps/python-chicago
Author: Geoff Hing for the Chicago Tribune News Applications Team
Author-email: geoffhing@gmail.com
License: UNKNOWN
Description: python-chicago
        ==============
        
        Information about Chicago and it's geographies. Inspired by
        `python-us <https://github.com/unitedstates/python-us/tree/master/us>`__.
        
        Because sometimes you just need to loop through a list of Chicago
        neighborhoods.
        
        Installation
        ------------
        
        Install using pip:
        
        ::
        
            pip install chicago
        
        Usage
        -----
        
        Iterate over community areas
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from chicago import COMMUNITY_AREAS
            >>> for ca in COMMUNITY_AREAS:
            ...     print(ca.name, ca.number)
            ...
            ('Rogers Park', '1')
            ('West Ridge', '2')
            ('Uptown', '3')
            ('Lincoln Square', '4')
            ('North Center', '5')
            ('Lake View', '6')
            ('Lincoln Park', '7')
            ('Near North Side', '8')
            ('Edison Park', '9')
        
        Get a community area by number
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> COMMUNITY_AREAS.get_by_number(22)
            CommunityArea(name='Logan Square', number='22')
        
        Iterate over neighborhoods
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from chicago import NEIGHBORHOODS
            >>> for n in NEIGHBORHOODS:
            ...     print(n)
            Albany Park
            Andersonville
            Archer Heights
            Armour Square
            Ashburn
            Auburn Gresham
            Austin
            Avalon Park
            Avondale
            Belmont Cragin
        
        Iterate over census tracts
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from chicago import TRACTS
            >>> for tract in TRACTS:
            ...     print(tract)
            17031010100
            17031010100
            17031010100
            17031010100
            17031010201
        
        Get the census tract that contains a Chicago precinct
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from chicago import PRECINCTS
            >>> precinct = PRECINCTS[0]
            >>> from chicago import get_tract_from_precinct_id
            >>> tract = get_tract_from_precinct_id(precinct.full_name)
            >>> print(tract)
        
        Get the census tract that contains a suburban Cook county precinct
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from chicago.cook_suburbs import COOK_SUBURBAN_PRECINCTS, get_suburban_cook_tract_from_precinct_number
            >>> precinct = COOK_SUBURBAN_PRECINCTS[0]
            >>> tract = get_suburban_cook_tract_from_precinct_number(precinct.objectid)
            >>> print(tract)
            17031804202
        
        Data Sources
        ------------
        
        Community Areas
        ~~~~~~~~~~~~~~~
        
        `Boundaries - Community Areas
        (current) <https://data.cityofchicago.org/Facilities-Geographic-Boundaries/Boundaries-Community-Areas-current-/cauq-8yn6>`__)
        
        Neighborhoods
        ~~~~~~~~~~~~~
        
        `Boundaries -
        Neighborhoods <https://data.cityofchicago.org/Facilities-Geographic-Boundaries/Boundaries-Neighborhoods/bbvz-uum9>`__
        from the City of Chicago Data Portal
        
        Building the data
        -----------------
        
        This package uses `Invoke <http://www.pyinvoke.org/>`__ to generate the
        data files that underly the Python API.
        
        Cleaning up build files
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            invoke clean
        
        Building the data files
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        This includes the precinct to census tract crosswalk CSVs.
        
        ::
        
            invoke build
        
Keywords: chicago,geography,city
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
