https://github.com/metno/edrisobaric
OGC EDR API for isobaric data from https://api.met.no/weatherapi/isobaricgrib/1.0/documentation
https://github.com/metno/edrisobaric
api covjson edr grib grib2 isobaric knmi mit mit-license ogc python
Last synced: about 2 months ago
JSON representation
OGC EDR API for isobaric data from https://api.met.no/weatherapi/isobaricgrib/1.0/documentation
- Host: GitHub
- URL: https://github.com/metno/edrisobaric
- Owner: metno
- License: mit
- Created: 2024-01-02T09:45:01.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-06T09:12:47.000Z (2 months ago)
- Last Synced: 2025-11-06T11:11:27.634Z (2 months ago)
- Topics: api, covjson, edr, grib, grib2, isobaric, knmi, mit, mit-license, ogc, python
- Language: Python
- Homepage:
- Size: 3.39 MB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# EDR-isobaric
## What is EDR-isobaric?
EDR-isobaric is an API for isobaric data (temperature and wind in isobaric layers). The API is based on [OGC Environmental Data Retrieval (EDR)](https://ogcapi.ogc.org/edr/). Data source is [GRIB](https://en.wikipedia.org/wiki/GRIB) files from .
The resulting API is for people who need vertical environmental data for a single location.
The code is written as an example aimed at API developers at Met.no.
Resulting data can be pasted into [covjson playground](https://covjson.org/playground) for visualizing:
The area covered by the source:
[](https://github.com/pylint-dev/pylint)
[](https://github.com/psf/black)
[](https://github.com/PyCQA/bandit)
[](https://github.com/metno/edrisobaric/blob/main/LICENSE)
## Who is responsible?
- larsfp at met.no
## Status
Feature complete.
## Getting started
### Test it out
Choose one of the following:
#### Pull image from Github registry and run with docker
```bash
docker pull ghcr.io/metno/edrisobaric:main
docker run -it --rm --publish 5000:5000 ghcr.io/metno/edrisobaric:main --bind_host 0.0.0.0
```
#### Build using Uv
Clone repo and run:
```bash
uv venv
uv pip sync requirements.txt
uv run app/app.py
```
#### Web
A test instance is available at .
## Usage
A grib data file will be downloaded on demand if none is supplied.
Staring the app will give these URLs:
- Landig page:
- Openapi spec:
- SwaggerUI:
- Redoc:
Example position lookup:
-
Arguments supported:
```bash
usage: app.py [-h] [--time TIME] [--file FILE] [--base_url BASE_URL] [--bind_host BIND_HOST] [--api_url API_URL] [--data_path DATA_PATH]
options:
-h, --help show this help message and exit
--time TIME Timestamp to fetch data for. Must be in format 2024-01-24T18:00:00Z, where time matches an available production. See
for available files. They are produced every 3rd hour.
Example: --datetime="2024-01-24T18:00:00Z"
--file FILE Local grib file to read data from. Default will fetch file from API.
--base_url BASE_URL Base URL for API, with a trailing slash. Default is http://localhost:5000/
--bind_host BIND_HOST
Which host to bind to. Default is 127.0.0.1. Use 0.0.0.0 when running in container.
--api_url API_URL URL to download grib file from. Default is .
--data_path DATA_PATH
Where to store data files. Default is ./data
```
### Use it for production
This is only ment for learning. Use as noted in [Testing it out](#test-it-out).
## Overview of architecture
- [C4 diagram](docs/C4.md)
## Documentation
- Based on Pydantic EDR- and covjson-libraries by [KNMI](https://github.com/KNMI/)
- This app will not download _new_ data unless restarted.
- [Sample output](docs/Output.md)
### Testing
This project is heavily tested to serve as an example for API developers and of [sedr](https://github.com/metno/sedr).
- This API is tested on commit to internal [gitlab](https://gitlab.met.no/team-punkt/hydra/lekestue/edrisobaric/-/blob/main/.gitlab-ci.yml)
- This API is tested on commit to public [github](https://gitlab.met.no/team-punkt/hydra/lekestue/edrisobaric/-/blob/main/.github/workflows/tests.yml?ref_type=heads)
- To run tests use `uv tool run tox`.
### Other APIs for comparison
-
-
-
-
### References and acknowledgements
- Icon from [freepik.com](https://www.freepik.com/icon/pressure_9189764#fromView=search&term=air+preassure&track=ais&page=1&position=49&uuid=c5d25f23-4efd-4063-b6ec-2ab35db07d62)
-
-
## How to contribute
- Issues
## Templates
- This document is based on the [Met-norway-readme](https://gitlab.met.no/maler/met-norway-readme)-template.
- Gitlab-ci is based on [team-punkt gitlab-ci](https://gitlab.met.no/team-punkt/gitlab-ci/config)