Skip to content

ltelab/tstore

Repository files navigation

📦 Welcome to TStore

Deployment PyPI Conda
Activity PyPI Downloads Conda Downloads
Python Versions Python Versions
Supported Systems Linux macOS Windows
Project Status Project Status
Build Status Tests Docs
Linting Black Ruff Codespell pre-commit.ci status
Code Coverage Coveralls Codecov
Code Quality Codefactor Codebeat Codacy Codescene
License License
Community Slack GitHub Discussions
Citation DOI

Slack | Docs

🚀 Quick start

tstore is a library for flexible storage and processing of time series data.

✨ Features

  • TStore: hierarchically-structured specification to efficiently store geospatial time series data based on Apache Parquet and GeoParquet.
  • TSDF: tabular Python object to store univariate and multivariate time series data, with support for pandas, dask and polars.

See the key concepts page of the documentation for more details of the background and tstore features.


📖 Explore the TStore documentation

To discover all TStore download, manipulation, analysis and plotting utilities, or how to contribute your custom retrieval to TStore:

🛠️ Installation

conda

TStore can be installed via conda on Linux, Mac, and Windows. Install the package by typing the following command in the terminal:

conda install ts-store

In case conda-forge is not set up for your system yet, see the easy to follow instructions on conda-forge.

pip

TStore can be installed also via pip on Linux, Mac, and Windows. On Windows you can install WinPython to get Python and pip running.

Install the TStore package by typing the following command in the terminal:

pip install ts-store

To install the latest development version via pip, see the documentation.

💭 Feedback and Contributing Guidelines

If you aim to contribute your data or discuss the future development of TStore, we highly suggest to join the TStore Slack Workspace

Feel free to also open a GitHub Issue or a GitHub Discussion specific to your questions or ideas.

Citation

If you are using TStore in your publication please cite our Zenodo repository:

Ghiggi Gionata. ltelab/tstore. Zenodo. https://doi.org/10.5281/zenodo.7753488

If you want to cite a specific software version, have a look at the Zenodo site.

License

The content of this repository is released under the terms of the MIT license.

OUTDATED HERE BELOW

Requirements

Instructions

  1. Create a conda environment:
snakemake -c1 create_environment
  1. Activate it (if using conda, replace mamba for conda):
mamba activate tstore
  1. Register the IPython kernel for Jupyter:
snakemake -c1 register_ipykernel
  1. Activate pre-commit for the git repository:
pre-commit install
pre-commit install --hook-type commit-msg

Acknowledgments