Installation

Installation#

We define here two types of installation:

We recommend users and contributors to first set up a virtual environment where to install TStore.

Virtual environment creation#

While not mandatory, utilizing a virtual environment when installing TStore is recommended.

Using a virtual environment for installing packages provides isolation of dependencies, easier package management, easier maintenance, improved security, and improved development workflow.

Here below we provide two options to set up a virtual environment, using venv or conda (recommended).

With conda:

  • Install miniconda or anaconda if you don’t have it already installed.

  • Create the tstore-py311 (or any other custom name) conda environment:

conda create --name tstore-py311 python=3.11 --no-default-packages

  • Activate the tstore-py311 conda environment:

conda activate tstore-py311

With venv:

  • Windows: Create a virtual environment with venv:

python -m venv tstore-pyXXX
cd tstore-pyXXX/Scripts
activate

  • Mac/Linux: Create a virtual environment with venv:

virtualenv -p python3 tstore-pyXXX
source tstore-pyXXX/bin/activate

Installation for standard users#

The latest TStore stable version is available on the Python Packaging Index (PyPI) and on the conda-forge channel.

Therefore you can either install the package with pip or conda. Installation with conda is recommended, as TStore depends on cartopy and GEOS libraries, which can be difficult to install with pip.

Please install the package in the virtual environment you created before !

With conda:

conda install -c conda-forge ts-store

To unlock the full functionalities offered by TStore, we recommend to already install the following packages:

conda install -c conda-forge polars geopandas jupyter spyder

Note

In alternative to conda, if you are looking for a lightweight package manager you could use micromamba.

With pip:

On Linux, prior to the installation of TStore, you can install GEOS using your package manager (e.g. apt install libgeos-dev). Then, install TStore with:

pip install ts-store

Installation for contributors#

The latest TStore version is available on the GitHub repository tstore. You can install the package in editable mode, so that you can modify the code and see the changes immediately. Here below we provide the steps to install the package in editable mode.

Clone the repository from GitHub#

According to the contributors guidelines, you should first create a fork into your personal GitHub account.

Then create a local copy of the repository you forked with:

git clone https://github.com/<your-account>/tstore.git
cd tstore

Create the development environment#

We recommend to create a dedicated conda environment for development purposes. You can create a conda environment (i.e. with python 3.11) with:

conda create --name tstore-dev-py311 python=3.11 --no-default-packages
conda activate tstore-dev-py311

Install the package dependencies#

conda install --only-deps ts-store

Install the package in editable mode#

Install the TStore package in editable mode by executing the following command in the TStore repository’s root:

pip install -e ".[dev]"

Install code quality checks#

Install the pre-commit hook by executing the following command in the TStore repository’s root:

pre-commit install

Pre-commit hooks are automated scripts that run during each commit to detect basic code quality issues. If a hook identifies an issue (signified by the pre-commit script exiting with a non-zero status), it halts the commit process and displays the error messages.

Note

The versions of the software used in the pre-commit hooks is specified in the .pre-commit-config.yaml file. This file serves as a configuration guide, ensuring that the hooks are executed with the correct versions of each tool, thereby maintaining consistency and reliability in the code quality checks.

Further details about pre-commit hooks can be found in the Contributors Guidelines, specifically in the provided in the Code quality control section.

Run TStore on Jupyter Notebooks#

If you want to run TStore on a Jupyter Notebook, you have to take care to set up the IPython kernel environment where TStore is installed.

For example, if your conda/virtual environment is named tstore-dev, run:

python -m ipykernel install --user --name=tstore-dev

When you will use the Jupyter Notebook, by clicking on Kernel and then Change Kernel, you will be able to select the tstore-dev kernel.

Contents