Download Water Data
===================
Downloader for the `Global Surface Water`_ data of the Copernicus Programme.
It is based on the original downloadWaterData.py.
.. image:: https://img.shields.io/pypi/pyversions/download_water_data.svg
:target: https://pypi.python.org/pypi/download-water-data
.. image:: https://img.shields.io/pypi/v/download-water-data.svg
:target: https://pypi.python.org/pypi/download-water-data
.. image:: https://img.shields.io/github/issues/mentaljam/download_water_data.svg
:target: https://github.com/mentaljam/download_water_data/issues
Requirements
------------
This tool runs on Windows/Mac/Unix and requires `Python`_ version 2 or 3.
Usage
-----
**Install with** `pip`_
- Install the tool with ``python -m pip install download_water_data``
- Run the tool with ``python -m download_water_data <arguments>`` or just
``download_water_data <arguments>`` if the Python Scripts directory is in your system ``PATH``
**Download without installing**
- Download the `latest`_ ``download_water_data.pyz`` file
- Open a terminal or console
- Run the tool with ``python download_water_data.pyz <arguments>``
To **interrupt** tool execution press ``Ctrl+C``.
Arguments
---------
Possible tool arguments and options can be listed with the ``-h`` option:
::
$ download_water_data -h
usage: download_water_data [-h] [-v] [-d PATH] [-r {1_0,1_1,1_1_2019,1_3_2020,1_4_2021}] [-a] [-f] [DS ...]
Full Download Script for Global Surface Water Data.
positional arguments:
DS one or more datasets names to download (occurrence,
change, seasonality, recurrence, transitions, extent),
use the "-a" option to download all the datasets
options:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-d PATH, --directory PATH
destination directory where to download the data (by
default the current working directory is used)
-r {1_0,1_1,1_1_2019,1_3_2020,1_4_2021}, --revision {1_0,1_1,1_1_2019,1_3_2020,1_4_2021}
data revision (default is 1_4_2021)
-a, --all download all datasets (default is false)
-f, --force rewrite existing files (default is false)
Examples
--------
To download the **occurrence** and **change** datasets run
``download_water_data occurrence change``
To download all the datasets run
``download_water_data -a``
To change the destination directory add the ``-d`` option
``download_water_data -a -d 'download/path'``
.. _Global Surface Water: https://global-surface-water.appspot.com
.. _Python: https://www.python.org
.. _pip: https://pip.pypa.io/en/stable
.. _latest: https://github.com/mentaljam/download_water_data/releases/latest
Raw data
{
"_id": null,
"home_page": "https://github.com/mentaljam/download_water_data",
"name": "download-water-data",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Copernicus global surface water download",
"author": "Petr Tsymbarovich",
"author_email": "petr@tsymbarovich.ru",
"download_url": "https://files.pythonhosted.org/packages/73/39/e4ca9e4dce3dbeb08bbe9dc1b3915877d1a2f6f1a3338ffcf6c234e08297/download_water_data-0.5.0.tar.gz",
"platform": null,
"description": "Download Water Data\r\n===================\r\n\r\nDownloader for the `Global Surface Water`_ data of the Copernicus Programme.\r\n\r\nIt is based on the original downloadWaterData.py.\r\n\r\n.. image:: https://img.shields.io/pypi/pyversions/download_water_data.svg\r\n :target: https://pypi.python.org/pypi/download-water-data\r\n\r\n.. image:: https://img.shields.io/pypi/v/download-water-data.svg\r\n :target: https://pypi.python.org/pypi/download-water-data\r\n\r\n.. image:: https://img.shields.io/github/issues/mentaljam/download_water_data.svg\r\n :target: https://github.com/mentaljam/download_water_data/issues\r\n\r\nRequirements\r\n------------\r\n\r\nThis tool runs on Windows/Mac/Unix and requires `Python`_ version 2 or 3.\r\n\r\nUsage\r\n-----\r\n\r\n**Install with** `pip`_\r\n\r\n- Install the tool with ``python -m pip install download_water_data``\r\n- Run the tool with ``python -m download_water_data <arguments>`` or just\r\n ``download_water_data <arguments>`` if the Python Scripts directory is in your system ``PATH``\r\n\r\n**Download without installing**\r\n\r\n- Download the `latest`_ ``download_water_data.pyz`` file\r\n- Open a terminal or console\r\n- Run the tool with ``python download_water_data.pyz <arguments>``\r\n\r\nTo **interrupt** tool execution press ``Ctrl+C``.\r\n\r\nArguments\r\n---------\r\n\r\nPossible tool arguments and options can be listed with the ``-h`` option:\r\n\r\n::\r\n\r\n $ download_water_data -h\r\n\r\n usage: download_water_data [-h] [-v] [-d PATH] [-r {1_0,1_1,1_1_2019,1_3_2020,1_4_2021}] [-a] [-f] [DS ...]\r\n\r\n Full Download Script for Global Surface Water Data.\r\n\r\n positional arguments:\r\n DS one or more datasets names to download (occurrence,\r\n change, seasonality, recurrence, transitions, extent),\r\n use the \"-a\" option to download all the datasets\r\n\r\n options:\r\n -h, --help show this help message and exit\r\n -v, --version show program's version number and exit\r\n -d PATH, --directory PATH\r\n destination directory where to download the data (by\r\n default the current working directory is used)\r\n -r {1_0,1_1,1_1_2019,1_3_2020,1_4_2021}, --revision {1_0,1_1,1_1_2019,1_3_2020,1_4_2021}\r\n data revision (default is 1_4_2021)\r\n -a, --all download all datasets (default is false)\r\n -f, --force rewrite existing files (default is false)\r\n\r\nExamples\r\n--------\r\n\r\nTo download the **occurrence** and **change** datasets run\r\n\r\n``download_water_data occurrence change``\r\n\r\nTo download all the datasets run\r\n\r\n``download_water_data -a``\r\n\r\nTo change the destination directory add the ``-d`` option\r\n\r\n``download_water_data -a -d 'download/path'``\r\n\r\n.. _Global Surface Water: https://global-surface-water.appspot.com\r\n.. _Python: https://www.python.org\r\n.. _pip: https://pip.pypa.io/en/stable\r\n.. _latest: https://github.com/mentaljam/download_water_data/releases/latest\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Downloader for the Global Surface Water Data of the Copernicus Programme",
"version": "0.5.0",
"project_urls": {
"Homepage": "https://github.com/mentaljam/download_water_data"
},
"split_keywords": [
"copernicus",
"global",
"surface",
"water",
"download"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "27a8d8943bc8b4cb6df8ce55854020b5ce12b50e0a6436ccee7631ea600e042a",
"md5": "b7fa990ef345f2139b986307cdcb95f7",
"sha256": "c167fd29cc37af1b68c9b753d0cd5b90d4a09b30bef2f6e94ea189d32c4a1663"
},
"downloads": -1,
"filename": "download_water_data-0.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b7fa990ef345f2139b986307cdcb95f7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6025,
"upload_time": "2023-07-12T06:51:53",
"upload_time_iso_8601": "2023-07-12T06:51:53.279093Z",
"url": "https://files.pythonhosted.org/packages/27/a8/d8943bc8b4cb6df8ce55854020b5ce12b50e0a6436ccee7631ea600e042a/download_water_data-0.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7339e4ca9e4dce3dbeb08bbe9dc1b3915877d1a2f6f1a3338ffcf6c234e08297",
"md5": "8616e85f17349c1136081fbb0fd0a1ac",
"sha256": "070cab7d0c295ee28d3e5726cb7dcd7ebaf07214cb7b8159d5f6faf179b8b3bc"
},
"downloads": -1,
"filename": "download_water_data-0.5.0.tar.gz",
"has_sig": false,
"md5_digest": "8616e85f17349c1136081fbb0fd0a1ac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5472,
"upload_time": "2023-07-12T06:51:55",
"upload_time_iso_8601": "2023-07-12T06:51:55.073168Z",
"url": "https://files.pythonhosted.org/packages/73/39/e4ca9e4dce3dbeb08bbe9dc1b3915877d1a2f6f1a3338ffcf6c234e08297/download_water_data-0.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-12 06:51:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mentaljam",
"github_project": "download_water_data",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "download-water-data"
}