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.

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

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 ajdawson eofs

or

pip install eofs

You can also install from the source distribution:

python setup.py install