TimeSeriesX

https://img.shields.io/pypi/v/timeseriesx.svg https://travis-ci.com/carlculator/timeseriesx.svg?branch=develop Documentation Status Updates

The eXtended time series library.

Manage time series data with explicit time zone, frequency and unit.

About

TimeSeriesX is motivated by handling time series data in a convenient way. Almost all the features are actually already provided by pandas. TimeSeriesX extends the pandas time series functionality by the unit functionalities of pint and pint-pandas. Further, TimeSeriesX offers an easy and convenient interface to work with time series without the need to dig deep into these libraries, which nevertheless is still recommended, since they go way beyond time series data.

The main challenges that arise when handling time series data are time zones and frequencies. Since time series data is often obtained by measurements, the values are associated with units. Then these units can be confused easily, since the units are often not modeled in code.

TimeSeriesX forces the user to handle time zones, frequencies and units explicitly, while taking care of validation and convenient formats. It also supports deriving these attributes from raw time series data. It offers a limited set of actions on time series that are translated to pandas or pint functionality under the hood. It was designed to guarantee that every transformation of time series data results in a new valid time series, which would require quite some pandas code if done “manually”.

Features

  • model time series data with explicit frequency, time zone and unit

  • convert time zone or unit

  • resample data to new frequency

  • fill and get gaps

  • join time series

  • perform calculations on time series with python standard operators

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.