Skip to content

Releases: acep-uaf/WEC-Grid

WEC-Grid v1.0.0

09 Sep 21:53
@barajale barajale
v1.0.0
fe011db

Choose a tag to compare

View all tags
WEC-Grid v1.0.0 Latest
Latest

WEC-Grid v1.0.0

WEC-Grid integrates Wave Energy Converter (WEC) models with steady‑state power‑system studies. This first stable release provides a unified workflow across commercial (PSS®E) and open‑source (PyPSA) backends, plus a database and plotting layer for analysis and reproducibility.

Highlights

  • Unified framework to study WEC integration in power grids
  • Dual backends with a single API and data schema:
    • PSS®E (commercial)
    • PyPSA (open source)
  • WEC‑Sim (MATLAB) integration for device‑level physics; results stored in SQLite
  • Documentation site with API reference and examples

Features

  • Engine orchestration
    • Load cases, attach WEC farms, run time‑series power flow, collect standardized results
  • Backends
    • PSS®E: case load (.sav/.raw), Newton–Raphson PF, grid modification (bus/line/gen), snapshot export
    • PyPSA: RAW import via GRG, network build, AC PF, snapshot export
  • WEC layer
    • WECFarm and WECDevice with automatic downsampling to grid resolution and per‑unit conversion
  • Database (SQLite)
    • Cross‑platform schema (bus/gen/line/load) + WEC‑Sim metadata and high‑resolution power
    • Persist and reload entire GridState time series for comparison across backends
  • Plotting
    • Time‑series per component, single‑line diagram (SLD), backend comparisons, WEC farm analysis

Install

  • Base
    • pip install -e .
  • Optional
    • pip install wecgrid[psse] # PSS®E path helper support
  • Note: PSS®E and MATLAB/WEC‑Sim must be installed/licensed separately.

Quick Start (PyPSA)

from wecgrid import Engine

eng = Engine()
eng.case("examples/grid_models/IEEE_14_bus.RAW")
eng.load(["pypsa"])  # or ["psse"], or both

# Optional: attach a WEC farm (requires configured database)
# eng.apply_wec("Test Farm", wec_sim_id=101, bus_location=14)

eng.simulate()  # time-series run across snapshots

Documentation

  • Project site (GitHub Pages) includes getting started, design overview, backend integration, database reference, and examples.

Known Issues

  • PSS®E is Windows‑only; environment setup required.
  • WEC connection line R/X/rating values are placeholders; tune/expose per system.
  • Minimal tests included; a test CI job will follow in a subsequent release.
  • Dependencies are pinned to an older scientific stack for reproducibility; modernization planned.

Acknowledgments

Supported by the U.S. DOE Water Power Technologies Office, University of Alaska Fairbanks, and PNNL.

Assets 2
Loading