The Flood mapping python toolbox (Floodpy) is a free and open-source python toolbox for mapping the non-urban flooded regions. It exploits the dense Sentinel-1 GRD intensity time series using a statistical or a ViT (Visual Transfomer) approach. Before running Floodpy make use you know the following information of the flood event of your interest
- Date and time of the flood event
- Spatial information (e.g. min,max latitude and min,max longitude) of the flood event
This is research code provided to you "as is" with NO WARRANTIES OF CORRECTNESS. Use at your own risk.
The installation notes below are tested only on Linux. Recommended setup: Python 3.9+, SNAP 9.0+
Please download ESA-SNAP (All Toolboxes) from here and install it using the following commands:
chmod +x esa-snap_all_linux-10.0.0.sh
./esa-snap_all_linux-10.0.0.shEven though we offer credentials (for demonstration reasons), we encourage you to create your own account in order to not encounter any problems due to traffic.
- Please create an account at: Copernicus-DataSpace.
FloodPy can download meteorological data from based on ERA-5 data.
You have to create a new account here if you don't own a user account yet.
After the creation of your profile, you will find your Personal Access Token on your User profile page.
Create manually a .cdsapirc file under your HOME directory with the following information:
url: https://cds.climate.copernicus.eu/api
key: Your Personal Access Token
You can download FLOODPY toolbox using the following command:
git clone https://github.com/kleok/FLOODPY.git
FLOODPY is written in Python3 and relies on several Python modules. We suggest to install them by using conda.
- Using conda Create a new conda environement with required packages using the the file FLOODPY_gpu_env.yml.
conda env create -f path_to_FLOODPY/FLOODPY_gpu_env.yml
Append to .bashrc file
export FLOODPY_HOME= path_of_the_FLOODPY_folder
export PYTHONPATH=${PYTHONPATH}:${FLOODPY_HOME}
export PATH=${PATH}:${FLOODPY_HOME}/floodpy
FLOODPY generates a map with flooded regions based on Sentinel-1 GRD products and meteorological data. Sentinel-1 orbits are downloaded using the sentineleof You can run FLOODPY using the following jupyter notebooks as templates.
Algorithms implemented in the software are described in detail at our publications. If FLOODPY was useful for you, we encourage you to cite the following work:
-
Karamvasis K, Karathanassi V. FLOMPY: An Open-Source Toolbox for Floodwater Mapping Using Sentinel-1 Intensity Time Series. Water. 2021; 13(21):2943. https://doi.org/10.3390/w13212943
-
Kuro Siwo: 33 billion m2 under the water. A global multi-temporal satellite dataset for rapid flood mapping. https://paperswithcode.com/paper/kuro-siwo-12-1-billion-m-2-under-the-water-a
You can also have a look at other works that are using FLOODPY:
-
Gounari 0., Falagas A., Karamvasis K., Tsironis V., Karathanassi V., Karantzalos K.: Floodwater Mapping & Extraction of Flood-Affected Agricultural Fields. Living Planet Symposium Bonn 23-27 May 2022.
https://drive.google.com/file/d/1HiGkep3wx45gAQT6Kq34CdECMpQc8GUV/view?usp=sharing -
Zotou I., Karamvasis K., Karathanassi V., Tsihrintzis V.: Sensitivity of a coupled 1D/2D model in input parameter variation exploiting Sentinel-1-derived flood map. 7th IAHR Europe Congress. September 7-9, 2022. Page 247 at https://www.iahreuropecongress.org/PDF/IAHR2022_ABSTRACT_BOOK.pdf
-
Zotou I, Karamvasis K, Karathanassi V, Tsihrintzis VA. Potential of Two SAR-Based Flood Mapping Approaches in Supporting an Integrated 1D/2D HEC-RAS Model. Water. 2022; 14(24):4020. https://doi.org/10.3390/w14244020
Feel free to open an issue, comment or pull request. We would like to listen to your thoughts and your recommendations. Any help is very welcome! ❤️