Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ecmwf/metview-python

Python interface to Metview meteorological workstation and batch system
https://github.com/ecmwf/metview-python

Last synced: about 2 months ago
JSON representation

Python interface to Metview meteorological workstation and batch system

Lists

README

        

Metview Python bindings
=======================

Python interface to Metview, a meteorological workstation and batch system for accessing, examining, manipulating and visualising meteorological data.
See documentation at https://metview.readthedocs.io/en/latest/index.html

Try the example notebooks on Binder!
------------------------------------
Click the link below to start a Binder session to try the examples online now:

.. image:: https://mybinder.org/badge_logo.svg
:target: https://mybinder.org/v2/gh/ecmwf/metview-python/master?filepath=examples

Requirements
------------

- A working Metview 5 installation (at least version 5.0.3, ideally 5.3.0 or above), either from binaries or built from source.
Conda packages are available for Linux, and native packages are available for many Linux distributions.
See https://metview.readthedocs.io/en/latest/install.html

- An alternative is to build from the Metview Source Bundle.
See https://confluence.ecmwf.int/metview/The+Metview+Source+Bundle

- Ensure that the command 'metview' will run this version by setting your PATH to include the 'bin' directory
from where you built or installed it if it's not in a default location.

- A Python 3 interpreter (ideally version >= 3.5)

Install
-------

The package is installed from PyPI with::

$ pip install metview

or from conda-forge with::

$ conda install metview-python -c conda-forge

Test
----

You may run a simple selfcheck command to ensure that your system is set up correctly::

$ python -m metview selfcheck
Hello world - printed from Metview!
Trying to connect to a Metview installation...
Metview version 5.2.0 found
Your system is ready.

To manually test that your system is properly setup open a Python 3 interpreter and try::

>>> import metview as mv
>>> mv.lowercase('Hello World!')
'hello world!'

Examples
--------

The [examples](examples) folder contains some Jupyter notebooks and some standalone examples for you to try out!

Project resources
-----------------

============= =========================================================
Development https://github.com/ecmwf/metview-python
Download https://pypi.org/project/metview
Code quality .. image:: https://travis-ci.com/ecmwf/metview-python.svg?branch=master
:target: https://travis-ci.com/ecmwf/metview-python
:alt: Build Status on Travis CI
.. image:: https://coveralls.io/repos/ecmwf/metview-python/badge.svg?branch=master&service=github
:target: https://coveralls.io/github/ecmwf/metview-python
:alt: Coverage Status on Coveralls
============= =========================================================

License
-------

Copyright 2017-2021 European Centre for Medium-Range Weather Forecasts (ECMWF).

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.