Commit
•
1c8fb3b
1
Parent(s):
e99dbd8
Update README.md (#19)
Browse files- Update README.md (2c8012fc998151a7edc99d46776c2f755fb71622)
Co-authored-by: Muaaz Bhamjee <muaazbhamjee@users.noreply.huggingface.co>
README.md
CHANGED
@@ -7,7 +7,7 @@ license: apache-2.0
|
|
7 |
<img src="Johannesburg_summer_lst_animation.gif" width="800">
|
8 |
</p>
|
9 |
|
10 |
-
The granite-geospatial-land-surface-temperature model is a fine-tuned geospatial foundation model for predicting the land surface temperature (LST) using satellite imagery along with climate statistics. Excessive urban heat has been shown to have adverse effects across a range of dimensions, including increased energy demand, severe heat stress on human and non-human populations, and worse air and water quality. As global cities become more populous with increasing rates of urbanization, it is crucial to model and understand urban temperature dynamics and its impacts. Characterizing and mitigating Urban Heat Island (UHI) effects is dependent on the availability of high-resolution (spatial and temporal) LST data. This model is fine-tuned using a combination of Harmonised Landsat Sentinel-2 [(HLS L30)](https://hls.gsfc.nasa.gov/products-description/l30/) and ECMWF Reanalysis v5 [(ERA5-Land)](https://cds.climate.copernicus.eu/datasets/reanalysis-era5-land?tab=overview)
|
11 |
|
12 |
<p align="center" width="100%">
|
13 |
<img src="cities_map2.png" width="800">
|
@@ -38,12 +38,12 @@ For more details, check out the tutorials below which guide the user through the
|
|
38 |
|
39 |
2. For data download and data pre-processing to create your own dataset check out the [Download Notebook!](https://github.com/ibm-granite/granite-geospatial-land-surface-temperature/blob/main/notebooks/2_download_data.ipynb) and the [Preprocessing Notebook!](https://github.com/ibm-granite/granite-geospatial-land-surface-temperature/blob/main/notebooks/3_preprocess_data.ipynb)
|
40 |
|
41 |
-
3. For Tweening (Temporal Gap-Filling) check out the [
|
42 |
|
43 |
|
44 |
## Model Description
|
45 |
|
46 |
-
The granite-geospatial-land-surface-temperature model is a geospatial foundation model that has been fine-tuned using HLS L30 and ERA5-Land data to predict LST at a high spatial resolution (
|
47 |
|
48 |
More details on the base foundation model can be found in this [paper](https://arxiv.org/abs/2310.18660)
|
49 |
|
@@ -64,7 +64,7 @@ For more details on this approach, refer to:
|
|
64 |
### Model Sources
|
65 |
|
66 |
- **Repository:** https://github.com/ibm-granite/granite-geospatial-land-surface-temperature
|
67 |
-
- **Paper (UHI):** https://ieeexplore.ieee.org/document/10641750 - we have since extended on this approach by training on multiple cites to downscale to
|
68 |
- **Paper (foundation model):** https://arxiv.org/abs/2310.18660
|
69 |
|
70 |
### External Blogs
|
|
|
7 |
<img src="Johannesburg_summer_lst_animation.gif" width="800">
|
8 |
</p>
|
9 |
|
10 |
+
The granite-geospatial-land-surface-temperature model is a fine-tuned geospatial foundation model for predicting the land surface temperature (LST) using satellite imagery along with climate statistics. Excessive urban heat has been shown to have adverse effects across a range of dimensions, including increased energy demand, severe heat stress on human and non-human populations, and worse air and water quality. As global cities become more populous with increasing rates of urbanization, it is crucial to model and understand urban temperature dynamics and its impacts. Characterizing and mitigating Urban Heat Island (UHI) effects is dependent on the availability of high-resolution (spatial and temporal) LST data. This model is fine-tuned using a combination of Harmonised Landsat Sentinel-2 [(HLS L30)](https://hls.gsfc.nasa.gov/products-description/l30/) and ECMWF Reanalysis v5 [(ERA5-Land)](https://cds.climate.copernicus.eu/datasets/reanalysis-era5-land?tab=overview) 2m near-surface air temperature (T2m) datasets across 28 global cities from varying hydroclimatic zones for the period 2013-2023.
|
11 |
|
12 |
<p align="center" width="100%">
|
13 |
<img src="cities_map2.png" width="800">
|
|
|
38 |
|
39 |
2. For data download and data pre-processing to create your own dataset check out the [Download Notebook!](https://github.com/ibm-granite/granite-geospatial-land-surface-temperature/blob/main/notebooks/2_download_data.ipynb) and the [Preprocessing Notebook!](https://github.com/ibm-granite/granite-geospatial-land-surface-temperature/blob/main/notebooks/3_preprocess_data.ipynb)
|
40 |
|
41 |
+
3. For Tweening (Temporal Gap-Filling) check out the [Introduction to LST Tweening Notebook!](https://github.com/ibm-granite/granite-geospatial-land-surface-temperature/blob/main/notebooks/4_introduction_to_LST_Tweening.ipynb) for a tutorial on how to implement Tweening and the [Tweening Data Preparation Notebook!](https://github.com/ibm-granite/granite-geospatial-land-surface-temperature/blob/main/notebooks/5_tweening_data_preparation.ipynb) for a tutorial on preparing the data for Tweening
|
42 |
|
43 |
|
44 |
## Model Description
|
45 |
|
46 |
+
The granite-geospatial-land-surface-temperature model is a geospatial foundation model that has been fine-tuned using HLS L30 and ERA5-Land data to predict LST at a high spatial resolution (30m) and high temporal frequency (hourly). The fine-tuned granite-geospatial-land-surface-temperature model incorporates a Shifted Windowing (SWIN) Transformer architecture and leverages the IBM Earth Observation Foundation Model, “Prithvi-SWIN-L” as the base foundation model. For fine-tuning, we used a SWIN backbone with unfrozen pre-trained weights for the encoder and a decoder that comprised of a Unified Perceptual Parsing for Scene Understanding (UperNet) regression head with an auxiliary 1-layer Convolution regression head and a Linear final activation layer.
|
47 |
|
48 |
More details on the base foundation model can be found in this [paper](https://arxiv.org/abs/2310.18660)
|
49 |
|
|
|
64 |
### Model Sources
|
65 |
|
66 |
- **Repository:** https://github.com/ibm-granite/granite-geospatial-land-surface-temperature
|
67 |
+
- **Paper (UHI):** https://ieeexplore.ieee.org/document/10641750 - we have since extended on this approach by training on multiple cites to downscale to 30m resolution LST. We have also included functionality for temporal gap filling, "Tweening".
|
68 |
- **Paper (foundation model):** https://arxiv.org/abs/2310.18660
|
69 |
|
70 |
### External Blogs
|