README.md

---
license: apache-2.0
language:
- en
tags:
- Pytorch
- mmsegmentation
- segmentation
- burn scars
- Geospatial
- Foundation model
datasets:
- ibm-nasa-geospatial/hls_burn_scars
metrics:
- accuracy
- IoU
- F1 Score
---

### Model and Inputs
The pre-trained [Prithvi-100m](https://huggingface.co/ibm-nasa-geospatial/Prithvi-100M/blob/main/README.md) parameter model is fine-tuned to detect burn scars on HLS data from the [HLS burn scar scenes dataset](https://huggingface.co/datasets/ibm-nasa-geospatial/hls_burn_scars). This dataset includes input tiles of 512x512x6, where 512 is the height and width and 6 is the number of bands. The bands are:
 
1. Blue
2. Green
3. Red
4. Narrow NIR
5. SWIR 1
6. SWIR 2
![](burn_scar.png)
It is important to point out that the HLS burn scar scenes dataset includes a single timestep, while the Prithvi-100m was pretrained with three timesteps. The difference highlights the flexibility of this model to adapt to different downstream tasks and requirements.

### Code
Code for fine-tuning is available through [Github](https://github.com/NASA-IMPACT/hls-foundation-os/tree/main/fine-tuning-examples)

Configuration used for fine-tuning is available through [config](https://github.com/NASA-IMPACT/hls-foundation-os/blob/main/fine-tuning-examples/configs/firescars_config.py
).

### Results
The experiment conducted by running the mmseg stack for 50 epochs using the above config led to an IoU of **0.72** on the burn scar class and **0.96** overall accuracy. It is noteworthy that this leads to a reasonably good model, but further developement will most likely improve performance.

### Inference and demo
The github repo includes an inference script that allows to run the burn scar model for inference on HLS images. These inputs have to be in geotiff format, including the channels described above (Blue, Green, Red, Narrow NIR, SWIR, SWIR 2) in reflectance units [0-1]. A **demo** that leverages the same code can be found **[here](https://huggingface.co/spaces/ibm-nasa-geospatial/Prithvi-100M-Burn-scars-demo)**.

### Citation

If this model helped your research, please cite `Prithvi-100M-burn-scar` in your publications. Here is an example BibTeX entry:

```
@misc{Prithvi-100M-burn-scar,
    author = {Roy, Sujit and Phillips, Christopher and Jakubik, Johannes and Fraccaro, Paolo and Ankur, Kumar and Avery, Ryan and Ji, Wei and Zadrozny, Bianca and Ramachandran, Rahul},
    doi    = {https://huggingface.co/ibm-nasa-geospatial/Prithvi-100M-burn-scar},
    month  = aug,
    title  = {{Prithvi 100M burn scar}},
    url    = {https://huggingface.co/ibm-nasa-geospatial/Prithvi-100M-burn-scar},
    year   = {2023}
}
```