Skip to main content

DevEN (devenpy) — Power system study engine

Made in India from Bengaluru.

A pure native, ultra-fast power system simulation engine for AC Load Flow Analysis (LFA), Short Circuit Studies (SCS), Harmonic Power Flow & Frequency Scan (HA), 3-Phase Unbalanced Power Flow (3PH), Arc Flash Hazard Analysis (AF), and Batch Contingency Screening (BC).


1. Supported Grid Ingestion Formats

★ PSS/E RAWX (.rawx) [First Preference]

Recommended standard: Modern schema-validated XML/JSON format with high numerical precision and structured definitions.

Universal Multi-Format Ingestion (deven_io.py)

  • PSS/E Formats: .rawx (v32-v35), .raw (v29-v35)
  • MATPOWER: .m files (bus, gen, branch matrices)
  • IEEE Common Data Format: .cdf
  • Spreadsheets: Excel .xlsx / .xls (multi-sheet: Bus, Branch, Generator, Load)
  • PowerWorld: .aux scripts
  • European UCTE: .def format
  • CIM / CGMES: .xml schema
  • Native Encrypted: .deven binary databases

2. Installation

Install devenpy via pip:

# Install directly from the wheel
pip install devenpy-1.0.0-cp311-abi3-win_amd64.whl

# Or install from directory
pip install .

3. Interactive Web Documentation & Runner Scaffolding

DevEN includes an automated local documentation server and template exporter built right into the package CLI:

📖 View Web Documentation Locally

Launch an automated zero-dependency local web server that opens the complete single-file interactive documentation portal in your default browser:

devenpy --docs
# or:
python -m devenpy --docs

📁 Export Ready-to-Edit Study Runners & Sample Cases

Export all 6 standalone study runners and benchmark network models directly into your current terminal working directory:

devenpy --export-runners
# or specify a custom destination:
devenpy --export-runners ./my_project

Once exported, you will find:

  • run_lfa.py : AC Load Flow Analysis (NR, FDLF, DC, Gauss-Seidel, voltage limits, in-code generator & load edits)
  • run_scs.py : Short Circuit Studies (IEC 60909:2016 & ANSI C37, custom fault scenarios, breaker duty, contributions)
  • run_ha.py : Harmonic Power Flow & Frequency Scan (IEEE 519-2022, resonance detection, custom sources & filters)
  • run_3ph.py : 3-Phase Unbalanced Power Flow (4-Wire/3-Wire FCIM, phase voltage unbalance rate, sequence components)
  • run_af.py : Arc Flash Hazard Analysis (IEEE 1584-2018 & NFPA 70E-2024, incident energy, PPE categories)
  • run_bc.py : Batch Contingency & N-1 Outage Screening (editable in-code lines, transformers, and generator trips)
  • deven_io.py : Universal Multi-Format Grid Ingestion parser (MATPOWER, CDF, Excel, AUX, etc.)
  • cases/ : Benchmark grids (bench.rawx, case14.raw, iec60909_testnetwork_50Hz.raw, bench2.raw)

4. Python API Quickstart

import devenpy

# 1. Initialize case and load grid model (RAWX is first preference)
case = devenpy.PyCase()
case.load_rawx("cases/bench.rawx")

# Or load extended formats using universal I/O layer
# case = devenpy.load_grid_file("my_case.m")
# case = devenpy.load_grid_file("my_network.xlsx")

# 2. AC Load Flow (Newton-Raphson)
status = case.solve_load_flow(method="nr", tol=1e-5, show_q_limits=True)
print(f"LFA Converged: {status['converged']} in {status['iterations']} iters")

# 3. Short Circuit (IEC 60909 3-Phase Fault at Bus 1)
scs = case.solve_short_circuit(fault_bus=1, fault_type="3phase", method="iec")
print(f"Initial Symmetrical Current (Ik\"): {scs['ik_ka']:.3f} kA")

# 4. Save to Standard Encrypted Database
case.save_deven("cases/bench.deven")

5. Master CLI Usage

The pure Python CLI runs simulations directly without external dependencies:

# AC Load Flow with columnar PSS/E .out report
devenpy cases/bench.rawx --format out -o bench.out

# Short Circuit Study (IEC 60909 3-Phase Fault at Bus 1)
devenpy cases/bench.rawx --study scs --fault-bus 1 --fault-type 3phase

# System-Wide Fault Scan Across All Buses (< 1 ms)
devenpy cases/bench.rawx --study scs --scan

