Enhanced Python for Graphics and Analysis of Meteorological fields
The epygram library package is a set of Python classes and functions designed to handle meteorological fields in Python, as well as interfacing their storage in various usual (or not) data formats.
EPyGrAM dependencies are available from Pypi (pip install ...), and listed in pyproject.toml.
Some packages are mandatory, others are optional, only necessary for the use of specific functionalities or formats.
Formats for which the import of the according underlying package fails are deactivated at runtime.
pip install epygram
or
pip3 install epygram
To use specific functionalities which dependencies are not covered by default, you may need to manually pip install the according package(s).
To run tests, cf. tests/README.md.
To generate Sphinx doc: make doc. It will be generated in docs/build/html.
Online doc of the latest release on master branch is available at https://umr-cnrm.github.io/EPyGrAM-doc
Some applicative tools in command line are provided and installed by pip.
These tools are available as epy_* (pip should have placed them in your $PATH) and, starting from version 1.6.0,
through a single command line epygram with sub-commands:
- cf.
epygram -hto list available sub-commands - and
epygram <sub-command>for auto-documentation of each tool/sub-command.
Example: to plot a field, epygram cartoplot <file> -f <field> is equivalent to epy_cartoplot <file> -f <field> or epy_cartoplot.py <file> -f <field> in versions prior to 1.6.0.
This software is governed by the open-source CeCILL-C license under French law, cf. LICENSE.txt. Downloading and using this code means that you have had knowledge of the CeCILL-C license and that you accept its terms.