geeltermap 0.1.10
Python mapping application based on Geemap and GEE designed to provide phenology, flood and LST satellite data to eLTER sites
License: MIT
Requires Python: <4.0,>=3.8
Keywords: eLTER, Phenology, Flood, LST, GEE, Geemap, Python

# GeeLTERMap

The GeeLTERMap python package has been created as a resource for scientists and site managers integrated into the eLTER network to evaluate the monitoring of long-term ecosystem variables. It was developed within the scope of the [eLTER Plus](https://elter-ri.eu/elter-plus) and [SUMHAL](https://lifewatcheric-sumhal.csic.es/) projects. 
The package offers a dynamic map that integrates with deimsPY to facilitate the selection of any site in the eLTER network. Users can access phenometrics, surface temperature, and flooding data through three tools integrated in the main map application (PhenoApp, FloodApp and LSTApp).

![Projects logos](https://i.imgur.com/mvnOXuo.png)

Geeltermap is based on the [Geemap](https://geemap.org/) package, a Python API that allows access to [Google Earth Engine (GEE)](https://earthengine.google.com/) datasets and algorithms and provides an interactive map interface. Additionally, we have access to all alphanumeric and spatial information from the Elter sites thanks to [DEIMS](https://deims.org/) and its Python API, [DeimsPy](https://pypi.org/project/deims/). Furthermore, by enabling access to all relevant site-related information, we can establish custom filters for sites on which we wish to perform specific procedures.

![GeeLTERMap](https://i.imgur.com/YzuOcl8.png)


Our application includes three buttons integrated into a Leaflet/Geemap map environment. Each button provides access to one of the three primary tools described in subsequent below. Additionally, a form has been included inside the map as another button. This form allows users to submit their own data for validating satellite products.


## PhenoApp

This application enables users to monitor the long-term LSP of various types of vegetation covers. The application features a dynamic map that permits site selection within the network to view phenological metrics for individual or grouped pixels. These metrics are generated using the Sentinel 2 image series with the Python libraries [Ndvi2Gif](https://pypi.org/project/ndvi2gif/) and [PhenoPY](https://github.com/JavierLopatin/PhenoPY). Additionally, the application integrates the MODIS phenology products (MCD12Q2.006) and the Copernicus Sentinel 2 High Resolution Vegetation Phenology Product (HR-VPP) for comparison purposes. The application also includes a button for downloading the generated rasters as GeoTIFF files. The downloading of big areas is supported than to [Geedim](https://pypi.org/project/geedim/) python package  
While Sentinel 2 products are not currently available as GEE datasets, they are offered exclusively for some selected sites. MODIS phenology, however, is available for all eLTER sites. In any case, a new Python package, [pyvpp](https://pypi.org/project/pyvpp/), has been developed to facilitate the speedy and effortless download of HR-VPP products across all eLTER sites.

![PhenoApp](https://i.imgur.com/dmG3G36.jpg)

## FloodApp

FloodApp is a tool for obtaining the flooded surface of eTER sites. The tool design includes the complete Landsat series from Landsat 4-TM to Landsat 9-OLI, which provides data from 1984 until now, along with Sentinel 2, which provides data from 2017, as datasets. 
The tool also enables obtaining pixel-wise statistics if the selected study period covers multiple images. The statistics include the minimum, maximum, mean, median, and percentiles of 10th, 20th, 90th, and 95th for different water indices. Water indices availables are NDWI (McFeeters 1996), NDWI (Gao et al. 2015), MNDWI (Xu 2006) and AWEI (Feyisa et al. 2014). SWIR-2 band has also been added to the list of water indices since we have been detected and tested, and this band offers a very good quality water mask in marshland areas. The user can also set a threshold to identify the index cutoff value that closely corresponds to the actual flooded area. 
Scenes could be filtered based on cloud cover to exclude those with a high percent of cloud cover over the area.  Also note that two RGB compositions of the chosen period are added to the map along with the water index, though the display is disabled by default. This enables visual comparison of flooding mask with real conditions. A button for downloading the generated rasters as GeoTIFF files is also provided.

![FloodApp](https://i.imgur.com/JZu7lED.png)

## LSTApp

The Land Surface Temperature tool provides access MODIS (MOD11A1) and Landsat (TIRS) datasets (Landsat 8 and 9 merged in one collection). The tool provides users with options to select the desired site, collection, start and end dates, filter by scene cloud coverage for Landsat and quality band for MODIS, and choose the band and statistic for image reduction in the desired timeframe. Likewise for the PhenoApp and FloodApp a legend can be displayed if desired on the screen. Like the other two tools, users can download data obtained from the LSTApp. 
Available bands are: ST_B10 for Landsat and LST_Day_1km & LST_Night_1km for MODIS. Available statistics fro image collections reduction are: minimum, maximum, mean, median, and percentiles of 10th, 20th, 90th, and 95th.

![LSTApp](https://i.imgur.com/EsbThl5.jpg)

## Form

A form has been added to the map for uploading ground truth data from ELTER sites. This data can be used later to validate the products obtained through teledetection. It has been integrated into the map to provide interactive validation. This phase of work is still in development, but currently, the data is stored in a text file. The platform also allows for the upload of a data file stored in Datalab, which will be used later for validation.

![Form](https://i.imgur.com/V08pjaS.jpg)

## Installation

Just pip install geeltermap
    
    ```python
    pip install geeltermap
    ``` 

## Usage

Just run the map and follow your natural instinct ;P

    ```python
    from geeltermap import map
    map()
    ```

Whatever, a video tutorial showing some examples can be found below:

[![geeltermap video](https://i.imgur.com/XqqRXyy.jpg)](https://www.youtube.com/watch?v=unxqGwAcBfA&t=2439s)


## ToDO

The project is almost done, but next steps should be:

- [ ] Process phenology on the fly through geemap and GEE
- [ ] Add Sentinel 3 data to LST tool (It can be achieved now with PyVpp)
- [ ] Make more interactive the form with the map
- [ ] Add Time Series data to Flood and LST tools

## Contributing

Please, if you want to help me with one of the ToDos or you have any idea to improve the project I will be very happy to hear from you.