hoopoe 0.0.11

Hoopoe is a data enrichment service that makes it easy to improve your data-centric services and increase the accuracy of your ML models.

Hoopoe

A fast and easy way to enrich your data

Hoopoe is a data enrichment service that makes it easy to improve your data-centric services and increase the accuracy of your ML models.

Hoopoe saves you time in scraping data and loading it to Pandas Dataframes. Instead, just specify the data you already have in your dataframe and its type, and specify the desired data you would like to add.

Current development status

Hoopoe is in its early days, and offered as a pre-alpha version, therefore, bugs are expected. In addition, the current dataset avialability is low. You can check the list below to find out which datasets and translations are already available. This list will be updated from time to time.

Available datasets, enrichment options and translations

• US states
• State name abbriviation (USPS abbreviation)
• Full state name
• State population
• State capital city:
• State capital city name
• State capital city population:
• Population
• MSA/µSA population (Metropolitan Statistical Area / Micropolitan Statistical Area)
• CSA population (Combined Statistical Area)
• State area:
• State total area rank
• State total area (KM)
• State land area rank
• State land area (KM)
• State water area rank
• State water area (KM)
• Country calling codes (international call prefixes)
• Country name
• International calling code
• Units of measure
• Celsius
• Farenheit
• Kelvin

* If you would like to see here another dataset, please contact me and let me know.

Work in progress datasets

• US states ISO 3166 code
• US states time zone
• US states density
• US population rank
• US states income rank
• US states density rank
• US city population
• Population by country
• Capital City by country
• Countries time zone
• Countries official language
• Countries area
• Countries capital city
• Unit of measure
• Distance
• Area
• Speed
• Energy

How to use

Currently Hoopoe supports enrichments of Pandas Dataframes and single strings. For basic usage, after installation, import hoopoe and use the hoopoe enrich function as follows:
hoopoe.enrich(data, source_data_name, source_data_type, target_data_type)

data - Either a string or a Pandas dataframe.
source_data_name - the dataframe column name of the column you want to enrich.
source_data_type - the Hoopoe source data type. For example us_state_name_abbr for a column holding abbriviations of us state.
target_data_type - the target Hoopoe data type you would like Hoopoe to return. For example, for country name, return the target date type phone_prefix for country calling code.

Enrichment options

Category	Source data type desc.	Hoopoe source_data_type	Target data type desc.	Hoopoe target_data_type
Places	Two letter abbriviations of USA states name (USPS abbreviation)	us_state_name_abbr	Full USA states name	us_state_name_full
Places	Full USA states name	us_state_name_full	Two letter abbriviations of USA states name (USPS abbreviation)	us_state_name_abbr
Places	Full USA states name	us_state_name_full	State population 2019 est.	us_state_population
Places	Full USA state name	us_state_name_full	State capital city name	us_state_capital_city
Places	Capital city name	us_capital_city_name	City population 2019 est.	us_capital_city_population
Places	Capital city name	us_capital_city_name	City population (Metropolitan/Micropolitan Statistical Area - MSA) 2019 est.	us_capital_city_population_msa
Places	Capital city name	us_capital_city_name	City population (Combined Statistical Area - CSA) 2019 est.	us_capital_city_population_csa
Places	Full USA state name	us_state_name_full	State total area rank	us_state_total_area_rank
Places	Full USA state name	us_state_name_full	State total area rank	us_state_total_area (KM)
Places	Full USA state name	us_state_name_full	State land area rank	us_state_land_area_rank
Places	Full USA state name	us_state_name_full	State land area rank	us_state_land_area (KM)
Places	Full USA state name	us_state_name_full	State water area rank	us_state_water_area_rank
Places	Full USA state name	us_state_name_full	State water area rank	us_state_water_area (KM)
Phone numbers	Country name	country_name	Intenational phone prefix	phone_prefix
Phone numbers	Intenational phone prefix	phone_prefix	Country name	country_name
Units - Tempreture	Celsius	celsius	Farenheit	farenheit
Units - Tempreture	Celsius	celsius	Kelvin	kelvin
Units - Tempreture	Farenheit	farenheit	Celsius	celsius
Units - Tempreture	Farenheit	farenheit	Kelvin	kelvin
Units - Tempreture	Kelvin	kelvin	Celsius	celsius
Units - Tempreture	Kelvin	kelvin	Farenheit	farenheit

Installing

To install Hoopoe, run the following in your virtualenv:

$ pip install hoopoe

Developing Hoopoe

To install Hoopoe, along with the tools you need to develop and run tests, run the following in your virtualenv:

$ pip install -e .[dev]

Dependencies

• Pandas
  
  

Dev dependencies (only for contributers)

• pytest
• check-manifest

Licence

MIT License