Metadata-Version: 2.1
Name: oec
Version: 0.2.5
Summary: API Wrapper for The Observatory for Economic Complexity
Home-page: https://github.com/yahiaali/oec
Author: Yahia Ali
Author-email: yahiaali@me.com
License: MIT
Description: # Python Wrapper for The Observatory for Economic Complexity API
        
        **Language:** Python 3   
        **Data Source:** [Observatory for Economic Complexity (OEC)](https://atlas.media.mit.edu/en/resources/data/)
        
        ## Installation
        ```
        pip install oec
        ```
        ## Usage
        **Get data from OEC**
        ```
        import oec
        
        # Set parameters in accordance with API documentation
        params = {'classification': 'hs92',
        		  'trade_flow': 'export',
        		  'year': 2015,
        		  'origin': 'egy',
        		  'destination': 'all',
        		  'product': 'show'}
        
        list_of_countries = oec.get_countries()
        list_of_products = oec.get_products(params['classification'])
        list_of_exports = oec.get_trade(**params)
        ```
        These functions each return lists of dictionaries. Each of these dictionaries represents a "row" of data (e.g. one country or product). The fields of these dictionaries represent "columns" of data. This is easier to visualize if you output your data to a CSV file.
        
        **Export to CSV**
        ```
        oec.data_to_csv(list_of_dictionaries, 'results.csv')
        ```
        These CSV files can then be opened up in the spreadsheet editor of your choice for further analysis.
        
        **Generate links to visualizations**
        ```
        >>> oec.url_visual(**params)
        'http://atlas.media.mit.edu/en/visualize/tree_map/hs92/export/egy/all/show/2015/'
        >>> oec.embed_visual(**params)
        '<iframe src="http://atlas.media.mit.edu/en/visualize/embed/tree_map/hs92/export/egy/all/show/2015/" width=930 height=400></iframe>'
        >>> oec.url_visual(**params, language='fr')
        'http://atlas.media.mit.edu/fr/visualize/tree_map/hs92/export/egy/all/show/2015/'
        ```
        
        ## Documentation
        **Function-level documentation and language list:** see [`help.txt`](https://github.com/yahiaali/oec/blob/master/help.txt) or run `python -m pydoc oec`   
        **OEC API documentation:** https://atlas.media.mit.edu/api/   
        **Data attributes and field names:** https://github.com/alexandersimoes/oec/wiki/Attributes   
        
        ## Acknowledgements
        Credits to [Alex Simoes](https://github.com/alexandersimoes) for the development of [The Observatory for Economic Complexity](https://atlas.media.mit.edu/en/). This module was developed by [Yahia Ali](https://github.com/yahiaali), who is not affiliated in any way with the OEC team.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3
Description-Content-Type: text/markdown
