Metadata-Version: 2.1
Name: pyquakes
Version: 0.0.1
Summary: PyQuakes is a Python wrapper for USGS Earthquake Catalog API that manages data querying and result processing.
Home-page: https://github.com/shenjianan97/PyQuakes
Author: Jianan Shen, Chen Mo
Author-email: shenjianan97@gmail.com, mochen1228@gmail.com
License: UNKNOWN
Description: # PyQuakes
        PyQuakes is a Python wrapper for [USGS Earthquake Catalog API](https://earthquake.usgs.gov/fdsnws/event/1/) that manages data querying and result processing. PyEarthquake also integrates [Bing Map API](https://docs.microsoft.com/en-us/bingmaps/rest-services/locations/find-a-location-by-query) to manage geolocation of events.
        
        ## Features of PyQuakes
        - Handles the HTTP requests, and the HTTP error. Only needs to focus on setting parameters and data processing.
        - Supports setting the query parameters   
        - Supports searching with multiple time periods with easy-to-understand time format.
        - Supports searching with multiple locations with pre-defined location classes.
        - Provides geocoding functionality so that users are able to search the location without finding the coordinates.
        - Supports filtering, sorting and organizing the result.
        
        ## Getting Started
        Follow the instructions of Bing Map to [get your own key](https://docs.microsoft.com/en-us/bingmaps/getting-started/bing-maps-dev-center-help/getting-a-bing-maps-key) and copy your Bing Map Key in key.txt file under src foler.
        
        ## How to use
        The EarthquakeQuery class has to be imported to use the API.
        
        Import other classes if you would like to search by time and location or set other parameters.
        
        ## Example
        To use geocode API, please specify the path of the key file first:
        ```
        EarthquakeQuery.set_geocode_key_path("filepath")
        ```
        
        A typical usage to search a collection of results is:
        ```
        from pyquakes import GeoRectangle, EarthquakeQuery, TimeFrame
        import datetime
        
        query = EarthquakeQuery()
        query.set_time([TimeFrame(datetime(2010, 1, 1), datetime(2015, 1, 1))])
        query.set_max_depth(1.0)
        result = query.search()
        ```
        
        A typical usage to search a specific earthquake by its event id is:
        ```
        from pyquakes import EarthquakeQuery
        
        event_id = "usc000lvb5"
        result = EarthquakeQuery.search_by_event_id(event_id)
        ```
        For more examples, please refer to the **client** folder. Several use cases are contained in the clinet folder with example codes. See the function without **original** suffix.
        
        ## Test
        Tests are placed in the test folder.
        Please cd into the folder and run each of the py files for testing.
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
