Skip to content

Commit

Permalink
Update readme (#52)
Browse files Browse the repository at this point in the history
  • Loading branch information
mpiannucci committed Dec 15, 2023
1 parent 97cb0b1 commit e818737
Showing 1 changed file with 13 additions and 13 deletions.
26 changes: 13 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
## xpublish-wms
# xpublish-wms

[![PyPI](https://img.shields.io/pypi/v/xpublish-wms)](https://pypi.org/project/xpublish-wms/)
[![Conda Version](https://img.shields.io/conda/vn/conda-forge/xpublish-wms.svg)](https://anaconda.org/conda-forge/xpublish-wms)
Expand All @@ -8,11 +8,7 @@

[Xpublish](https://xpublish.readthedocs.io/en/latest/) routers for the [OGC WMS API](https://www.ogc.org/standards/wms).

### Documentation and code

*Coming soon*

### Installation
## Installation

For `conda` users you can

Expand All @@ -28,16 +24,20 @@ pip install xpublish_wms

Once it's installed, the plugin will register itself with Xpublish and WMS endpoints will be included for each dataset on the server.

### Dataset Requirements
## Dataset Requirements

At this time, only a subset of xarray datasets will work out of the box with this plugin. To be compatible, a dataset must contain CF compliant coordinate variables for `lat`, `lon`, `time`, and `vertical`. `time` and `vertical` are optional.

At this time, only a subset of xarray datasets will work out of the box with this plugin. To be compatible, a dataset must have:
Currently the following grid/model types are supported:
- Regularly spaced lat/lon grids (Tested with GFS, GFS Wave models)
- Curvilinear grids (Tested with ROMS models CBOFS, DBOFS, TBOFS, WCOFS, GOMOFS, and CIOFS models)
- FVCOM grids (Tested with LOOFS, LSOFS, LMHOFS, and NGOFS2 models)
- SELFE grids (Tested with CREOFS model)
- 2d Non Dimensional grids (Tested with RTOFS, HRRR-Conus models)

- CF Compliant `latitude` and `longitude` coordinates
- One of:
- `latitude` and `longitude` dimensions that correspond to the CF compliant coordinates
- CF compliant SGRID metadata (`topology`)
### Supporting new grid/model types

Currently only regularly spaced lat/lng grids and SGRID grids are supported. If a datasets meets these requirements and does not work, please file an [issue](https://github.com/xpublish-community/xpublish-wms/issues). Pull requests to support other grid systems are encouraged!
If you have a dataset that is not supported, you can add support by creating a new `xpublish_wms.Grid` subclass and registering it with the `xpublish_wms.register_grid_impl` function. See the [xpublish_wms.grids](/xpublish_wms/grid.py) module for examples.

## Get in touch

Expand Down

0 comments on commit e818737

Please sign in to comment.