What is HLS Geospatial?¶
This repository contains the code supporting the HLS Geospatial base model for use with Autodistill.
Harmonized Landsat and Sentinel-2 (HLS) Prithvi is a collection of foundation models for geospatial analysis, developed by NASA and IBM. You can use Autodistill to automatically label images for use in training segmentation models.
The following models are supported:
This module accepts tiff
files as input and returns segmentation masks.
Installation¶
To use HLS Geospatial with autodistill, you need to install the following dependency:
pip3 install autodistill-hls-geospatial
Quickstart¶
from autodistill_hls_geospatial import HLSGeospatial
import numpy as np
import rasterio
from skimage import exposure
import supervision as sv
def stretch_rgb(rgb):
ls_pct = 1
pLow, pHigh = np.percentile(rgb[~np.isnan(rgb)], (ls_pct, 100 - ls_pct))
img_rescale = exposure.rescale_intensity(rgb, in_range=(pLow, pHigh))
return img_rescale
#replace with the name of the file you want to label
FILE_NAME = "USA_430764_S2Hand.tif"
with rasterio.open(FILE_NAME) as src:
image = src.read()
mask = image
rgb = stretch_rgb(
(mask[[3, 2, 1], :, :].transpose((1, 2, 0)) / 10000 * 255).astype(np.uint8)
)
base_model = HLSGeospatial()
# replace with the file you want to use
detections = base_model.predict(FILE_NAME)
mask_annotator = sv.MaskAnnotator()
annotated_image = mask_annotator.annotate(scene=rgb, detections=detections)
sv.plot_image(annotated_image, size=(10, 10))
# label a folder of .tif files
base_model.label("./context_images", extension=".tif")
License¶
This project is licensed under an Apache 2.0 license.