Skip to content
Snippets Groups Projects
README.md 1.73 KiB
Newer Older
Riccardo Boero's avatar
Riccardo Boero committed
# FACT Land Use Land Cover

---
## Use
The docker container can be started with the following code:
Riccardo Boero's avatar
Riccardo Boero committed
>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:
```
Riccardo Boero's avatar
Riccardo Boero committed
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.
Riccardo Boero's avatar
Riccardo Boero committed

---
## 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.
Riccardo Boero's avatar
Riccardo Boero committed

---
## 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.

Riccardo Boero's avatar
Riccardo Boero committed

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

### License