6. Contact & Support

Metadata

Release files for devenpy 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for devenpy 1.0.1
File Actions
devenpy-1.0.1-cp315-cp315-win_amd64.whl CPython 3.15 CPython 3.15 Windows x86-64 Details for devenpy-1.0.1-cp315-cp315-win_amd64.whl
devenpy-1.0.1-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for devenpy-1.0.1-cp314-cp314-win_amd64.whl
devenpy-1.0.1-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for devenpy-1.0.1-cp313-cp313-win_amd64.whl
devenpy-1.0.1-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for devenpy-1.0.1-cp312-cp312-win_amd64.whl
devenpy-1.0.1-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for devenpy-1.0.1-cp311-abi3-win_amd64.whl
devenpy-1.0.1-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details for devenpy-1.0.1-cp310-cp310-win_amd64.whl
devenpy-1.0.1-cp39-cp39-win_amd64.whl CPython 3.9 CPython 3.9 Windows x86-64 Details for devenpy-1.0.1-cp39-cp39-win_amd64.whl

Total release size: 29.0 MB

Release files / devenpy-1.0.1-cp315-cp315-win_amd64.whl

Download URL devenpy-1.0.1-cp315-cp315-win_amd64.whl
Size 4.1 MB
Tags CPython 3.15 Windows x86-64
SHA-256 checksum
How to use checksums
f67f93fbddcdb8fc617511f7f74280358e6466f3fdc6a7987a149c570eb186f1
BLAKE2b-256 checksum
How to use checksums
cabe7ef52f2287a48f083eb8a686de953d8e9620cf16e29d5a398ba527678c3c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / devenpy-1.0.1-cp314-cp314-win_amd64.whl

Download URL devenpy-1.0.1-cp314-cp314-win_amd64.whl
Size 4.1 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
c05561280e3c0b15042e7913708f70ab1f19d4edb0edf68f92b52c1840a61dac
BLAKE2b-256 checksum
How to use checksums
2cf26987eded16703757728bf267a3114c9464fa2433abce5c50aee2ba4abd76
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / devenpy-1.0.1-cp313-cp313-win_amd64.whl

Download URL devenpy-1.0.1-cp313-cp313-win_amd64.whl
Size 4.1 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
629f77c35d7deeb33da367271c3911115db2af24e1625508e89f1c68973b3533
BLAKE2b-256 checksum
How to use checksums
91888d2d0d0cd293f5c7c538861a86b611c3ed17200b90970bb0d905f1533fc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / devenpy-1.0.1-cp312-cp312-win_amd64.whl

Download URL devenpy-1.0.1-cp312-cp312-win_amd64.whl
Size 4.1 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
ba140ea0eecfe15f9498a4f353f891e860cc7a107a638775497a40daf2a09a3a
BLAKE2b-256 checksum
How to use checksums
13a6b07889b5ad0759a71d36382d10c4d91231ca45c383fd864181c2f02f3ac1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / devenpy-1.0.1-cp311-abi3-win_amd64.whl

Download URL devenpy-1.0.1-cp311-abi3-win_amd64.whl
Size 4.1 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
7a94155e11100a360a334af491731f042c4af131a3eec1ff87411e40f5640dbe
BLAKE2b-256 checksum
How to use checksums
f7a52a2992b06d6e8b9bcfebc8f0d20f04d583a3d9257b6c342fd71e224ccfc6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / devenpy-1.0.1-cp310-cp310-win_amd64.whl

Download URL devenpy-1.0.1-cp310-cp310-win_amd64.whl
Size 4.1 MB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
6ec001c3e9a17ae5332cd06d481763f572ef1e76867343474d84aeeb5e7837b2
BLAKE2b-256 checksum
How to use checksums
81618c0e15a7d9e852408d3ca6b399093140c9c5dd4c95a1f46ecd5fe6db0ec2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / devenpy-1.0.1-cp39-cp39-win_amd64.whl

Download URL devenpy-1.0.1-cp39-cp39-win_amd64.whl
Size 4.1 MB
Tags CPython 3.9 Windows x86-64
SHA-256 checksum
How to use checksums
02b58d6a846e29e4432e0e14c1490c0eee91a318728762d6c88eab5bed20a39d
BLAKE2b-256 checksum
How to use checksums
76cd8061f4cc301bee0405b4d993029e0ee278c04d9aaddacc2547308b16f223
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for devenpy 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

7 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page