OpenDER

Open-source Distributed Energy Resources (DER) Model that represents IEEE Standard 1547-2018 requirements for steady-state and dynamic analyses

https://github.com/epri-dev/OpenDER

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.9%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Open-source Distributed Energy Resources (DER) Model that represents IEEE Standard 1547-2018 requirements for steady-state and dynamic analyses

Basic Info
  • Host: GitHub
  • Owner: epri-dev
  • License: other
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 1.2 MB
Statistics
  • Stars: 66
  • Watchers: 18
  • Forks: 27
  • Open Issues: 0
  • Releases: 8
Created about 4 years ago · Last pushed about 1 year ago
Metadata Files
Readme Changelog License

README.rst

.. figure:: https://raw.githubusercontent.com/epri-dev/OpenDER/develop_req_SQA/docs/logo.png
    :alt: Open-source Distributed Energy Resources (OpenDER) Model

EPRI’s OpenDER model aims to accurately represent steady-state and dynamic behaviors of inverter-based distributed
energy resources (DERs). The model follows interconnection standards or grid-codes and is informed by the observed
behaviors of commercial products. Currently, model version 2.1 includes photovoltaic (PV) and battery energy storage
system (BESS) DER behaviors according to the capabilities and functionalities required by the IEEE standard 1547-2018.
This first-of-its-kind model can be used to run snapshot, Quasi-Static Time Series (QSTS), and a variety of dynamic
analyses to study the impacts of DERs on distribution operations and planning.

This project is licensed under the terms of the BSD-3 clause license.


.. |GitHub license| image:: https://img.shields.io/badge/License-BSD_3--Clause-blue.svg
   :target: https://github.com/epri-dev/opender/blob/master/LICENSE.txt

Resources
---------
OpenDER is under active development. Use the following resources to get involved.

* EPRI OpenDER homepage (`link `__)

* Model specification: IEEE 1547-2018 OpenDER Model: Version 2.2, EPRI, Palo Alto, CA: 2024. 3002030962
  (`link `__)

* OpenDER model interface to OpenDSS for circuit level analysis
  (`link `__)

Development Objective
---------------------
* Harmonize accurate interpretations of the IEEE Std 1547-2018 DER interconnection standard among all the stakeholders,
  including utilities, distribution analysis tool developers, and original equipment manufacturers (OEMs).

* Build consensus through an open-to-all DER Model User’s Group (DERMUG), which will utilize EPRI developed model
  specifications and codes and provide feedback for continuous improvement of the OpenDER model.

* Help the industry properly model the DERs that are (or to be) grid interconnected and evaluate the associated impacts
  on distribution circuits accurately.

Overall Block Diagram
---------------------
.. figure:: https://raw.githubusercontent.com/epri-dev/OpenDER/develop_req_SQA/docs/blockdiagram.png
    :width: 900

Dependencies
------------
Python >= 3.7

numpy

pandas

matplotlib

Dependencies of the package are auto-installed by pip command below.

Installation
------------
pip install opender


Example of Using the DER Model
------------------------------
Example script: main.py

This example generate DER output power in a dynamic simulation to demonstrate DER trip and enter service behavior.
The grid voltage is set to be alternating between 1 and 1.11 per unit every ~10 minutes.
DER should be observed to enter service and trip periodically.

Other examples can be found in the `Examples `_ directory.
Click the .ipynb files to see example scripts and execution results.

Unit tests
----------
Dependency: pytest

Execution command: pytest path-to-package\\tests


Owner

  • Name: EPRI
  • Login: epri-dev
  • Kind: organization
  • Location: Palo Alto, CA

GitHub Events

Total
  • Watch event: 10
  • Push event: 5
  • Pull request event: 4
  • Fork event: 3
  • Create event: 2
Last Year
  • Watch event: 10
  • Push event: 5
  • Pull request event: 4
  • Fork event: 3
  • Create event: 2

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 113
  • Total Committers: 2
  • Avg Commits per committer: 56.5
  • Development Distribution Score (DDS): 0.053
Past Year
  • Commits: 8
  • Committers: 1
  • Avg Commits per committer: 8.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
pyma001 y****a@e****m 107
EPRI-SQA s****a@e****m 6
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 1
  • Total pull requests: 16
  • Average time to close issues: 6 months
  • Average time to close pull requests: 1 minute
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.06
  • Merged pull requests: 14
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 4
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 4
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • invisibleroads (1)
Pull Request Authors
  • EPRI-SQA (17)
  • kenjgibson (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 3,600 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 1
    (may contain duplicates)
  • Total versions: 29
  • Total maintainers: 1
proxy.golang.org: github.com/epri-dev/opender
  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 10 months ago
proxy.golang.org: github.com/epri-dev/OpenDER
  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 10 months ago
pypi.org: opender

Open-source Distributed Energy Resources (DER) Model that represents IEEE Standard 1547-2018 requirements for steady-state and dynamic analyses

  • Versions: 15
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 3,600 Last month
Rankings
Forks count: 9.3%
Downloads: 9.8%
Dependent packages count: 10.1%
Stargazers count: 10.2%
Average: 12.2%
Dependent repos count: 21.6%
Maintainers (1)
Last synced: 10 months ago

Dependencies

requirements.txt pypi
  • matplotlib ==3.5.1
  • numpy ==1.21.6
  • pandas ==1.3.5
setup.py pypi
  • numpy *