pypsdm

pypsdm aims to make power system model analysis a breeze. It is based upon the Power System Data Model (PSDM).

Its main functionalities include:

• parsing grid models and associated result data
• calculation utilities for event discrete time series data
• plotting capabilities for grid and result data

It is currently under development. So if you want to use it, expect it to change quite frequently for now.

Installation

To add the project as dependency run

pip install pypsdm

or

poetry add pypsdm

depending on your depedency management system.

If you want to clone and explore the repository locally, run

poetry install 

inside the repository root folder. For more information about poetry, refer to their documentation.

Documentation

Please refer to:

• docs/nbs/input_models.ipynb
• docs/nbs/result_models.ipynb
• docs/nbs/plotting_utilities.ipynb

to see exemplary notebooks outlining some of the basic functionalities.

Quickstart:

You can read grid models via

from pypsdm.models.gwr import GridWithResults

grid_path = "/path/to/my/psdm/grid"
result_path = "/path/to/my/psdm/results"

gwr = GridWithResults.from_csv(grid_path, result_path)

If you only want to read the grid model without the results

# All relevant input models can be imported from `pypsdm/models/input`
from pypsdm.models.input import GridContainer

grid_path = "/path/to/my/psdm/grid"
grid = GridContainer.from_csv(grid_path)

If you only want to read the results without the grid model

# All relevant result models can be imported from `pypsdm/models/result`
from pypsdm.models.results import GridResultContainer

result_path = "/path/to/my/psdm/results"
results = GridResultContainer.from_csv(result_path)

Known Issues

• When adding the project as a dependency the language server of the code editors do not suggest autoimports for all symbols of the project, which means they have to be imported manually. It might have something to do with how poetry publishes the artifacts. If you have an idea what the issue could be any tipps are welcome.