Veloserver is a geospatial data visualization server designed to dynamically return velocity data such as winds and ocean currents from weather models and other datasets. It returns the data in formats optimized for visualizing in a web client including animated vector streamlines via gribjson. It includes built-in caching to reduce requests to external data sources and deliver quick results.
Build
docker build --platform=linux/amd64 -t NASA-AMMOS/veloserver:latest .
Run
docker run --rm -p 8104:8104 -v ~/.ecmwfapirc:/root/.ecmwfapirc/ --name veloserver NASA-AMMOS/veloserver:latest
With SSL certs:
docker run --rm -p 8104:8104 -v ~/.ecmwfapirc:/root/.ecmwfapirc/ -v $(pwd)/certs:/certs --name veloserver NASA-AMMOS/veloserver:latest
With an external cache directory:
docker run --rm -p 8104:8104 -v ~/.ecmwfapirc:/root/.ecmwfapirc/ -v $(pwd)/certs:/certs -v $(pwd)/cache:/home/veloserver/cache --name veloserver NASA-AMMOS/veloserver:latest
To use ECMWF data, you need to have an ECMWF account with an appropriate licence and your key added to ~/.ecmwfapirc.
Default server port is 8104. REST requests are structured in the form:
/<model>/<format>/<datetime>/<projwin>
model - Available options: gribjson, geojson, geotiff, png
format - Available options: ecmwf, gfs, hrrr
datetime - In ISO8601 format: YYYY-MM-DDThh:mm:ssZ
projwin - Bounding box window in format: ulx,uly,lrx,lry
HRRR global wind data for 2025-01-01 at midnight: http://localhost:8104/hrrr/gribjson/2025-01-01/
ECMWF localized wind data for 2025-01-01 at 06:00:00 UTC: http://localhost:8104/ecmwf/gribjson/2025-01-01T06:00:00Z/-118,34,-117,33/