Skip to main content

A package for retrieving data concerning waste management on the European continent.

Project description

waste_flow version 1.1.9

waste_flow is a python package for retrieving and analyzing data concerning the waste management of European countries.


Since waste_flow is written in python it is compatible with all operating systems: Linux, macOS and Windows. The only prerequisite is python3 which is often installed by default. Simply type the following commands on your terminal:

$ pip3 install --user waste_flow

Alternatively if you want to install it for all users of the system:

$ sudo pip3 install waste_flow

If you do not have pip on your system you can usually get it with these commands (fresh Ubuntu 18-LTS):

$ sudo apt-get update
$ sudo apt-get install python3-distutils
$ curl -O
$ python3 --user


Bellow are some examples to illustrate the various ways there are to use this package.

To retrieve the large dataframe with dry mass for all years and all countries you can do the following:

from waste_flow.analysis import waste_ana

If you just want to see how much rubber waste did the UK generate in 2008, you can do the following:

from waste_flow.generation import waste_gen
params = ("waste   == 'W073' & "
          "country == 'UK' & "
          "year    == '2008'")
result = waste_gen.long_format.query(params)

To create the waste generation plots do the following:

from waste_flow.viz.gen_by_country import legend
from waste_flow.viz.gen_by_country import countries
for gen_viz in countries.values():


When you import waste_flow, we will check the $WASTE_FLOW_CACHE environment variable to see where to download and store the cached data. If this variable is not set, we will default to the platform's temporary directory and clone a repository there. This could result in re-downloading the cache after every reboot.


The first time you run waste_flow, it will automatically download the raw CSVs from the EUROSTAT website to disk and parse the resulting data. On later runs, waste_flow will simply retrieve this information directly from the disk. This means that the first time you execute the pipeline things will be noticeably slower: this is normal.


The two datasets used in this pipeline are available at the following addresses:

These are obtained by starting at and following "Database by themes -> Environment -> Waste -> Waste treatment"

The full name of the datasets are:

  • Generation of waste by waste category, hazardousness and NACE Rev. 2 activity (env_wasgen)
  • Treatment of waste by waste category, hazardousness and waste management operations (env_wastrt)


The pipeline is flexible as the user can specify what coefficients they desire or even what custom waste categories they want to create. These input parameters are in the files under the waste_flow/extra_data_xls directory.


The waste_flow package can also generate several types of plots that enable the user to compare and visualize the data.

For instance here is a series of graphs comparing the total reported waste generated in wet tonnes between european countries for the nace category C20-C22.

"Manufacture of chemical, pharmaceutical, rubber and plastic products"

Waste generated graph part 1 Waste generated graph part 2 Waste generated graph part 3 Waste generated graph part 4 Waste generated graph part 5 Waste generated graph part 6 Waste generated graph part 7 Waste generated graph part 8 Waste generated graph part 9

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for waste-flow, version 1.1.9
Filename, size File type Python version Upload date Hashes
Filename, size waste_flow-1.1.9.tar.gz (29.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page