Skip to main content

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 and SUMHAL 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

Geeltermap is based on the Geemap package, a Python API that allows access to Google Earth Engine (GEE) 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 and its Python API, DeimsPy. 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

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 and 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 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, has been developed to facilitate the speedy and effortless download of HR-VPP products across all eLTER sites.

PhenoApp

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

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

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

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

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.

Metadata

Release files for geeltermap 0.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for geeltermap 0.1.10
File Size Uploaded Provenance Actions
geeltermap-0.1.10.tar.gz 2.2 MB Without provenance Details for geeltermap-0.1.10.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for geeltermap 0.1.10
File Interpreter ABI Platform Actions
geeltermap-0.1.10-py3-none-any.whl Python 3 none any Details for geeltermap-0.1.10-py3-none-any.whl

Total release size: 4.3 MB

Release files / geeltermap-0.1.10.tar.gz

Download URL geeltermap-0.1.10.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
4c11ee92dc31da24da5931842e738e59c474b88628deaa6380d5a59f4d3cd401
BLAKE2b-256 checksum
How to use checksums
4a7c193db685d4dbd50e4d46968257c91f0ca6ac5b5e1d736bb39db3b700f076
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.4 CPython/3.10.12 Linux/6.8.0-90-generic

Release files / geeltermap-0.1.10-py3-none-any.whl

Download URL geeltermap-0.1.10-py3-none-any.whl
Size 2.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
f9f27f720ee8fe023b8032131f5ad822d8d3676837d4e1a10d45231f919a2fec
BLAKE2b-256 checksum
How to use checksums
01fb50e7debfe86d6069ced8c8981bbc77f35a00ce5f5b28bd4e776473530867
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.4 CPython/3.10.12 Linux/6.8.0-90-generic

Security for geeltermap 0.1.10

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page