Installation

Note

pypsa2smspp is a Python package under active development and current documentation aims to facilitate development of the package. Currently, there is not yet a stable release of the package on PyPI or Conda, so the installation can be performed by cloning the repository and installing the package locally.

Python

To use pypsa2smspp we highly recommend to use a package manager such as conda, mamba or pip as easy-to-use package managers, available for Windows, Mac OS X and GNU/Linux.

As common practice, it is highly recommend to use dedicated conda/mamba environments or virtual environments to ensure proper dependency management and isolation.

Adoption of conda environments

If you are using conda, you can create a new environment with:

conda create -n pypsa2smspp python=3.13 pip

This will create a new environment named pypsa2smspp with Python 3.13 and pip package manager installed.

If you prefer mamba, please execute the same command with mamba instead of conda. For alternative package managers, please refer to their respective documentation.

Clone the package

To clone the package, you can use the following command:

cd /path/to/your/folder
git clone https://github.com/SPSUnipi/pypsa2smspp

This will create a new folder named pypsa2smspp in the directory /path/to/your/folder

Installing with pip

You can now install the package locally using pip:

cd /path/to/your/folder/pypsa2smspp
pip install .

If you aim to develop the package, we recommend to install the package in editable mode (option -e), install the development dependencies (option [dev]), and install the pre-commit to ensure code quality:

pip install -e .[dev]
pre-commit install

Getting SMS++

To use pypsa2smspp, you need to have SMS++ installed on your system. You can install the latest version of SMS++ from the official SMS++ website.