{
    "info": {
        "author": "Joris Van den Bossche",
        "author_email": "jorisvandenbossche@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "ircelsos\r\n========\r\n\r\nDownloading air quality data from the SOS of IRCEL - CELINE, the Belgian\r\nInterregional Environment Agency (http://www.irceline.be).\r\n\r\nThis packages provides both a command line interface, as a python module\r\nthat downloads the data as pandas DataFrames.\r\n\r\nInstallation\r\n------------\r\n\r\n*ircelsos* is a Python package. If you have Python installed, *ircelsos* can\r\neasily be installed with pip::\r\n\r\n    pip install ircelsos\r\n\r\nThis will automatically install the dependency `OWSlib <https://github.com/geopython/OWSLib>`_.\r\nircelsos supports python 2.7 and 3.3+. For python 3, OWSlib 9.0 or higher is needed.\r\n\r\nCommand line usage\r\n------------------\r\n\r\nInstalling ircelsos will register a ``ircelsos`` command. This can be used from\r\nthe command line to download data and to retrieve info about the stations and\r\npollutants available in the SOS, using the two subcommands ``query`` and\r\n``info``.\r\n\r\nDownloading data\r\n^^^^^^^^^^^^^^^^\r\n\r\nTo download data, you can use the ``ircelsos query`` command. Eg::\r\n\r\n    ircelsos query o3 -s BETN060 -p 2015-03-27T00:00:00 2015-03-27T10:00:00\r\n\r\nThis will save a csv file in the current directory.\r\n\r\nSpecifying no stations or no period, will download the data for that pollutant\r\nfor all stations for the full available period.\r\n\r\nFor more details on the arguments, call ``ircelsos query -h``.\r\n\r\nRetrieving info\r\n^^^^^^^^^^^^^^^\r\n\r\nThe ``ircelsos info`` command can be used to inspect available stations and\r\npollutants. The following will give a list of all pollutants::\r\n\r\n    $ ircelsos info --pollutant\r\n    SOS of IRCEL - CELINE\r\n\r\n    id                     | short | name                         | stations\r\n    -----------------------+-------+------------------------------+---------\r\n    16111 - Black Carbon   | bc    | Black Carbon                 | 25\r\n    42101 - CO             | co    | Carbon Monoxide              | 24\r\n    ...\r\n\r\nTo get the detailed information about one pollutant, you can specify this after\r\n``--pollutant``. Eg::\r\n\r\n    $ ircelsos info --pollutant bc\r\n    SOS of IRCEL - CELINE\r\n\r\n          id = 16111 - Black Carbon\r\n       short = bc\r\n        name = Black Carbon\r\n    stations = 25\r\n\r\n    This pollutant is measured at the following stations:\r\n\r\n    name   | EU_code | location             | region   | type\r\n    -------+---------+----------------------+----------+-----------\r\n    40AB01 | BELAB01 | ANTWERPEN            | suburban | Background\r\n    40AL01 | BELAL01 | LINKEROEVER          | suburban | Background\r\n    ...\r\n\r\nThe same can be done to get information about the stations:\r\n``ircelsos info --station`` for a list of all stations and\r\n``ircelsos info --station STATION_CODE`` for the detailed information of one\r\nstation.\r\n\r\nAlternatively to the command line, you can also run the same script from\r\nthe ``ircelsos`` directory::\r\n\r\n    python -m ircelsos query ...\r\n\r\n\r\nInteractive usage (pandas)\r\n--------------------------\r\n\r\nTo use the packages in an interactive python session, you need an extra\r\ndependency: `pandas <http://pandas.pydata.org/>`_ (to install pandas,\r\nit is recommended to use a scientific python distribution like\r\n`Anaconda <https://www.continuum.io/downloads>`_ or\r\n`Canopy <https://store.enthought.com/downloads/#default>`_\r\nthat includes pandas).\r\n\r\nTo download data as a pandas DataFrame, you can use the ``query`` function:\r\n\r\n.. code-block:: python\r\n\r\n    >>> import ircelsos\r\n    >>> df = ircelsos.query('no2', station=['42R801', '42R802'], utc_start='2015-11-15')\r\n    >>> df.head()\r\n                                   42R801  42R802\r\n    time\r\n    2015-11-24T01:00:00.000+01:00    27.0    28.5\r\n    2015-11-24T02:00:00.000+01:00    17.5    19.5\r\n    2015-11-24T03:00:00.000+01:00    16.0    16.5\r\n    2015-11-24T04:00:00.000+01:00    17.0    17.5\r\n    2015-11-24T05:00:00.000+01:00    24.0    24.5\r\n\r\n\r\n----\r\n\r\n* Author: Joris Van den Bossche\r\n* License: BSD 2-clause",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/jorisvandenbossche/ircelsos",
        "keywords": "",
        "license": "BSD",
        "maintainer": "",
        "maintainer_email": "",
        "name": "ircelsos",
        "package_url": "https://pypi.org/project/ircelsos/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/ircelsos/",
        "project_urls": {
            "Homepage": "https://github.com/jorisvandenbossche/ircelsos"
        },
        "release_url": "https://pypi.org/project/ircelsos/0.2.2/",
        "requires_dist": [
            "owslib (==0.9.0)",
            "six"
        ],
        "requires_python": "",
        "summary": "Downloading air quality data from the SOS of IRCEL - CELINE",
        "version": "0.2.2"
    },
    "last_serial": 2205183,
    "releases": {
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "da6200bf42d2a67d895bc95011bb5070",
                    "sha256": "24f04592838eea6d4c0babf33ec84f1a6fe7d793be499268b60b5c27c8ee07cf"
                },
                "downloads": -1,
                "filename": "ircelsos-0.1.0-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "da6200bf42d2a67d895bc95011bb5070",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 16763,
                "upload_time": "2015-11-02T23:31:08",
                "url": "https://files.pythonhosted.org/packages/4b/f8/7adfe36da752d38fdc578998ae29b65452333c61914d5a97d0397587024d/ircelsos-0.1.0-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "a304791585ab127eade7cc08706905e8",
                    "sha256": "33d745cc4a121af315dcd88145327ecc17a44e20e36ac121c357da3076e0a3e9"
                },
                "downloads": -1,
                "filename": "ircelsos-0.1.0.zip",
                "has_sig": false,
                "md5_digest": "a304791585ab127eade7cc08706905e8",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 18196,
                "upload_time": "2015-11-02T23:31:12",
                "url": "https://files.pythonhosted.org/packages/42/d3/b81dbe1b86e1a64b52fae428fc990bdc6e43cabba563825dd532f219fc7e/ircelsos-0.1.0.zip"
            }
        ],
        "0.2.1": [],
        "0.2.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ff164aefc6f0b4739549dbc6045eaa6a",
                    "sha256": "fef906e0f3028e55dc3f588eae093e549da0e24d828d6938d13c2445345733cd"
                },
                "downloads": -1,
                "filename": "ircelsos-0.2.2-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ff164aefc6f0b4739549dbc6045eaa6a",
                "packagetype": "bdist_wheel",
                "python_version": "any",
                "requires_python": null,
                "size": 18873,
                "upload_time": "2016-07-06T09:15:18",
                "url": "https://files.pythonhosted.org/packages/42/d6/185acd801bd7b0a51919c55bdbb24e3c2e8e16ffee2b841c8122dec359aa/ircelsos-0.2.2-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "1d9bc5463671bfd03b8acece1f7e589d",
                    "sha256": "7d46428d179db0cfb95bbc94332d3ee73d3adbbb70339b1418ae410aaacaa264"
                },
                "downloads": -1,
                "filename": "ircelsos-0.2.2.zip",
                "has_sig": false,
                "md5_digest": "1d9bc5463671bfd03b8acece1f7e589d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 20802,
                "upload_time": "2016-07-06T09:14:57",
                "url": "https://files.pythonhosted.org/packages/92/dc/067de0edecbb927e23f7dc706bde8620ebf3a00aecdc5a8cef85270241a0/ircelsos-0.2.2.zip"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "ff164aefc6f0b4739549dbc6045eaa6a",
                "sha256": "fef906e0f3028e55dc3f588eae093e549da0e24d828d6938d13c2445345733cd"
            },
            "downloads": -1,
            "filename": "ircelsos-0.2.2-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ff164aefc6f0b4739549dbc6045eaa6a",
            "packagetype": "bdist_wheel",
            "python_version": "any",
            "requires_python": null,
            "size": 18873,
            "upload_time": "2016-07-06T09:15:18",
            "url": "https://files.pythonhosted.org/packages/42/d6/185acd801bd7b0a51919c55bdbb24e3c2e8e16ffee2b841c8122dec359aa/ircelsos-0.2.2-py2.py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "1d9bc5463671bfd03b8acece1f7e589d",
                "sha256": "7d46428d179db0cfb95bbc94332d3ee73d3adbbb70339b1418ae410aaacaa264"
            },
            "downloads": -1,
            "filename": "ircelsos-0.2.2.zip",
            "has_sig": false,
            "md5_digest": "1d9bc5463671bfd03b8acece1f7e589d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 20802,
            "upload_time": "2016-07-06T09:14:57",
            "url": "https://files.pythonhosted.org/packages/92/dc/067de0edecbb927e23f7dc706bde8620ebf3a00aecdc5a8cef85270241a0/ircelsos-0.2.2.zip"
        }
    ]
}