https://github.com/ECCC-CCCS/geomet-climate
Geospatial web services for Canadian climate data
https://github.com/ECCC-CCCS/geomet-climate
ahccd cangrd cansips climate cmip5 downscale
Last synced: 12 months ago
JSON representation
Geospatial web services for Canadian climate data
- Host: GitHub
- URL: https://github.com/ECCC-CCCS/geomet-climate
- Owner: ECCC-CCCS
- License: gpl-3.0
- Created: 2018-06-27T14:33:31.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-07-11T10:18:09.000Z (12 months ago)
- Last Synced: 2025-07-14T05:05:58.585Z (12 months ago)
- Topics: ahccd, cangrd, cansips, climate, cmip5, downscale
- Language: Python
- Homepage: https://climate-change.canada.ca/climate-data
- Size: 4.5 MB
- Stars: 24
- Watchers: 7
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- open-sustainable-technology - geomet-climate - Geospatial web services for Canadian climate data. (Climate Change / Climate Data Processing and Analysis)
README
# geomet-climate
[](https://github.com/ECCC-CCCS/geomet-climate/actions)
## Overview
geomet-climate provides the MapServer setup and configuration for deployment
of MSC GeoMet climate service data OGC Web Services.
## Installation
### Dependencies
- Python MapScript
- GDAL Python bindings
### Requirements
- Python 3
- [virtualenv](https://virtualenv.pypa.io/)
### Dependencies
Dependencies are listed in [requirements.txt](requirements.txt). Dependencies
are automatically installed during installation.
### Installing geomet-climate
```bash
# install system wide packages
sudo apt-get install python-mapscript python-gdal
# setup virtualenv
virtualenv geomet-climate
cd geomet-climate
. bin/activate
# clone codebase and install
git clone https://github.com/ECCC-CCCS/geomet-climate.git
cd geomet-climate
pip3 install -r requirements.txt
pip3 install -r requirements-dev.txt
pip3 install -e .
# configure environment
vi geomet-climate.env # edit paths accordingly
. geomet-climate.env
```
## Running
```bash
# help
geomet-climate --help
# get version
geomet-climate --version
# generate VRTs for all layers
geomet-climate vrt generate
# generate VRTs for single layer
geomet-climate vrt generate --layer=CMIP5.SND.RCP26.FALL.ANO_PCTL50
# generate tileindex for all layers
geomet-climate tileindex generate
# generate tileindex for single layer
geomet-climate tileindex generate --layer=CMIP5.SND.RCP26.FALL.ANO_PCTL50
# generate legends for all layers
geomet-climate legend generate
# generate mapfile for WMS
geomet-climate mapfile generate --service=WMS
# generate mapfile for WMS with specific configuration for single layer
geomet-climate mapfile generate --service=WMS --layer=CMIP5.SND.RCP26.FALL.ANO_PCTL50
# generate mapfile for WCS
geomet-climate mapfile generate --service=WCS
# run server
geomet-climate serve # server runs on port 8099
# run server on a different port
geomet-climate serve --port=8011
# cache WMS and WCS Capabilities URLs
mapserv -nh QUERY_STRING="map=$GEOMET_CLIMATE_BASEDIR/mapfile/geomet-climate-WMS-en.map&service=WMS&version=1.3.0&request=GetCapabilities" > $GEOMET_CLIMATE_BASEDIR/geomet-climate-WMS-1.3.0-capabilities-en.xml && mv -f $GEOMET_CLIMATE_BASEDIR/geomet-climate-WMS-1.3.0-capabilities-en.xml $GEOMET_CLIMATE_BASEDIR/mapfile
mapserv -nh QUERY_STRING="map=$GEOMET_CLIMATE_BASEDIR/mapfile/geomet-climate-WMS-fr.map&lang=fr&service=WMS&version=1.3.0&request=GetCapabilities" > $GEOMET_CLIMATE_BASEDIR/geomet-climate-WMS-1.3.0-capabilities-fr.xml && mv -f $GEOMET_CLIMATE_BASEDIR/geomet-climate-WMS-1.3.0-capabilities-fr.xml $GEOMET_CLIMATE_BASEDIR/mapfile
mapserv -nh QUERY_STRING="map=$GEOMET_CLIMATE_BASEDIR/mapfile/geomet-climate-WCS-en.map&service=WCS&version=2.1.0&request=GetCapabilities" > $GEOMET_CLIMATE_BASEDIR/geomet-climate-WCS-2.0.1-capabilities-en.xml && mv -f $GEOMET_CLIMATE_BASEDIR/geomet-climate-WCS-2.0.1-capabilities-en.xml $GEOMET_CLIMATE_BASEDIR/mapfile
mapserv -nh QUERY_STRING="map=$GEOMET_CLIMATE_BASEDIR/mapfile/geomet-climate-WCS-fr.map&lang=fr&service=WCS&version=2.1.0&request=GetCapabilities" > $GEOMET_CLIMATE_BASEDIR/geomet-climate-WCS-2.0.1-capabilities-fr.xml && mv -f $GEOMET_CLIMATE_BASEDIR/geomet-climate-WCS-2.0.1-capabilities-fr.xml $GEOMET_CLIMATE_BASEDIR/mapfile
```
## Development
### Running Tests
```bash
. tests/geomet-climate-test.env
python3 setup.py test
```
### Cleaning the build of artifacts
```bash
python3 setup.py cleanbuild
```
## Releasing
```bash
python3 setup.py sdist bdist_wheel --universal
twine upload dist/*
```
### Code Conventions
* [PEP8](https://www.python.org/dev/peps/pep-0008)
### Bugs and Issues
All bugs, enhancements and issues are managed on [GitHub](https://github.com/ECCC-CCCS/geomet-climate).
## Contact
* [Tom Kralidis](https://github.com/tomkralidis)