Overview

Alpha Status (v0.0.x)

PyPtP is currently in alpha. The library provides full coverage of VNF and GNF data models and we aim for production-quality code, but documentation is still limited and the API may change between releases. We welcome feedback on developer experience, usage patterns, and API design via GitHub Discussions or Issues.

What is PyPtP?

PyPtP provides a Python interface and data model for working with electrical network data programmatically. The library handles serialization to proprietary file formats so you don't need to understand them directly.

Network Types

PyPtP provides two network models, distinguished by their modeling methodology:

Class	Modeling Type	Suitable For	File Format
NetworkMV	Balanced three-phase	All voltage levels (LV, MV, HV)	VNF (Vision)
NetworkLV	Unbalanced nine-conductor	Detailed LV analysis	GNF (Gaia)

The key distinction is how the network is modeled, not what voltage level it represents:

• Balanced modeling (NetworkMV) uses symmetrical three-phase representation with positive/negative/zero sequence analysis. This approach works well across all voltage levels and is computationally efficient.

• Unbalanced modeling (NetworkLV) provides full nine-conductor representation, capturing asymmetrical loads and phase imbalances. This higher-fidelity approach is typically used for detailed low-voltage analysis where phase imbalance matters.

About the Class Names

The names NetworkLV and NetworkMV reflect historical usage patterns within the Netherlands, where the balanced model (Vision) was primarily used for MV networks and the unbalanced model (Gaia) for LV networks. However, these names are technically misleading: NetworkMV handles any voltage level equally well. The classes are more accurately described as BalancedNetwork and UnbalancedNetwork. The naming may change in a future release.

Presentations

PyPtP networks include schematic presentation data for compatibility with visualization tools. If your use case is purely programmatic, see Presentations for context.

Viewing Network Files

Vision and Gaia are commercial applications available under license, but their free versions function as network viewers. This can be helpful for debugging and visually inspecting VNF/GNF files created with PyPtP. Note that free versions have limited functionality.

For educational or research purposes, licenses may be available on a case-by-case basis. Contact pyptp@phasetophase.com for inquiries.