automatic import of python-hydrafloods

3 files changed, 391 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..a867492 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/hydrafloods-2021.10.11.tar.gz
diff --git a/python-hydrafloods.spec b/python-hydrafloods.spec
new file mode 100644
index 0000000..bfd8223
--- /dev/null
+++ b/python-hydrafloods.spec
@@ -0,0 +1,389 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-hydrafloods
+Version:	2021.10.11
+Release:	1
+Summary:	HYDrologic Remote sensing Analysis for Floods
+License:	GNU GPL v3.0
+URL:		http://github.com/servir-mekong/hydra-floods
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/dc/80/219259992935a289e4785b0dfd9b0e5300e2158d3dbfbe972ee14a2a43cc/hydrafloods-2021.10.11.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-simplecmr
+Requires:	python3-earthengine-api
+Requires:	python3-gcsfs
+Requires:	python3-fire
+Requires:	python3-pipetools
+
+%description
+# hydra-floods
+
+[![docs](https://github.com/Servir-Mekong/hydra-floods/workflows/docs/badge.svg)](https://servir-mekong.github.io/hydra-floods)
+![unittests](https://github.com/Servir-Mekong/hydra-floods/workflows/unittests/badge.svg)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![PyPI version](https://badge.fury.io/py/hydrafloods.svg)](https://badge.fury.io/py/hydrafloods)
+
+
+## Introduction
+
+The Hydrologic Remote Sensing Analysis for Floods (or HYDRAFloods) is an open source Python application for downloading, processing, and delivering surface water maps derived from remote sensing data. The bases behind the tool is to provide sensor agnostic approaches to produce surface water maps. Furthermore, there are workflows that leverage multiple remote sensing dataset in conjunction to provide daily surface water maps for flood application.
+
+### Installation
+
+The recommended way to get up and started using the `hydrafloods` packages is to install using `pip`:
+
+```
+pip install hydrafloods
+```
+
+`pip` should handle some of the basic dependencies such as the Earth Engine Python API that we need for the majority of the functionality. It is planned to add hydrafloods to the conda-forge channel but that is currently not completed.
+
+To use the `hydrafloods` package successfully, Google Cloud and Earth Engine authentication is necessary. Tointialize the Google Cloud environment and authenticate using your credentials, run the following command:
+
+```
+gcloud init
+```
+
+To authenticate the Earth Engine Python API with your credentials, run the following:
+
+```
+earthengine authenticate
+```
+
+For more information on setup and installation of the `hydrafloods` package, please see the [Installation Docs](https://servir-mekong.github.io/hydra-floods/installation/).
+
+## Example
+
+To highlight a quick example of the `hydrafloods` API and simplicity to produce high-quality surface water maps we provide a quick example of mapping surface water using Sentinel-1 over the confluence of the Mekong and Tonle Sap rivers, which experiences frequent flooding.
+
+```python
+# import the hydrafloods and ee package
+import hydrafloods as hf
+import ee
+ee.Initialize()
+
+# specify start and end time as well as geographic region to process
+start_time = "2019-10-05"
+end_time =  "2019-10-06"
+region = ee.Geometry.Rectangle([104, 11.5, 106, 12.5 ])
+
+# get the Sentinel-1 collection
+# the hf.dataset classes performs the spatial-temporal filtering for you
+s1 = hf.datasets.Sentinel1(region, start_time, end_time)
+
+# apply a water mapping function to the S1 dataset
+# this applies the "Edge Otsu" algorithm from https://doi.org/10.3390/rs12152469
+water_imgs = s1.apply_func(
+    hf.thresholding.edge_otsu,
+    initial_threshold=-14,
+    thresh_no_data=-20,
+    edge_buffer=300
+)
+
+# take the mode from multiple images
+# since this is just imagery from one day, it will simply mosaic the images
+water_map = ee.Image(water_imgs.collection.mode())
+
+# export the water map
+hf.geeutils.export_image(
+    water_map,
+    region,
+    "users/<YOUR_USERNAME>/water_map_example",
+    scale=30,
+)
+```
+
+_(This script is complete, it should run "as is")_
+
+At the end of the script execution, there will be an [Earth Engine export task](https://developers.google.com/earth-engine/exporting#to-asset) running the process on the EE servers for use later in the EE platform. The resulting surface water image should look like the following figure. It should be noted that `hydrafloods` can scale quickly and easily by simply changing the start or end time and region to process, allowing for processing of surface water maps with minimal effort in terms of coding.
+
+![Quick Start Results](docs/img/quick_start_results.png)
+
+<!-- html code for figure caption -->
+<span class="img_caption" style="display: block; text-align: center; font-size: 14px">
+    __Figure 1.__ Sentinel-1 backscatter image (left) and resulting surface water map (right) from 2019-10-05 for a region in Cambodia as in the example.
+</span>
+
+Learn more about the package throughout the documentation such as [installation](https://servir-mekong.github.io/hydra-floods/installation/), the [algorithms available](https://servir-mekong.github.io/hydra-floods/algorithms/), or setting up the package to run operationally using the [CLI](https://servir-mekong.github.io/hydra-floods/cli/).
+
+## Get in touch
+
+- Report bugs, suggest features or view the source code on [GitHub](https://github.com/servir-mekong/hydra-floods).
+- Contact us through a [Technical Assistance Request](https://servir.adpc.net/services/technical-assistance) and mention "hydrafloods"
+
+## Contribute
+
+Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. Please see the [Contributing Guidelines](https://github.com/servir-mekong/hydra-floods/blob/master/CONTRIBUTING.md) for details on where to contribute and how to get started.
+
+## License
+
+`hydrafloods` is available under the open source [GNU General Public License v3.0](https://github.com/Servir-Mekong/hydra-floods/blob/master/LICENSE).
+
+
+
+
+%package -n python3-hydrafloods
+Summary:	HYDrologic Remote sensing Analysis for Floods
+Provides:	python-hydrafloods
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-hydrafloods
+# hydra-floods
+
+[![docs](https://github.com/Servir-Mekong/hydra-floods/workflows/docs/badge.svg)](https://servir-mekong.github.io/hydra-floods)
+![unittests](https://github.com/Servir-Mekong/hydra-floods/workflows/unittests/badge.svg)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![PyPI version](https://badge.fury.io/py/hydrafloods.svg)](https://badge.fury.io/py/hydrafloods)
+
+
+## Introduction
+
+The Hydrologic Remote Sensing Analysis for Floods (or HYDRAFloods) is an open source Python application for downloading, processing, and delivering surface water maps derived from remote sensing data. The bases behind the tool is to provide sensor agnostic approaches to produce surface water maps. Furthermore, there are workflows that leverage multiple remote sensing dataset in conjunction to provide daily surface water maps for flood application.
+
+### Installation
+
+The recommended way to get up and started using the `hydrafloods` packages is to install using `pip`:
+
+```
+pip install hydrafloods
+```
+
+`pip` should handle some of the basic dependencies such as the Earth Engine Python API that we need for the majority of the functionality. It is planned to add hydrafloods to the conda-forge channel but that is currently not completed.
+
+To use the `hydrafloods` package successfully, Google Cloud and Earth Engine authentication is necessary. Tointialize the Google Cloud environment and authenticate using your credentials, run the following command:
+
+```
+gcloud init
+```
+
+To authenticate the Earth Engine Python API with your credentials, run the following:
+
+```
+earthengine authenticate
+```
+
+For more information on setup and installation of the `hydrafloods` package, please see the [Installation Docs](https://servir-mekong.github.io/hydra-floods/installation/).
+
+## Example
+
+To highlight a quick example of the `hydrafloods` API and simplicity to produce high-quality surface water maps we provide a quick example of mapping surface water using Sentinel-1 over the confluence of the Mekong and Tonle Sap rivers, which experiences frequent flooding.
+
+```python
+# import the hydrafloods and ee package
+import hydrafloods as hf
+import ee
+ee.Initialize()
+
+# specify start and end time as well as geographic region to process
+start_time = "2019-10-05"
+end_time =  "2019-10-06"
+region = ee.Geometry.Rectangle([104, 11.5, 106, 12.5 ])
+
+# get the Sentinel-1 collection
+# the hf.dataset classes performs the spatial-temporal filtering for you
+s1 = hf.datasets.Sentinel1(region, start_time, end_time)
+
+# apply a water mapping function to the S1 dataset
+# this applies the "Edge Otsu" algorithm from https://doi.org/10.3390/rs12152469
+water_imgs = s1.apply_func(
+    hf.thresholding.edge_otsu,
+    initial_threshold=-14,
+    thresh_no_data=-20,
+    edge_buffer=300
+)
+
+# take the mode from multiple images
+# since this is just imagery from one day, it will simply mosaic the images
+water_map = ee.Image(water_imgs.collection.mode())
+
+# export the water map
+hf.geeutils.export_image(
+    water_map,
+    region,
+    "users/<YOUR_USERNAME>/water_map_example",
+    scale=30,
+)
+```
+
+_(This script is complete, it should run "as is")_
+
+At the end of the script execution, there will be an [Earth Engine export task](https://developers.google.com/earth-engine/exporting#to-asset) running the process on the EE servers for use later in the EE platform. The resulting surface water image should look like the following figure. It should be noted that `hydrafloods` can scale quickly and easily by simply changing the start or end time and region to process, allowing for processing of surface water maps with minimal effort in terms of coding.
+
+![Quick Start Results](docs/img/quick_start_results.png)
+
+<!-- html code for figure caption -->
+<span class="img_caption" style="display: block; text-align: center; font-size: 14px">
+    __Figure 1.__ Sentinel-1 backscatter image (left) and resulting surface water map (right) from 2019-10-05 for a region in Cambodia as in the example.
+</span>
+
+Learn more about the package throughout the documentation such as [installation](https://servir-mekong.github.io/hydra-floods/installation/), the [algorithms available](https://servir-mekong.github.io/hydra-floods/algorithms/), or setting up the package to run operationally using the [CLI](https://servir-mekong.github.io/hydra-floods/cli/).
+
+## Get in touch
+
+- Report bugs, suggest features or view the source code on [GitHub](https://github.com/servir-mekong/hydra-floods).
+- Contact us through a [Technical Assistance Request](https://servir.adpc.net/services/technical-assistance) and mention "hydrafloods"
+
+## Contribute
+
+Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. Please see the [Contributing Guidelines](https://github.com/servir-mekong/hydra-floods/blob/master/CONTRIBUTING.md) for details on where to contribute and how to get started.
+
+## License
+
+`hydrafloods` is available under the open source [GNU General Public License v3.0](https://github.com/Servir-Mekong/hydra-floods/blob/master/LICENSE).
+
+
+
+
+%package help
+Summary:	Development documents and examples for hydrafloods
+Provides:	python3-hydrafloods-doc
+%description help
+# hydra-floods
+
+[![docs](https://github.com/Servir-Mekong/hydra-floods/workflows/docs/badge.svg)](https://servir-mekong.github.io/hydra-floods)
+![unittests](https://github.com/Servir-Mekong/hydra-floods/workflows/unittests/badge.svg)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![PyPI version](https://badge.fury.io/py/hydrafloods.svg)](https://badge.fury.io/py/hydrafloods)
+
+
+## Introduction
+
+The Hydrologic Remote Sensing Analysis for Floods (or HYDRAFloods) is an open source Python application for downloading, processing, and delivering surface water maps derived from remote sensing data. The bases behind the tool is to provide sensor agnostic approaches to produce surface water maps. Furthermore, there are workflows that leverage multiple remote sensing dataset in conjunction to provide daily surface water maps for flood application.
+
+### Installation
+
+The recommended way to get up and started using the `hydrafloods` packages is to install using `pip`:
+
+```
+pip install hydrafloods
+```
+
+`pip` should handle some of the basic dependencies such as the Earth Engine Python API that we need for the majority of the functionality. It is planned to add hydrafloods to the conda-forge channel but that is currently not completed.
+
+To use the `hydrafloods` package successfully, Google Cloud and Earth Engine authentication is necessary. Tointialize the Google Cloud environment and authenticate using your credentials, run the following command:
+
+```
+gcloud init
+```
+
+To authenticate the Earth Engine Python API with your credentials, run the following:
+
+```
+earthengine authenticate
+```
+
+For more information on setup and installation of the `hydrafloods` package, please see the [Installation Docs](https://servir-mekong.github.io/hydra-floods/installation/).
+
+## Example
+
+To highlight a quick example of the `hydrafloods` API and simplicity to produce high-quality surface water maps we provide a quick example of mapping surface water using Sentinel-1 over the confluence of the Mekong and Tonle Sap rivers, which experiences frequent flooding.
+
+```python
+# import the hydrafloods and ee package
+import hydrafloods as hf
+import ee
+ee.Initialize()
+
+# specify start and end time as well as geographic region to process
+start_time = "2019-10-05"
+end_time =  "2019-10-06"
+region = ee.Geometry.Rectangle([104, 11.5, 106, 12.5 ])
+
+# get the Sentinel-1 collection
+# the hf.dataset classes performs the spatial-temporal filtering for you
+s1 = hf.datasets.Sentinel1(region, start_time, end_time)
+
+# apply a water mapping function to the S1 dataset
+# this applies the "Edge Otsu" algorithm from https://doi.org/10.3390/rs12152469
+water_imgs = s1.apply_func(
+    hf.thresholding.edge_otsu,
+    initial_threshold=-14,
+    thresh_no_data=-20,
+    edge_buffer=300
+)
+
+# take the mode from multiple images
+# since this is just imagery from one day, it will simply mosaic the images
+water_map = ee.Image(water_imgs.collection.mode())
+
+# export the water map
+hf.geeutils.export_image(
+    water_map,
+    region,
+    "users/<YOUR_USERNAME>/water_map_example",
+    scale=30,
+)
+```
+
+_(This script is complete, it should run "as is")_
+
+At the end of the script execution, there will be an [Earth Engine export task](https://developers.google.com/earth-engine/exporting#to-asset) running the process on the EE servers for use later in the EE platform. The resulting surface water image should look like the following figure. It should be noted that `hydrafloods` can scale quickly and easily by simply changing the start or end time and region to process, allowing for processing of surface water maps with minimal effort in terms of coding.
+
+![Quick Start Results](docs/img/quick_start_results.png)
+
+<!-- html code for figure caption -->
+<span class="img_caption" style="display: block; text-align: center; font-size: 14px">
+    __Figure 1.__ Sentinel-1 backscatter image (left) and resulting surface water map (right) from 2019-10-05 for a region in Cambodia as in the example.
+</span>
+
+Learn more about the package throughout the documentation such as [installation](https://servir-mekong.github.io/hydra-floods/installation/), the [algorithms available](https://servir-mekong.github.io/hydra-floods/algorithms/), or setting up the package to run operationally using the [CLI](https://servir-mekong.github.io/hydra-floods/cli/).
+
+## Get in touch
+
+- Report bugs, suggest features or view the source code on [GitHub](https://github.com/servir-mekong/hydra-floods).
+- Contact us through a [Technical Assistance Request](https://servir.adpc.net/services/technical-assistance) and mention "hydrafloods"
+
+## Contribute
+
+Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. Please see the [Contributing Guidelines](https://github.com/servir-mekong/hydra-floods/blob/master/CONTRIBUTING.md) for details on where to contribute and how to get started.
+
+## License
+
+`hydrafloods` is available under the open source [GNU General Public License v3.0](https://github.com/Servir-Mekong/hydra-floods/blob/master/LICENSE).
+
+
+
+
+%prep
+%autosetup -n hydrafloods-2021.10.11
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-hydrafloods -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed May 17 2023 Python_Bot <Python_Bot@openeuler.org> - 2021.10.11-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..2308171
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+bbbe70ec9760d638fb1b488dbbfb8eb5  hydrafloods-2021.10.11.tar.gz