<!---[](https://pypi.python.org/pypi/Pyleoclim)-->
[](https://badge.fury.io/py/pyleoclim)
[]()
[]()
[](https://doi.org/10.5281/zenodo.6999279)
[](https://nsf.gov/awardsearch/showAward?AWD_ID=1541029)
**Python Package for the Analysis of Paleoclimate Data**
[Paleoclimate](https://www.ncdc.noaa.gov/news/what-paleoclimatology) data, whether from observations or model simulations, offer unique challenges to the analyst, as they usually come in the form of timeseries with missing values and age uncertainties, which trip up off-the-shelf methods.
Pyleoclim is a Python package primarily geared towards the analysis and visualization of such timeseries. The package includes several low-level methods to deal with these issues under the hood, leaving paleoscientists to interact with intuitive, high-level analysis and plotting methods that support publication-quality scientific workflows.
There are many entry points to Pyleoclim, thanks to its underlying [data structures](https://pyleoclim-util.readthedocs.io/en/latest/core/api.html). The package leverages the Linked Paleo Data ([LiPD](http://www.clim-past.net/12/1093/2016/)) standard container and its associated [utilities](https://pylipd.readthedocs.io/en/latest/). The package is aware of age ensembles stored via LiPD and uses them for time-uncertain analyses, very much like its R sidekick, [GeoChronR](https://doi.org/10.5194/gchron-2020-25).
LiPD is not an obligatory entry point to Pyleoclim. Low-level modules work on [NumPy](http://www.numpy.org) arrays or [Pandas](https://pandas.pydata.org) dataframes, so most Pyleoclim timeseries analysis functionalities can apply to these more common types as well, including those generated by numerical models (via [xarray](http://xarray.pydata.org)). This makes the package suitable for rigorous and efficient model-data comparisons, like [this one](https://www.pnas.org/content/116/18/8728.short).
We've worked hard to make Pyleoclim accessible to a wide variety of users, from establisher researchers to high-school students, and from seasoned Pythonistas to first-time programmers. A progressive introduction to the package is available at [PyleoTutorials](http://linked.earth/PyleoTutorials/). Examples of scientific use are given [this paper](https://doi.org/10.1029/2022PA004509). A growing collection of research-grade workflows using Pyleoclim and the LinkedEarth research ecosystem are available as Jupyter notebooks on [paleoBooks](https://github.com/LinkedEarth/PaleoBooks/tree/master/notebooks), with video tutorials on the LinkedEarth [YouTube channel](https://www.youtube.com/watch?v=LJaQBFMK2-Q&list=PL93NbaRnKAuF4WpIQf-4y_U4lo-GqcrcW). Python novices are encouraged to follow these [self-paced tutorials](http://linked.earth/ec_workshops_py/) before trying Pyleoclim.
Science-based training materials are also available from the [paleoHackathon repository](https://github.com/LinkedEarth/paleoHackathon). You can run these training notebooks at any time on our [research hub](http://linked.earth/research_hub.html). We also run live training workshops every so often. Follow us on [Twitter](https://twitter.com/Linked_Earth), or join our [Discourse Forum](https://discourse.linked.earth) for more information.
### Versions
See our [releases page](https://github.com/LinkedEarth/Pyleoclim_util/releases) for details on what's included in each version.
### Documentation
Online documentation is available through [readthedocs](https://pyleoclim-util.readthedocs.io/en/latest/).
### Dependencies
pyleoclim **only** supports Python 3.9, 3.10
### Installation
The latest stable release is available through Pypi. We recommend using Anaconda or Miniconda with a dedicated environment. Full installation instructions are available in the [package documentation](https://pyleoclim-util.readthedocs.io/en/latest/installation.html)
## Citation
If you use our code in any way, please consider adding these citations to your publications:
- Khider, D., Emile-Geay, J., Zhu, F., James, A., Landers, J., Ratnakar, V., & Gil, Y. (2022). Pyleoclim: Paleoclimate timeseries analysis and visualization with Python. Paleoceanography and Paleoclimatology, 37, e2022PA004509. https://doi.org/10.1029/2022PA004509
- Khider, Deborah, Emile-Geay, Julien, Zhu, Feng, James, Alexander, Landers, Jordan, Kwan, Myron, & Athreya, Pratheek. (2022). Pyleoclim: A Python package for the analysis and visualization of paleoclimate data (v0.9.1). Zenodo. https://doi.org/10.5281/zenodo.7523617
### Development
Pyleoclim development takes place on GitHub: https://github.com/LinkedEarth/Pyleoclim_util
Please submit any reproducible bugs you encounter to the [issue tracker](https://github.com/LinkedEarth/Pyleoclim_util/issues). For usage questions, please use [Discourse](https://discourse.linked.earth).
### License
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 the citation file.
### Disclaimer
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.
Raw data
{
"_id": null,
"home_page": "https://github.com/LinkedEarth/Pyleoclim_util/pyleoclim",
"name": "pyleoclim",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9.0",
"maintainer_email": "",
"keywords": "Paleoclimate, Data Analysis, LiPD",
"author": "Deborah Khider, Feng Zhu, Julien Emile-Geay, Jun Hu, Myron Kwan, Pratheek Athreya, Alexander James, Daniel Garijo",
"author_email": "linkedearth@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/06/53/8ae9e40ba0a2f7240b6343085c0b00d6cac25398af3636f92783693ed59b/pyleoclim-0.13.0.tar.gz",
"platform": null,
"description": "<!---[](https://pypi.python.org/pypi/Pyleoclim)-->\n[](https://badge.fury.io/py/pyleoclim)\n[]()\n[]()\n[](https://doi.org/10.5281/zenodo.6999279)\n[](https://nsf.gov/awardsearch/showAward?AWD_ID=1541029)\n\n\n\n**Python Package for the Analysis of Paleoclimate Data**\n\n[Paleoclimate](https://www.ncdc.noaa.gov/news/what-paleoclimatology) data, whether from observations or model simulations, offer unique challenges to the analyst, as they usually come in the form of timeseries with missing values and age uncertainties, which trip up off-the-shelf methods.\nPyleoclim is a Python package primarily geared towards the analysis and visualization of such timeseries. The package includes several low-level methods to deal with these issues under the hood, leaving paleoscientists to interact with intuitive, high-level analysis and plotting methods that support publication-quality scientific workflows.\n\nThere are many entry points to Pyleoclim, thanks to its underlying [data structures](https://pyleoclim-util.readthedocs.io/en/latest/core/api.html). The package leverages the Linked Paleo Data ([LiPD](http://www.clim-past.net/12/1093/2016/)) standard container and its associated [utilities](https://pylipd.readthedocs.io/en/latest/). The package is aware of age ensembles stored via LiPD and uses them for time-uncertain analyses, very much like its R sidekick, [GeoChronR](https://doi.org/10.5194/gchron-2020-25).\n\nLiPD is not an obligatory entry point to Pyleoclim. Low-level modules work on [NumPy](http://www.numpy.org) arrays or [Pandas](https://pandas.pydata.org) dataframes, so most Pyleoclim timeseries analysis functionalities can apply to these more common types as well, including those generated by numerical models (via [xarray](http://xarray.pydata.org)). This makes the package suitable for rigorous and efficient model-data comparisons, like [this one](https://www.pnas.org/content/116/18/8728.short).\n\nWe've worked hard to make Pyleoclim accessible to a wide variety of users, from establisher researchers to high-school students, and from seasoned Pythonistas to first-time programmers. A progressive introduction to the package is available at [PyleoTutorials](http://linked.earth/PyleoTutorials/). Examples of scientific use are given [this paper](https://doi.org/10.1029/2022PA004509). A growing collection of research-grade workflows using Pyleoclim and the LinkedEarth research ecosystem are available as Jupyter notebooks on [paleoBooks](https://github.com/LinkedEarth/PaleoBooks/tree/master/notebooks), with video tutorials on the LinkedEarth [YouTube channel](https://www.youtube.com/watch?v=LJaQBFMK2-Q&list=PL93NbaRnKAuF4WpIQf-4y_U4lo-GqcrcW). Python novices are encouraged to follow these [self-paced tutorials](http://linked.earth/ec_workshops_py/) before trying Pyleoclim.\n\nScience-based training materials are also available from the [paleoHackathon repository](https://github.com/LinkedEarth/paleoHackathon). You can run these training notebooks at any time on our [research hub](http://linked.earth/research_hub.html). We also run live training workshops every so often. Follow us on [Twitter](https://twitter.com/Linked_Earth), or join our [Discourse Forum](https://discourse.linked.earth) for more information.\n\n### Versions\n\nSee our [releases page](https://github.com/LinkedEarth/Pyleoclim_util/releases) for details on what's included in each version.\n\n### Documentation\n\nOnline documentation is available through [readthedocs](https://pyleoclim-util.readthedocs.io/en/latest/).\n\n### Dependencies\n\npyleoclim **only** supports Python 3.9, 3.10\n\n### Installation\n\nThe latest stable release is available through Pypi. We recommend using Anaconda or Miniconda with a dedicated environment. Full installation instructions are available in the [package documentation](https://pyleoclim-util.readthedocs.io/en/latest/installation.html)\n\n## Citation\nIf you use our code in any way, please consider adding these citations to your publications:\n\n- Khider, D., Emile-Geay, J., Zhu, F., James, A., Landers, J., Ratnakar, V., & Gil, Y. (2022). Pyleoclim: Paleoclimate timeseries analysis and visualization with Python. Paleoceanography and Paleoclimatology, 37, e2022PA004509. https://doi.org/10.1029/2022PA004509\n- Khider, Deborah, Emile-Geay, Julien, Zhu, Feng, James, Alexander, Landers, Jordan, Kwan, Myron, & Athreya, Pratheek. (2022). Pyleoclim: A Python package for the analysis and visualization of paleoclimate data (v0.9.1). Zenodo. https://doi.org/10.5281/zenodo.7523617\n\n### Development\n\nPyleoclim development takes place on GitHub: https://github.com/LinkedEarth/Pyleoclim_util\n\nPlease submit any reproducible bugs you encounter to the [issue tracker](https://github.com/LinkedEarth/Pyleoclim_util/issues). For usage questions, please use [Discourse](https://discourse.linked.earth).\n\n\n### License\n\nThe project is licensed under the GNU Public License. Please refer to the file call license.\nIf you use the code in publications, please credit the work using the citation file.\n\n\n### Disclaimer\n\nThis 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.\n\nThis 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.\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0 License",
"summary": "A Python package for paleoclimate data analysis",
"version": "0.13.0",
"project_urls": {
"Download": "https://github.com/LinkedEarth/Pyleoclim_util/tarball/0.13.0",
"Homepage": "https://github.com/LinkedEarth/Pyleoclim_util/pyleoclim"
},
"split_keywords": [
"paleoclimate",
" data analysis",
" lipd"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "53f6e734aa4e0f59aa34a87318a1fdad2fd602e3637f616d631f78a1e3ec50e4",
"md5": "e7f1bf358d6378891acf5433eaff6df3",
"sha256": "688002007433e5a2e0af0daaa5bafa0e736a2f867d1706afff3a0a46f2617d5c"
},
"downloads": -1,
"filename": "pyleoclim-0.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e7f1bf358d6378891acf5433eaff6df3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9.0",
"size": 585990,
"upload_time": "2023-06-18T03:05:43",
"upload_time_iso_8601": "2023-06-18T03:05:43.634926Z",
"url": "https://files.pythonhosted.org/packages/53/f6/e734aa4e0f59aa34a87318a1fdad2fd602e3637f616d631f78a1e3ec50e4/pyleoclim-0.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "06538ae9e40ba0a2f7240b6343085c0b00d6cac25398af3636f92783693ed59b",
"md5": "125bbfee1870111366fcc55bd84d527d",
"sha256": "6d2bfe6ddba90e7451d343938f4fa26afaa24a108235c8520061e5df217aaed9"
},
"downloads": -1,
"filename": "pyleoclim-0.13.0.tar.gz",
"has_sig": false,
"md5_digest": "125bbfee1870111366fcc55bd84d527d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9.0",
"size": 557605,
"upload_time": "2023-06-18T03:05:45",
"upload_time_iso_8601": "2023-06-18T03:05:45.411968Z",
"url": "https://files.pythonhosted.org/packages/06/53/8ae9e40ba0a2f7240b6343085c0b00d6cac25398af3636f92783693ed59b/pyleoclim-0.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-18 03:05:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "LinkedEarth",
"github_project": "Pyleoclim_util",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "IPython",
"specs": []
},
{
"name": "pytest",
"specs": []
}
],
"lcname": "pyleoclim"
}
JSON
