Welcome to Timeseria reference documentation!

Timeseria is an object-oriented time series processing library which aims at making it easy to manipulate time series data and to build statistical and machine learning models on top of it.

Unlike common numerical and data analysis frameworks, Timeseira does not make use of low level structures as arrays and matrices for representing data. Instead, it builds up from well defined and reusable logical units (objects) which can be easily composed together, ensuring a high level of consistency.

Because of this approach, Timeseria addresses by design all those annoying things which are often left as an implementation detail but that actually cause wasting massive amounts of time - as handling data losses, non-uniform sampling rates, differences between aggregated data and punctual observations, timezones, DST changes, and so on.

Timeseria comes with a built-in set of common operations (resampling, aggregation, differencing etc.) and models (reconstruction, forecasting and anomaly detection) which can be easily extended with custom ones, and integrates a powerful plotting engine based on Dygraphs capable of plotting even millions of data points.

This is the refeerence documentations, and it is quite essential. To get started more gently, you can have a look at the quickstart or at the welcome notebooks.

Examples are provided in the Timeseria-notebooks repository, and a Docker image ready to be played with is available on Docker Hub.


Main modules and submodules

datastructures

Provides base data structures: Points, Slots and Series with all their specializations.

units

Provides Units and TimeUnits (which fully supports calendar arithmetic).

transformations

Series transformations as resampling and aggregation.

storages

Data storages, as the CSV file and SQLite database.

time

Provides time manipulation utilities, with a particular focus on proper timezone and DST handling.

models.base

Provides base model classes.

models.forecasters

Forecasting models.

models.reconstructors

Data reconstructions models.

models.anomaly_detectors

Anomaly detection models.

operations

Operations on the series, returning both scalar and other series.

exceptions

Exceptions.

plots

Plotting utilities.

utilities

Utility functions.


Other resources