README.md

# FACT Land Use Land Cover

---
## Use
The docker container can be started with the following code:
>podman run -t -i --name fact_lulc -p 5004:5000 -d registry.git.nilu.no/fact/data/fact_lulc:0.3

The service could be queried passing the JSON polygon object as in:
```
curl -X POST http://localhost:5004/band_statistics \
-H "Content-Type: application/json" \
-d '{
    "polygon_wkt": "POLYGON (())"
}'
```

The polygon definition is made of several points coordinates, as in the case of polygon objects from shapefiles stored in databases. Polygon and COG rasters must share the same coordinate system, which in this case is lat and lon.

---
## Specifications
The API is based on the Flask based web service provided by the FACT Utils [polygonqueryonraster](https://git.nilu.no/fact/utils/PolygonQueryOnRaster/-/packages) package from the the [FACT Polygon Query on Raster](https://git.nilu.no/fact/utils/PolygonQueryOnRaster) project.

The data is from the Terra Advanced Spaceborne Thermal Emission and Reflection Radiometer (ASTER) Global Digital Elevation Model (GDEM) Version 3 (ASTGTM - https://lpdaac.usgs.gov/products/astgtmv003/), that provides a global digital elevation model (DEM) of land areas on Earth at a spatial resolution of 1 arc second (approximately 30 meter horizontal posting at the equator). Coverage is provided from from -83 to 83 degrees latitude.

---
## Notes
Since this service is based on a continuous raster, results for polygon elevation will include:
- 'count' of pixels in the polygon,
- 'min' elevation,
- 'max' elevation,
- 'mean' elevation,
- 'std' standard deviation of elevation,
- 'median' elevation,
- 'entropy', which is the Shannon entropy measure of elevation data.


---
### Authors
Riccardo Boero - ribo@nilu.no

### License