A Python package for paleoclimate data analysis

Paleoclimate, Data, Analysis, LiPD
pip install pyleoclim==0.5.1


PyPI version PyPI license DOI NSF-1541029 Build Status


Python Package for the Analysis of Paleoclimate Data

Pyleoclim is a Python package primarily geared towards the analysis and visualization of paleoclimate data. Such data often come in the form of timeseries with missing values and age uncertainties, so the package includes several low-level methods to deal with these issues, as well as high-level methods that re-use those within scientific workflows.

High-level modules assume that data are stored in the Linked Paleo Data (LiPD) format and makes extensive use of the LiPD utilities. Low-level modules are primarily based on NumPy arrays or Pandas dataframes, so Pyleoclim contains a lot of timeseries analysis code (e.g. spectral analysis, singular spectrum analysis, wavelet analysis, correlation analysis) that can apply to these more common types as well. See the example folder for details.

The package is aware of age ensembles stored via LiPD and uses them for time-uncertain analyses very much like GeoChronR.

New in version 0.5.0:

  • code design centered on timeseries objects
  • user interface allowing succinct, expressive calls
  • expanded repertoire of spectral and wavelet methods
  • inclusion of singular spectral analysis, permitting missing data
  • Sphinx documentation for all functions
  • clean, additive plot styles inspired by Matplotlib style sheets.


Online documentation is available through readthedocs:


pyleoclim supports Python 3.8


The latest stable release is available through Pypi. We recommend using Anaconda or Miniconda with a dedicated environment.

pip install pyleoclim

You may also want to use the Development version from GitHub to access the latest functionalities



Pyleoclim development takes place on GitHub: https://github.com/LinkedEarth/Pyleoclim_util

Please submit any reproducible bugs you encounter to the issue tracker


The project is licensed under the GNU Public License. Please refer to the file call license. If you use the code in publications, please credit the work using this citation.


This material is based upon work supported by the National Science Foundation under Grant Number ICER-1541029. Any opinions, findings, and conclusions or recommendations expressed in this material are those of the investigators and do not necessarily reflect the views of the National Science Foundation.

This research is funded in part by JP Morgan Chase & Co. Any views or opinions expressed herein are solely those of the authors listed, and may differ from the views and opinions expressed by JP Morgan Chase & Co. or its affilitates. This material is not a product of the Research Department of J.P. Morgan Securities LLC. This material should not be construed as an individual recommendation of for any particular client and is not intended as a recommendation of particular securities, financial instruments or strategies for a particular client. This material does not constitute a solicitation or offer in any jurisdiction.