meteoserver


Namemeteoserver JSON
Version 0.0.18 PyPI version JSON
download
home_page
SummaryA Python module to obtain and read Dutch weather data from Meteoserver.nl
upload_time2023-11-05 15:12:06
maintainer
docs_urlNone
author
requires_python
licenseGPLv3+
keywords weather sun data forecast api
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Meteoserver #

![PyPI](https://img.shields.io/pypi/v/meteoserver?color=%230A0)
![PyPI - Downloads](https://img.shields.io/pypi/dm/meteoserver)
[![Documentation
Status](https://readthedocs.org/projects/meteoserver/badge/?version=latest)](https://meteoserver.readthedocs.io/en/latest/?badge=latest)
![PyPI - License](https://img.shields.io/pypi/l/meteoserver?color=%230A0)

A Python module to obtain and read Dutch weather data from Meteoserver.nl.  The code is being developed by
[Marc van der Sluys](http://han.vandersluys.nl/en/) of the department of Astrophysics at the Radboud
University Nijmegen, the Netherlands and the department of Sustainable energy of the HAN University of Applied
Sciences in Arnhem, the Netherlands.  The Meteoserver package can be used under the conditions of the GPLv3
licence.


## Installation ##

This package can be installed using `pip install meteoserver`.  This should automatically install the
dependency packages `pandas` and `requests`, if they haven't been installed already.  If you are installing by
hand, ensure that these packages are installed as well.

You will need to obtain a (free) account and API key at [Meteoserver.nl](https://meteoserver.nl/) to download
data from the Meteoserver API.


## Example use ##

```python
"""Example Python script using the Meteoserver module."""

import meteoserver as meteo

myKey = 'a123456789'    # My Meteoserver API key - put your OWN key here!
myLocation = 'De Bilt'  # My location

# Weather forecast #################################################################################

# Print some help:
meteo.print_help_weatherforecast()

location = 'Unknown'  # Ensure we always have a location 'name' to write to file.

# Read weather-forecast data from file:
# data = meteo.read_json_file_weatherforecast('WeatherForecast1.json', full=True)  # Option 1: HARMONIE/HiRLAM (48 (42?) hours)
# data = meteo.read_json_file_weatherforecast('WeatherForecast2.json')  # Option 2: GFS (4/10 days), useful columns only, no location
# Option 2, with ALL columns and location; don't convert to numerical format, to allow writing to file later:
# data, location = meteo.read_json_file_weatherforecast('WeatherForecast2.json', full=True, loc=True, numeric=False)

# Get weather-forecast data from server:
# data = meteo.read_json_url_weatherforecast(myKey, myLocation, model='HARMONIE')  # Option 1: HARMONIE/HiRLAM
# data = meteo.read_json_url_weatherforecast(myKey, myLocation)  # Option 2 (default): GFS, useful columns only, no location
# Option 2, with ALL columns and location; don't convert to numerical format, to allow writing to file later:
data, location = meteo.read_json_url_weatherforecast(myKey, myLocation, full=True, loc=True, numeric=False)

# Print the data:
print(data)

# Write the downloaded data to a json file:
meteo.write_json_file_weatherforecast('WeatherForecast3.json', location, data)



# Sun forecast #####################################################################################

# Print some help:
meteo.print_help_sunData()

# Read a Meteoserver Sun-data JSON file from disc:
# current, forecast = meteo.read_json_file_sunData('SunData.json')
# Return the location; don't convert to numerical format, to allow writing to file later:
# current, forecast, location = meteo.read_json_file_sunData('SunData.json', loc=True, numeric=False)

# Get Meteoserver Sun data from the server for the given location (and key):
# current, forecast = meteo.read_json_url_sunData(myKey, myLocation)
# Return the location; don't convert to numerical format, to allow writing to file later:
current, forecast, location = meteo.read_json_url_sunData(myKey, myLocation, loc=True, numeric=False)

# Print the current-weather and forecast dataframes:
print("\nCurrent Sun/weather observation from a nearby station:")
print(current)

print("\nSun/weather forecast for the selected location/region:")
print(forecast)

# Write the downloaded data to a json file:
meteo.write_json_file_sunData('SunData1.json', location, current, forecast)
```

## Meteoserver pages ##

* [Pypi](https://pypi.org/project/meteoserver/): Meteoserver Python package
* [GitHub](https://github.com/MarcvdSluys/Meteoserver/): Meteoserver source code
* [ReadTheDocs](https://meteoserver.readthedocs.io/): Meteoserver documentation


## Author and licence ##

* Author: Marc van der Sluys
* Contact: http://han.vandersluys.nl/en/
* Licence: [GPLv3+](https://www.gnu.org/licenses/gpl.html)


## References ##

* Data, API key and API documentation can be obtained from [Meteoserver.nl](https://meteoserver.nl/)

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "meteoserver",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "weather,sun,data,forecast,api",
    "author": "",
    "author_email": "Marc van der Sluys <git@vandersluys.nl>",
    "download_url": "https://files.pythonhosted.org/packages/77/54/7264624218f75e8254896752abe05e501f068cd8fea3a50dc84c4508fa16/meteoserver-0.0.18.tar.gz",
    "platform": null,
    "description": "# Meteoserver #\n\n![PyPI](https://img.shields.io/pypi/v/meteoserver?color=%230A0)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/meteoserver)\n[![Documentation\nStatus](https://readthedocs.org/projects/meteoserver/badge/?version=latest)](https://meteoserver.readthedocs.io/en/latest/?badge=latest)\n![PyPI - License](https://img.shields.io/pypi/l/meteoserver?color=%230A0)\n\nA Python module to obtain and read Dutch weather data from Meteoserver.nl.  The code is being developed by\n[Marc van der Sluys](http://han.vandersluys.nl/en/) of the department of Astrophysics at the Radboud\nUniversity Nijmegen, the Netherlands and the department of Sustainable energy of the HAN University of Applied\nSciences in Arnhem, the Netherlands.  The Meteoserver package can be used under the conditions of the GPLv3\nlicence.\n\n\n## Installation ##\n\nThis package can be installed using `pip install meteoserver`.  This should automatically install the\ndependency packages `pandas` and `requests`, if they haven't been installed already.  If you are installing by\nhand, ensure that these packages are installed as well.\n\nYou will need to obtain a (free) account and API key at [Meteoserver.nl](https://meteoserver.nl/) to download\ndata from the Meteoserver API.\n\n\n## Example use ##\n\n```python\n\"\"\"Example Python script using the Meteoserver module.\"\"\"\n\nimport meteoserver as meteo\n\nmyKey = 'a123456789'    # My Meteoserver API key - put your OWN key here!\nmyLocation = 'De Bilt'  # My location\n\n# Weather forecast #################################################################################\n\n# Print some help:\nmeteo.print_help_weatherforecast()\n\nlocation = 'Unknown'  # Ensure we always have a location 'name' to write to file.\n\n# Read weather-forecast data from file:\n# data = meteo.read_json_file_weatherforecast('WeatherForecast1.json', full=True)  # Option 1: HARMONIE/HiRLAM (48 (42?) hours)\n# data = meteo.read_json_file_weatherforecast('WeatherForecast2.json')  # Option 2: GFS (4/10 days), useful columns only, no location\n# Option 2, with ALL columns and location; don't convert to numerical format, to allow writing to file later:\n# data, location = meteo.read_json_file_weatherforecast('WeatherForecast2.json', full=True, loc=True, numeric=False)\n\n# Get weather-forecast data from server:\n# data = meteo.read_json_url_weatherforecast(myKey, myLocation, model='HARMONIE')  # Option 1: HARMONIE/HiRLAM\n# data = meteo.read_json_url_weatherforecast(myKey, myLocation)  # Option 2 (default): GFS, useful columns only, no location\n# Option 2, with ALL columns and location; don't convert to numerical format, to allow writing to file later:\ndata, location = meteo.read_json_url_weatherforecast(myKey, myLocation, full=True, loc=True, numeric=False)\n\n# Print the data:\nprint(data)\n\n# Write the downloaded data to a json file:\nmeteo.write_json_file_weatherforecast('WeatherForecast3.json', location, data)\n\n\n\n# Sun forecast #####################################################################################\n\n# Print some help:\nmeteo.print_help_sunData()\n\n# Read a Meteoserver Sun-data JSON file from disc:\n# current, forecast = meteo.read_json_file_sunData('SunData.json')\n# Return the location; don't convert to numerical format, to allow writing to file later:\n# current, forecast, location = meteo.read_json_file_sunData('SunData.json', loc=True, numeric=False)\n\n# Get Meteoserver Sun data from the server for the given location (and key):\n# current, forecast = meteo.read_json_url_sunData(myKey, myLocation)\n# Return the location; don't convert to numerical format, to allow writing to file later:\ncurrent, forecast, location = meteo.read_json_url_sunData(myKey, myLocation, loc=True, numeric=False)\n\n# Print the current-weather and forecast dataframes:\nprint(\"\\nCurrent Sun/weather observation from a nearby station:\")\nprint(current)\n\nprint(\"\\nSun/weather forecast for the selected location/region:\")\nprint(forecast)\n\n# Write the downloaded data to a json file:\nmeteo.write_json_file_sunData('SunData1.json', location, current, forecast)\n```\n\n## Meteoserver pages ##\n\n* [Pypi](https://pypi.org/project/meteoserver/): Meteoserver Python package\n* [GitHub](https://github.com/MarcvdSluys/Meteoserver/): Meteoserver source code\n* [ReadTheDocs](https://meteoserver.readthedocs.io/): Meteoserver documentation\n\n\n## Author and licence ##\n\n* Author: Marc van der Sluys\n* Contact: http://han.vandersluys.nl/en/\n* Licence: [GPLv3+](https://www.gnu.org/licenses/gpl.html)\n\n\n## References ##\n\n* Data, API key and API documentation can be obtained from [Meteoserver.nl](https://meteoserver.nl/)\n",
    "bugtrack_url": null,
    "license": "GPLv3+",
    "summary": "A Python module to obtain and read Dutch weather data from Meteoserver.nl",
    "version": "0.0.18",
    "project_urls": {
        "GitHub": "https://github.com/MarcvdSluys/Meteoserver",
        "ReadTheDocs": "https://meteoserver.readthedocs.io"
    },
    "split_keywords": [
        "weather",
        "sun",
        "data",
        "forecast",
        "api"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "692b65a6b86af898290b7a5235de171315cbe13904619d161316eeba4a41269d",
                "md5": "504717ea1cccb65b546df802090f0360",
                "sha256": "a7d483a7a56ae89236d2726aa946d5157930c891a7fe5e7704c06166f9a83307"
            },
            "downloads": -1,
            "filename": "meteoserver-0.0.18-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "504717ea1cccb65b546df802090f0360",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 25286,
            "upload_time": "2023-11-05T15:12:05",
            "upload_time_iso_8601": "2023-11-05T15:12:05.043037Z",
            "url": "https://files.pythonhosted.org/packages/69/2b/65a6b86af898290b7a5235de171315cbe13904619d161316eeba4a41269d/meteoserver-0.0.18-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "77547264624218f75e8254896752abe05e501f068cd8fea3a50dc84c4508fa16",
                "md5": "4df306e484ee4eaa8e550562faedf7bd",
                "sha256": "3efc4b3b1eb5aa673a0c1464cb803e46e56b9b43d16c62720c0d17c44f194682"
            },
            "downloads": -1,
            "filename": "meteoserver-0.0.18.tar.gz",
            "has_sig": false,
            "md5_digest": "4df306e484ee4eaa8e550562faedf7bd",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 23007,
            "upload_time": "2023-11-05T15:12:06",
            "upload_time_iso_8601": "2023-11-05T15:12:06.675468Z",
            "url": "https://files.pythonhosted.org/packages/77/54/7264624218f75e8254896752abe05e501f068cd8fea3a50dc84c4508fa16/meteoserver-0.0.18.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-11-05 15:12:06",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "MarcvdSluys",
    "github_project": "Meteoserver",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "meteoserver"
}
        
Elapsed time: 0.12977s