ircelsos
Downloading air quality data from the SOS of IRCEL - CELINE, the Belgian Interregional Environment Agency (http://www.irceline.be).
This packages provides both a command line interface, as a python module that downloads the data as pandas DataFrames.
Installation
ircelsos is a Python package. If you have Python installed, ircelsos can easily be installed with pip:
pip install ircelsos
This will automatically install the dependency OWSlib. ircelsos supports python 2.7 and 3.3+. For python 3, OWSlib 9.0 or higher is needed.
Command line usage
Installing ircelsos will register a ircelsos command. This can be used from the command line to download data and to retrieve info about the stations and pollutants available in the SOS, using the two subcommands query and info.
Downloading data
To download data, you can use the ircelsos query command. Eg:
ircelsos query o3 -s BETN060 -p 2015-03-27T00:00:00 2015-03-27T10:00:00
This will save a csv file in the current directory.
Specifying no stations or no period, will download the data for that pollutant for all stations for the full available period.
For more details on the arguments, call ircelsos query -h.
Retrieving info
The ircelsos info command can be used to inspect available stations and pollutants. The following will give a list of all pollutants:
$ ircelsos info --pollutant SOS of IRCEL - CELINE id | short | name | stations -----------------------+-------+------------------------------+--------- 16111 - Black Carbon | bc | Black Carbon | 25 42101 - CO | co | Carbon Monoxide | 24 ...
To get the detailed information about one pollutant, you can specify this after --pollutant. Eg:
$ ircelsos info --pollutant bc
SOS of IRCEL - CELINE
id = 16111 - Black Carbon
short = bc
name = Black Carbon
stations = 25
This pollutant is measured at the following stations:
name | EU_code | location | region | type
-------+---------+----------------------+----------+-----------
40AB01 | BELAB01 | ANTWERPEN | suburban | Background
40AL01 | BELAL01 | LINKEROEVER | suburban | Background
...
The same can be done to get information about the stations: ircelsos info --station for a list of all stations and ircelsos info --station STATION_CODE for the detailed information of one station.
Alternatively to the command line, you can also run the same script from the ircelsos directory:
python -m ircelsos query ...
Interactive usage (pandas)
To use the packages in an interactive python session, you need an extra dependency: pandas (to install pandas, it is recommended to use a scientific python distribution like Anaconda or Canopy that includes pandas).
To download data as a pandas DataFrame, you can use the query function:
>>> import ircelsos
>>> df = ircelsos.query('no2', station=['42R801', '42R802'], utc_start='2015-11-15')
>>> df.head()
42R801 42R802
time
2015-11-24T01:00:00.000+01:00 27.0 28.5
2015-11-24T02:00:00.000+01:00 17.5 19.5
2015-11-24T03:00:00.000+01:00 16.0 16.5
2015-11-24T04:00:00.000+01:00 17.0 17.5
2015-11-24T05:00:00.000+01:00 24.0 24.5
Author: Joris Van den Bossche
License: BSD 2-clause
Metadata
Release files for ircelsos 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ircelsos-0.2.2.zip | 20.8 kB | Without provenance | Details for ircelsos-0.2.2.zip |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ircelsos-0.2.2-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details for ircelsos-0.2.2-py2.py3-none-any.whl |
Total release size: 39.7 kB
Release files / ircelsos-0.2.2.zip
| Download URL | ircelsos-0.2.2.zip |
|---|---|
| Size | 20.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d46428d179db0cfb95bbc94332d3ee73d3adbbb70339b1418ae410aaacaa264
|
|
BLAKE2b-256 checksum How to use checksums |
92dc067de0edecbb927e23f7dc706bde8620ebf3a00aecdc5a8cef85270241a0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / ircelsos-0.2.2-py2.py3-none-any.whl
| Download URL | ircelsos-0.2.2-py2.py3-none-any.whl |
|---|---|
| Size | 18.9 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
fef906e0f3028e55dc3f588eae093e549da0e24d828d6938d13c2445345733cd
|
|
BLAKE2b-256 checksum How to use checksums |
42d6185acd801bd7b0a51919c55bdbb24e3c2e8e16ffee2b841c8122dec359aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for ircelsos 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.