Skip to main content

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

Project description

PyPI version Pytest passing

waste_flow version 1.3.2

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 python version 3.6 or above which is often installed by default. Simply choose one of the two following methods to install, depending on which package manager you prefer to use.

Installing via conda

$ conda install -c conda-forge -c xapple waste_flow

Installing via pip

$ python3 -m pip install --user waste_flow


  • If you do not have conda on your system you can refer to this section.
  • If you do not have pip3 on your system you can refer to this section.
  • If you do not have python3 on your system or have an outdated version, you can refer to this other section.
  • If none of the above has enabled you to install waste_flow, please open an issue on the bug tracker and we will get back to you shortly.


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 your python interpreter:

>>> from waste_flow.analysis import waste_ana
>>> print(waste_ana.dry_mass)

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)
>>> print(result)

To create the waste generation plots do the following:

>>> from waste_flow.viz.gen_by_country import legend
>>> print(legend.plot(rerun=True))
>>> from waste_flow.viz.gen_by_country import countries
>>> for gen_viz in countries.values():
>>>     print(gen_viz.plot(rerun=True))


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

Distributing the package

  • Instructions for distributing and uploading waste_flow on PyPI so that it can be installed by pip can be found here. The current uploaded version is listed here.

  • Instructions for distributing and uploading waste_flow on anaconda so that it can be installed by conda can be found here. The current uploaded version is listed here.

Two scripts that automate these processes can be found in the following repository:

Developer documentation

The internal documentation of the waste_flow python package is available at:

This documentation is simply generated from the source code with this command:

$ pdoc3 --html --output-dir docs --force waste_flow

Project details

Download files

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

Source Distribution

waste_flow-1.3.2.tar.gz (47.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page