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.0

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.0
File Actions
devenpy-1.0.0-cp315-cp315-win_amd64.whl CPython 3.15 CPython 3.15 Windows x86-64 Details for devenpy-1.0.0-cp315-cp315-win_amd64.whl
devenpy-1.0.0-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for devenpy-1.0.0-cp314-cp314-win_amd64.whl
devenpy-1.0.0-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for devenpy-1.0.0-cp313-cp313-win_amd64.whl
devenpy-1.0.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for devenpy-1.0.0-cp312-cp312-win_amd64.whl
devenpy-1.0.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details for devenpy-1.0.0-cp311-cp311-win_amd64.whl
devenpy-1.0.0-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for devenpy-1.0.0-cp311-abi3-win_amd64.whl
devenpy-1.0.0-cp310-cp310-win_amd64.whl CPython 3.10 CPython 3.10 Windows x86-64 Details for devenpy-1.0.0-cp310-cp310-win_amd64.whl
devenpy-1.0.0-cp39-cp39-win_amd64.whl CPython 3.9 CPython 3.9 Windows x86-64 Details for devenpy-1.0.0-cp39-cp39-win_amd64.whl

Total release size: 33.1 MB

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

Download URL devenpy-1.0.0-cp315-cp315-win_amd64.whl
Size 4.1 MB
Tags CPython 3.15 Windows x86-64
SHA-256 checksum
How to use checksums
849a9b44f264b4f0238732c30b210c2f80cae00e083380adccc2a7ce4a722531
BLAKE2b-256 checksum
How to use checksums
4d9ccecd0b221860ea60534a0666c34caecc265815190d77ab8a23e61978c8e6
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.0-cp314-cp314-win_amd64.whl

Download URL devenpy-1.0.0-cp314-cp314-win_amd64.whl
Size 4.1 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
b9c30aaa47b9e68c2af5f84236b203ffb617c825d725c48b1212ba32b38e67e8
BLAKE2b-256 checksum
How to use checksums
4affd6b538d3ca477c83b0fdc51d7dd096b7a078b7c9ec4cd6cd743f7d1d893b
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.0-cp313-cp313-win_amd64.whl

Download URL devenpy-1.0.0-cp313-cp313-win_amd64.whl
Size 4.1 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
756e6af80605173ff49382efbed2afb428345f0d417a2200776c246763c78137
BLAKE2b-256 checksum
How to use checksums
383249777814ce034430d786b111574613c4e5be1f4982f977dca9a35a3cd467
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.0-cp312-cp312-win_amd64.whl

Download URL devenpy-1.0.0-cp312-cp312-win_amd64.whl
Size 4.1 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
089c4a197d7c593b376168b706770544330e0df2e819f6fa77c118508bba8bbd
BLAKE2b-256 checksum
How to use checksums
013529381604e2e7b24a81b30ebd66fe6717033b5ba2c666af5cd37b799b4300
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.0-cp311-cp311-win_amd64.whl

Download URL devenpy-1.0.0-cp311-cp311-win_amd64.whl
Size 4.1 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
c0a2144bcda2400c7f6ef40a615652f62be093b472ac591f5f4ead479ed038f6
BLAKE2b-256 checksum
How to use checksums
378d0c3a11b1119690812f60b97a030ab5705d6ea769cfd56fd31c9cf10202e5
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.0-cp311-abi3-win_amd64.whl

Download URL devenpy-1.0.0-cp311-abi3-win_amd64.whl
Size 4.1 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
8e75e7e53910b1a272b892248f85a3bb1206f34e2c23c116b721b23bea5a7680
BLAKE2b-256 checksum
How to use checksums
720200ec77d90667546e64294ec722dee5a0c64823b844cc15536b03c07af9f6
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.0-cp310-cp310-win_amd64.whl

Download URL devenpy-1.0.0-cp310-cp310-win_amd64.whl
Size 4.1 MB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
e6533f04520c1fe2a924e550d255ee24b67bab3a5b99a21cd7d926f65826883a
BLAKE2b-256 checksum
How to use checksums
89b35d062bfe915b18770cb12db50d2a2a6228cf679697a72bca02749b685353
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.0-cp39-cp39-win_amd64.whl

Download URL devenpy-1.0.0-cp39-cp39-win_amd64.whl
Size 4.1 MB
Tags CPython 3.9 Windows x86-64
SHA-256 checksum
How to use checksums
5d7bbaab930e3cafdaffd0280c116aa640b6c535bf4206cdfcf815c8f2e12145
BLAKE2b-256 checksum
How to use checksums
883cedb29cd51b7e9ac046ebdd0e5039ff2cd697d9fa12c691a6c1e120da413e
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.0

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.0 This release

8 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