Metadata-Version: 2.5
Name: pyptp
Version: 0.46.0
Summary: Open-source Python SDK for electrical grid calculations and modelling
Author-email: Phase to Phase <pyptp@phasetophase.com>
License: GPL-3.0-or-later
License-File: LICENSE
Keywords: distribution-networks,dso,electrical-engineering,gaia,grid-calculations,low-voltage,medium-voltage,network-modeling,power-systems,vision
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: dataclasses-json<1,>=0.6.7
Requires-Dist: networkx<4,>=3.4.2
Requires-Dist: openpyxl<4,>=3.1.5
Requires-Dist: pydantic-settings<3,>=2.0
Requires-Dist: requests<3,>=2.31.0
Description-Content-Type: text/markdown

# [PyPtP](https://github.com/phasetophase/pyptp)

Open-source Python SDK for electrical grid calculations and modelling.

PyPtP enables Distribution System Operators (DSOs) and developers to integrate with Phase to Phase's electrical network modeling ecosystem. Access electrical network data in the native formats used by Gaia (LV networks) and Vision (MV networks) software.

> **Beta**: The VNF and GNF data models are complete. Our focus now is fixing the remaining bugs and settling a stable interface for the helpers and higher-level functions. Until 1.0, a minor release (0.x.0) can still break the API. Every breaking change is listed in the [release notes](https://github.com/phasetophase/pyptp/releases). Pin a minor version, for example `pyptp~=0.46.0`, if you need a fixed API.
>
> Found a bug, or have an opinion on the helper API? Tell us via [GitHub Issues](https://github.com/phasetophase/pyptp/issues), [Discussions](https://github.com/phasetophase/pyptp/discussions) or [email](mailto:pyptp@phasetophase.com).

## Installation

```bash
pip install pyptp
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uv add pyptp
```

## Documentation

- **Docs**: [pyptp.com](https://pyptp.com) — guides, API reference, and samples
- **Examples**: [`docs/samples/`](docs/samples/) — runnable code snippets

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:

- How to report bugs and request features
- Development setup and coding standards
- Pull request process
- Contributor License Agreement (CLA)

## License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

See [LICENSE](LICENSE) for the full license text.

## Support

- **Issues & Features**: [GitHub Issues](https://github.com/phasetophase/pyptp/issues)
- **Questions**: [GitHub Discussions](https://github.com/phasetophase/pyptp/discussions)
- **Email**: pyptp@phasetophase.com

---

**Developed by [Phase to Phase](https://phasetophase.com)**
