Skip to content

LUMS-WIT/SMAP-Anomaly-Maps

Repository files navigation

WIT-GeoSpatial-Maps (Beta)

Soil Moisture (SMAP) , Precipitation (IMERG) climatology & anomaly maps, built on the Google Earth Engine (GEE) API and Google Colab.

https://lumswit.users.earthengine.app/view/wit-geo

The app uses the SMAP Level-4 (L4) Global 9 km product for root-zone soil moisture (0–100 cm). Daily anomalies are computed against day-of-year climatology stacks (per month, per day band). Optionally, daily precipitation (IMERG V07) layers are displayed.

What the app shows

Soil Moisture (SMAP, root-zone)

  • Daily
    • Soil Moisture: latest SMAP L4 root-zone soil moisture (cm³/cm³).
    • Soil Moisture Climatology: day-of-month band from your monthly stack.
    • Soil Moisture Anomaly: latest minus climatology.
  • 7-Day
    • Soil Moisture (7-Day Mean): rolling 7-day average.
    • Soil Moisture Climatology (7-Day): multi-year 7-day mean anchored to the same DOY window.
    • Soil Moisture Anomaly (7-Day): 7-day mean minus 7-day climatology.

Precipitation (IMERG)

  • Daily

    • Precipitation: last full UTC day accumulated from half-hourly IMERG frames (mm; each frame × 0.5).
    • Precipitation Climatology: day-of-year band from monthly stacks (shown where assets exist).
    • Precipitation Anomaly: daily precipitation minus daily climatology.
  • 7-Day

    • Precipitation (7-Day Sum): rolling 7-day cumulative rainfall ending at the last full UTC day (mm).
    • Precipitation Climatology (7-Day): multi-year 7-day sum anchored to the same DOY window (built from full archive).
    • Precipitation Anomaly (7-Day): 7-day sum minus 7-day climatology.

The date overlay auto-switches between SMAP and IMERG dates based on the selected layer (displayed in UTC+5).

Prerequisites (Notebook Only)

Get Started

  1. Create SMAP daily climatology stacks
    Use the Colab notebook smap_climatology.ipynb to generate per-month images whose bands correspond to days of the month (0-indexed).

    Example assets for Aug–Dec (2015–2024) are listed under data/.

  2. Upload climatology stacks to GEE Assets
    Import the generated GeoTIFFs as Image assets in the GEE Code Editor and note each asset ID.

  3. Configure and run the app
    Open the GEE Code Editor and use main.js.

    • Update the SMAP asset IDs for each month in sm_month_to_climo.
    • (Recommended) add IMERG day-of-month stacks to imergClimoAssets for precip climatology/anomaly.
    • Click Run to launch the UI (layers + legend + date overlay).

Feature roadmap & priorities

Area Feature Priority Status / Notes
Hydrology Flood maps (near-real-time flood extent) P1 Completed. Derive inundation using SAR or optical composites; expose as toggle layer with legend.
UX Load screen wait message (first-time app init) P1 Planned. One-time overlay panel while server graph compiles; auto-hide once first layer renders.
UX Mobile Phone Compatibility P2 To Do. User interface should be compatible for both andriod and iOS.
Data Access Download data at basin / catchment scale P2 To Do. User selects basin; app provides zonal stats time-series (CSV) and raster exports (GeoTIFF/PNG) for SMAP/IMERG (daily & 7-day).

Citation

If you use this software, please cite it as follows:

@software{rafique2025wit-geospatial-maps,
  title = {WIT-GeoSpatial-Maps: A Comprehensive Dataset of Geospatial Maps for Anomaly Detection},
  author = {Hamza Rafique and Haseeb Ahmad and Ahmad Haseeb Rabbani},
  year = {2025},
  version = {1.0},
  url = {https://github.com/LUMS-WIT/SMAP-Anomaly-Maps},
  license = {Apache-2.0}
}

Note

legacy work (working): https://hamzarafique.users.earthengine.app/view/soil-moisture-anomoly The legacy application on GEE website is currently accessible to a private group. If you want access, please email your request at hamza.rafique@lums.edu.pk

About

Soil Moisture Anomaly and Climatology maps and Application using GEE API / Colab.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors