Skip to main content

EOF analysis in Python

Project description

eofs - EOF analysis in Python

Build Status DOI (paper) DOI (latest release)


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.


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 is available online. The package docstrings are also very complete and can be used as a source of reference when working interactively.


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).


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


pip install eofs

You can also install from the source distribution:

python 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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eofs-1.4.1.tar.gz (1.0 MB view hashes)

Uploaded source

Built Distribution

eofs-1.4.1-py3-none-any.whl (1.1 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page