Skip to main content

LiPD utilities to process, convert, and analyze data.

Project description

# LiPD Utilities - Python
=========================

|DOI| |PyPI| |PyPI| |license|

Input/output and manipulation utilities for LiPD files in Matlab, R and
Python.

## What is it?
==============

LiPD is short for Linked PaleoData. LiPD is the data standard for
paleoclimatology and the exchange of data amongst paleoclimate experts.
This package will help you convert your existing database of
paleoclimate observations into LiPD files. Moreover, it contains tools
to analyze and manipulate LiPD data.

## Features
===========

- Read & write LiPD files
- Extract & collapse a time series for data analysis
- Filter & query a time series for subset data
- Convert Excel files to LiPD files
- Convert NOAA files to/from LiPD files
- Update LiPD publication data through DOI.org
- Validate LiPD files through lipd.net API

## Requirements
===============

- `Python 3.4+ <https://www.python.org>`__

- Python IDE (Spyder or PyCharm are highly recommended)

- `pip <https://pip.pypa.io/en/stable/installing/>`__

## Installation
===============

Python 3.4 / 3.5

::

pip install LiPD

Python 3.6+

::

pip3 install --egg LiPD

## Usage
========

Using your preferred Python IDE or a Python console, you can import the
LiPD package using:

::

import lipd

Here are the major functions within the package. This is a short
preview. More in-depth examples can found further in the guide (coming
soon):

::

lipd.readExcel(path="")
lipd.readNoaa(path="")
D = lipd.readLipd(path="")
lipd.writeLipd(D, path="")
ts = lipd.extractTs(D, chron=False)
D = lipd.collapseTs(ts)
idx = lipd.queryTs(ts, expression)
new_ts = lipd.filterTs(ts, expression)
D = lipd.excel()
lipd.doi()

## How to Cite this code
========================

Use this link to visit the Zenodo website. It provides citation
information in many popular formats.

## Further information
======================

Github: https://github.com/nickmckay/LiPD-utilities

Linked Earth Wiki: wiki.linked.earth

## Contact
==========

If you are having issues, please let me know. Contact me at
heiser@nau.edu.

## License
==========

The project is licensed under the GNU Public License. Please refer to
the file called LICENSE.

.. |DOI| image:: https://zenodo.org/badge/24036/nickmckay/LiPD-utilities.svg
:target: https://zenodo.org/badge/latestdoi/24036/nickmckay/LiPD-utilities
.. |PyPI| image:: https://img.shields.io/pypi/v/LiPD.svg?maxAge=2592000
:target:
.. |PyPI| image:: https://img.shields.io/badge/python-3.4-yellow.svg
:target:
.. |license| image:: https://img.shields.io/github/license/nickmckay/LiPD-utilities.svg?maxAge=2592000
:target:

Project details


Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
LiPD-0.2.6.1.tar.gz (988.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page