power-grid-model-ds


Namepower-grid-model-ds JSON
Version 1.4.2 PyPI version JSON
download
home_pageNone
SummaryPower Grid Model extension which provides a grid data structure for simulation and analysis
upload_time2025-07-18 10:41:52
maintainerNone
docs_urlNone
authorNone
requires_python<3.14,>=3.11
licenseMPL-2.0
keywords power grid model
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <!--
SPDX-FileCopyrightText: Contributors to the Power Grid Model project <powergridmodel@lfenergy.org>

SPDX-License-Identifier: MPL-2.0
-->

[![PyPI version](https://badge.fury.io/py/power-grid-model-ds.svg?no-cache)](https://badge.fury.io/py/power-grid-model-ds)
[![License: MIT](https://img.shields.io/badge/License-MPL2.0-informational.svg)](https://github.com/PowerGridModel/power-grid-model-ds/blob/main/LICENSE)
[![Downloads](https://static.pepy.tech/badge/power-grid-model-ds)](https://pepy.tech/project/power-grid-model-ds)
[![Downloads](https://static.pepy.tech/badge/power-grid-model-ds/month)](https://pepy.tech/project/power-grid-model-ds)

[![CI Build](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/ci.yml/badge.svg)](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/ci.yml)
[![docs](https://readthedocs.org/projects/power-grid-model-ds/badge/)](https://power-grid-model-ds.readthedocs.io/en/stable/)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=coverage)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)

[![Nightly build](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/nightly.yml/badge.svg)](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/nightly.yml)

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14825565.svg)](https://zenodo.org/record/14825565)

[![Power Grid Model logo](https://github.com/PowerGridModel/.github/blob/main/artwork/svg/color.svg)](#)

# Power Grid Model Data Science (DS)

The Power Grid Model DS project extends the capabilities of the `power-grid-model` calculation core with a modelling and simulation interface. This is aimed at building data science software applications related to or using the power-grid-model project. It defines a `Grid` dataclass which manages the consistency of the complete network.

Some highlighted features:

- Using a model definition that corresponds to the power-grid-model, through
  which it is easy to do efficient grid calculations.
- The extended numpy model provides features which make development more
  pleasant and easy.
- Using the graph representation of the network, graph algorithms in rustworkx
  can be used to analyze the network.
- An interface to model network mutations which is useful in
  simulation use-cases.
- Visualization for easy exploration and debugging.

<img width="40%" alt="Grid Visualisation" src="docs/_static/grid-force-directed.png" />

See the [power-grid-model-ds documentation](https://power-grid-model-ds.readthedocs.io/en/stable/) for more information.

## Installation

### Pip

```
pip install power-grid-model-ds
```

## License

This project is licensed under the Mozilla Public License, version 2.0 - see [LICENSE](https://github.com/PowerGridModel/power-grid-model-ds/blob/main/LICENSE) for details.

## Licenses third-party libraries

This project includes third-party libraries, 
which are licensed under their own respective Open-Source licenses.
SPDX-License-Identifier headers are used to show which license is applicable. 
The concerning license files can be found in the [LICENSES](https://github.com/PowerGridModel/power-grid-model-ds/tree/main/LICENSES) directory.

## Contributing

Please read [CODE_OF_CONDUCT](https://github.com/PowerGridModel/.github/blob/main/CODE_OF_CONDUCT.md) and [CONTRIBUTING](https://github.com/PowerGridModel/.github/blob/main/CONTRIBUTING.md) for details on the process 
for submitting pull requests to us.

## Citations

If you are using Power Grid Model DS in your research work, please consider citing our library using the following references.

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14825565.svg)](https://zenodo.org/record/14825565)

```bibtex
@software{Schouten_PowerGridModel_power-grid-model-ds,
  author = {Schouten, Jaap and Baaijen, Thijs and Koppen, Vincent and van der Voort, Sven and {Contributors to the LF Energy project Power Grid Model}},
  doi = {10.5281/zenodo.14825565},
  license = {MPL-2.0},
  title = {{PowerGridModel/power-grid-model-ds}},
  url = {https://github.com/PowerGridModel/power-grid-model-ds}
}
@software{Xiang_PowerGridModel_power-grid-model,
  author = {Xiang, Yu and Salemink, Peter and van Westering, Werner and Bharambe, Nitish and Govers, Martinus G.H. and van den Bogaard, Jonas and Stoeller, Bram and Wang, Zhen and Guo, Jerry Jinfeng and Figueroa Manrique, Santiago and Jagutis, Laurynas and Wang, Chenguang and van Raalte, Marc and {Contributors to the LF Energy project Power Grid Model}},
  doi = {10.5281/zenodo.8054429},
  license = {MPL-2.0},
  title = {{PowerGridModel/power-grid-model}},
  url = {https://github.com/PowerGridModel/power-grid-model}
}
@inproceedings{Xiang2023,
  author = {Xiang, Yu and Salemink, Peter and Stoeller, Bram and Bharambe, Nitish and van Westering, Werner},
  booktitle={27th International Conference on Electricity Distribution (CIRED 2023)},
  title={Power grid model: a high-performance distribution grid calculation library},
  year={2023},
  volume={2023},
  number={},
  pages={1089-1093},
  keywords={},
  doi={10.1049/icp.2023.0633}
}
```

## Contact

Please read [SUPPORT](https://github.com/PowerGridModel/.github/blob/main/SUPPORT.md) for how to connect and get into contact with the Power Grid Model project.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "power-grid-model-ds",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.14,>=3.11",
    "maintainer_email": null,
    "keywords": "power grid model",
    "author": null,
    "author_email": "Contributors to the Power Grid Model project <powergridmodel@lfenergy.org>",
    "download_url": "https://files.pythonhosted.org/packages/17/07/671295225360dfe7da2f9672ba5bcb0c348393b605384c729b6c84bb34f1/power_grid_model_ds-1.4.2.tar.gz",
    "platform": null,
    "description": "<!--\nSPDX-FileCopyrightText: Contributors to the Power Grid Model project <powergridmodel@lfenergy.org>\n\nSPDX-License-Identifier: MPL-2.0\n-->\n\n[![PyPI version](https://badge.fury.io/py/power-grid-model-ds.svg?no-cache)](https://badge.fury.io/py/power-grid-model-ds)\n[![License: MIT](https://img.shields.io/badge/License-MPL2.0-informational.svg)](https://github.com/PowerGridModel/power-grid-model-ds/blob/main/LICENSE)\n[![Downloads](https://static.pepy.tech/badge/power-grid-model-ds)](https://pepy.tech/project/power-grid-model-ds)\n[![Downloads](https://static.pepy.tech/badge/power-grid-model-ds/month)](https://pepy.tech/project/power-grid-model-ds)\n\n[![CI Build](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/ci.yml/badge.svg)](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/ci.yml)\n[![docs](https://readthedocs.org/projects/power-grid-model-ds/badge/)](https://power-grid-model-ds.readthedocs.io/en/stable/)\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=coverage)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)\n[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)\n[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=PowerGridModel_power-grid-model-ds&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=PowerGridModel_power-grid-model-ds)\n\n[![Nightly build](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/nightly.yml/badge.svg)](https://github.com/PowerGridModel/power-grid-model-ds/actions/workflows/nightly.yml)\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14825565.svg)](https://zenodo.org/record/14825565)\n\n[![Power Grid Model logo](https://github.com/PowerGridModel/.github/blob/main/artwork/svg/color.svg)](#)\n\n# Power Grid Model Data Science (DS)\n\nThe Power Grid Model DS project extends the capabilities of the `power-grid-model` calculation core with a modelling and simulation interface. This is aimed at building data science software applications related to or using the power-grid-model project. It defines a `Grid` dataclass which manages the consistency of the complete network.\n\nSome highlighted features:\n\n- Using a model definition that corresponds to the power-grid-model, through\n  which it is easy to do efficient grid calculations.\n- The extended numpy model provides features which make development more\n  pleasant and easy.\n- Using the graph representation of the network, graph algorithms in rustworkx\n  can be used to analyze the network.\n- An interface to model network mutations which is useful in\n  simulation use-cases.\n- Visualization for easy exploration and debugging.\n\n<img width=\"40%\" alt=\"Grid Visualisation\" src=\"docs/_static/grid-force-directed.png\" />\n\nSee the [power-grid-model-ds documentation](https://power-grid-model-ds.readthedocs.io/en/stable/) for more information.\n\n## Installation\n\n### Pip\n\n```\npip install power-grid-model-ds\n```\n\n## License\n\nThis project is licensed under the Mozilla Public License, version 2.0 - see [LICENSE](https://github.com/PowerGridModel/power-grid-model-ds/blob/main/LICENSE) for details.\n\n## Licenses third-party libraries\n\nThis project includes third-party libraries, \nwhich are licensed under their own respective Open-Source licenses.\nSPDX-License-Identifier headers are used to show which license is applicable. \nThe concerning license files can be found in the [LICENSES](https://github.com/PowerGridModel/power-grid-model-ds/tree/main/LICENSES) directory.\n\n## Contributing\n\nPlease read [CODE_OF_CONDUCT](https://github.com/PowerGridModel/.github/blob/main/CODE_OF_CONDUCT.md) and [CONTRIBUTING](https://github.com/PowerGridModel/.github/blob/main/CONTRIBUTING.md) for details on the process \nfor submitting pull requests to us.\n\n## Citations\n\nIf you are using Power Grid Model DS in your research work, please consider citing our library using the following references.\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14825565.svg)](https://zenodo.org/record/14825565)\n\n```bibtex\n@software{Schouten_PowerGridModel_power-grid-model-ds,\n  author = {Schouten, Jaap and Baaijen, Thijs and Koppen, Vincent and van der Voort, Sven and {Contributors to the LF Energy project Power Grid Model}},\n  doi = {10.5281/zenodo.14825565},\n  license = {MPL-2.0},\n  title = {{PowerGridModel/power-grid-model-ds}},\n  url = {https://github.com/PowerGridModel/power-grid-model-ds}\n}\n@software{Xiang_PowerGridModel_power-grid-model,\n  author = {Xiang, Yu and Salemink, Peter and van Westering, Werner and Bharambe, Nitish and Govers, Martinus G.H. and van den Bogaard, Jonas and Stoeller, Bram and Wang, Zhen and Guo, Jerry Jinfeng and Figueroa Manrique, Santiago and Jagutis, Laurynas and Wang, Chenguang and van Raalte, Marc and {Contributors to the LF Energy project Power Grid Model}},\n  doi = {10.5281/zenodo.8054429},\n  license = {MPL-2.0},\n  title = {{PowerGridModel/power-grid-model}},\n  url = {https://github.com/PowerGridModel/power-grid-model}\n}\n@inproceedings{Xiang2023,\n  author = {Xiang, Yu and Salemink, Peter and Stoeller, Bram and Bharambe, Nitish and van Westering, Werner},\n  booktitle={27th International Conference on Electricity Distribution (CIRED 2023)},\n  title={Power grid model: a high-performance distribution grid calculation library},\n  year={2023},\n  volume={2023},\n  number={},\n  pages={1089-1093},\n  keywords={},\n  doi={10.1049/icp.2023.0633}\n}\n```\n\n## Contact\n\nPlease read [SUPPORT](https://github.com/PowerGridModel/.github/blob/main/SUPPORT.md) for how to connect and get into contact with the Power Grid Model project.\n",
    "bugtrack_url": null,
    "license": "MPL-2.0",
    "summary": "Power Grid Model extension which provides a grid data structure for simulation and analysis",
    "version": "1.4.2",
    "project_urls": {
        "Discussion": "https://github.com/orgs/PowerGridModel/discussions",
        "Documentation": "https://power-grid-model-ds.readthedocs.io/en/stable/",
        "GitHub": "https://github.com/PowerGridModel/power-grid-model-ds",
        "Home-page": "https://lfenergy.org/projects/power-grid-model/",
        "Mailing-list": "https://lists.lfenergy.org/g/powergridmodel"
    },
    "split_keywords": [
        "power",
        "grid",
        "model"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cb118e316d871a6439562196d393e78113c9ec68d9762f634f65523e37d2d482",
                "md5": "a6f2da96a6969f3770ac32f974512753",
                "sha256": "c8239d59e8e3ad4e40557e7f0e1b058587a22a1dd12933ad715f5f0df395cec9"
            },
            "downloads": -1,
            "filename": "power_grid_model_ds-1.4.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a6f2da96a6969f3770ac32f974512753",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.14,>=3.11",
            "size": 79773,
            "upload_time": "2025-07-18T10:41:51",
            "upload_time_iso_8601": "2025-07-18T10:41:51.115914Z",
            "url": "https://files.pythonhosted.org/packages/cb/11/8e316d871a6439562196d393e78113c9ec68d9762f634f65523e37d2d482/power_grid_model_ds-1.4.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1707671295225360dfe7da2f9672ba5bcb0c348393b605384c729b6c84bb34f1",
                "md5": "9191aa4e308c621f2dbf692c1a37d296",
                "sha256": "e7434ef847e60998a47591ec3e11b55867c0acf1986b607f5c60ead351e6b1bc"
            },
            "downloads": -1,
            "filename": "power_grid_model_ds-1.4.2.tar.gz",
            "has_sig": false,
            "md5_digest": "9191aa4e308c621f2dbf692c1a37d296",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.14,>=3.11",
            "size": 54157,
            "upload_time": "2025-07-18T10:41:52",
            "upload_time_iso_8601": "2025-07-18T10:41:52.485513Z",
            "url": "https://files.pythonhosted.org/packages/17/07/671295225360dfe7da2f9672ba5bcb0c348393b605384c729b6c84bb34f1/power_grid_model_ds-1.4.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-18 10:41:52",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "orgs",
    "github_project": "PowerGridModel",
    "github_not_found": true,
    "lcname": "power-grid-model-ds"
}
        
Elapsed time: 1.83135s