Skip to content

ajdawson/eofs

Repository files navigation

eofs - EOF analysis in Python

Build Status DOI (paper) DOI (latest release)

Overview

eofs is a Python package for performing empirical orthogonal function (EOF) analysis on spatial-temporal data sets, licensed under the GNU GPLv3.

The package was created to simplify the process of EOF analysis in the Python environment. Some of the key features are listed below:

  • Suitable for large data sets: computationally efficient for the large data sets typical of modern climate model output.
  • Transparent handling of missing values: missing values are removed automatically when computing EOFs and re-inserted into output fields.
  • Meta-data preserving interfaces (optional): works with the iris data analysis package, xarray, or the cdms2 module (from UV-CDAT) to carry meta-data over from input fields to output.
  • No Fortran dependencies: written in Python using the power of NumPy, no compilers required.

Requirements

eofs only requires the NumPy package (and setuptools to install). In order to use the meta-data preserving interfaces one (or more) of cdms2 (part of UV-CDAT), iris, or xarray is needed.

Documentation

Documentation is available online. The package docstrings are also very complete and can be used as a source of reference when working interactively.

Citation

If you use eofs in published research, please cite it by referencing the peer-reviewed paper. You can additionally cite the Zenodo DOI if you need to cite a particular version (but please also cite the paper, it helps me justify my time working on this and similar projects).

Installation

eofs works on Python 2 or 3 on Linux, Windows or OSX. The easiest way to install eofs is by using conda or pip:

conda install -c conda-forge eofs

or

pip install eofs

You can also install from the source distribution:

python setup.py install

Frequently asked questions

  • Do I need UV-CDAT/cdms2, iris or xarray to use eofs? No. All the computation code uses NumPy only. The cdms2 module, iris and xarray are only required for the meta-data preserving interfaces.