Package: eurogastp
eurogastp - Python tools for analyzing the European gas systemDescription and featuresThis Python package facilitates downloading and processing data from the
following transparency platforms (TPs):ENTSOG     (https://transparency.entsog.eu/)GIE AGSI+  (https://agsi.gie.eu/)GIE ALSI   (https://alsi.gie.eu/)In the case of the ENTSOG TP, the package does not only help with merely
downloading the data, but also with further processing it. The different
functions allow forperiodizing and re-indexing (resampling the data with "gas days" as
fixed frequency),selecting and filtering (selecting the data of interest), andaggregating (computing the sum over several data of interest)
the data. Due to the nature of the data and the format it comes in
(what ENTSOG calls the "compact" format), these steps are often required
for making best use of the data. In the case of the two GIE TPs, the data is
far less complex and those extra steps are not required. It is easy enough to
combine data from the GIE TPs with the (periodized and reindexed) data from
the ENTSOG TP.The package makes use of the Pandas package, thus results of the function calls
are usually Pandas DataFrames.Quick startWe suggest to usepipto install eurogastp into your preferred Python
environment:pipinstalleurogastpIf you want to download the very latest version from GitLab for use or
development purposes, you can of course also clone the repository directly
using Git:gitclonehttps://code.europa.eu/jrc-energy-security/eurogastp.gitIn that case, you have to make sure that the newly created folder "eurogastp"
is added to your PYTHONPATH, so that you canimport eurogastpinside your
preferred Python environment.For development and application we have used theAnaconda Python Distributionand
Python 3.8 on Windows 10. However, it should also work within other Python
environments.To start off, there is a Jupyter notebook with a full example in the Examples
directory that you can follow along.Dependencieseurogastp depends on the following 3rd-party Python packages:pandas      ->      BSD-3-Clause Licencenumpy		->      BSD-3-Clause Licencerequests    ->      Apache 2.0 Licencetqdm	    ->      MIT LicensePython 		->      Python Software Foundation (PSF) License Agreementopenpyxl    ->      MIT Licensepytables    ->      BSD 3-Clause Licenseeurogastp does not contain any code from these packages, neither in original
nor in modified form. They are merely software dependencies for the user to
run eurogastp on her own machine.More details about the licenses of the 3rd-party software can be found in the
attachedNotice.txt.Copyright noticeCopyright (C) 2022 European UnionLicensed under the EUPL, Version 1.2 or – as soon they will be approved by
the European Commission – subsequent versions of the EUPL (the "Licence");
You may not use this work except in compliance with the Licence.
You may obtain a copy of the Licence at:https://joinup.ec.europa.eu/software/page/eupl5Unless required by applicable law or agreed to in writing, software
distributed under the Licence is distributed on an "AS IS" basis, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
Licence for the specific language governing permissions and limitations under
the Licence.Main developersThis software was initially developed by staff of the Joint Research Centre
(JRC) of the European Commission (EC), Petten, Netherlands.Initial contributors are:Daniel Jung (EC-JRC)daniel.jung@ec.europa.euJean-Francois Vuillaume (EC-JRC)Jean-Francois.VUILLAUME@ec.europa.euRicardo Fernandez-Blanco Carramolino (EC-JRC)Ricardo.CARRAMOLINO@ec.europa.euHow to contributeFor ways to contribute please refer to the separate documentcontributing.md.ReferencesJung, D., Vuillaume, J., Fernandez Blanco Carramolino, R., Filipe Calisto, H., Rodriguez Gomez, N. and Bolado Lavin, R., Tools for analysing the European natural gas system with public data – The Python package eurogastp, EUR 31281 EN, Publications Office of the European Union, Luxembourg, 2022, ISBN 978-92-76-58764-4, doi:10.2760/153669, JRC130771;https://publications.jrc.ec.europa.eu/repository/handle/JRC130771.