https://github.com/mentaljam/download_water_data

Downloader for the Global Surface Water Data of the Copernicus Programme
https://github.com/mentaljam/download_water_data

copernicus download global surface water

Last synced: 5 months ago
JSON representation

Downloader for the Global Surface Water Data of the Copernicus Programme

• Host: GitHub
• URL: https://github.com/mentaljam/download_water_data
• Owner: mentaljam
• License: mit
• Created: 2017-12-23T17:06:07.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-07-12T06:44:40.000Z (almost 2 years ago)
• Last Synced: 2024-11-27T11:02:16.041Z (5 months ago)
• Topics: copernicus, download, global, surface, water
• Language: Python
• Homepage: https://pypi.python.org/pypi/download-water-data
• Size: 18.6 KB
• Stars: 44
• Watchers: 2
• Forks: 16
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• open-sustainable-technology - Download Water Data - Downloader for the Global Surface Water Data of the Copernicus Programme. (Hydrosphere / Freshwater and Hydrology)

README

        
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 `` or just

  ``download_water_data `` 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 ``

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