-
Notifications
You must be signed in to change notification settings - Fork 0
yelrew/p_y_d_s_e
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
<!DOCTYPE html> <html class="writer-html5" lang="en" > <head> <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>PyDSE — PyDSE 1.3 documentation</title> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/css/theme.css" type="text/css" /> <!--[if lt IE 9]> <script src="_static/js/html5shiv.min.js"></script> <![endif]--> <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script> <script src="_static/jquery.js"></script> <script src="_static/underscore.js"></script> <script src="_static/doctools.js"></script> <script src="_static/js/theme.js"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> </head> <body class="wy-body-for-nav"> <div class="wy-grid-for-nav"> <nav data-toggle="wy-nav-shift" class="wy-nav-side"> <div class="wy-side-scroll"> <div class="wy-side-nav-search" > <a href="index.html" class="icon icon-home"> PyDSE </a> <div role="search"> <form id="rtd-search-form" class="wy-form" action="search.html" method="get"> <input type="text" name="q" placeholder="Search docs" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu"> <p class="caption" role="heading"><span class="caption-text">Contents</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="index.html">PyDSE - A Python solution for State Estimation in Distribution Systems</a></li> </ul> <ul> <li class="toctree-l1"><a class="reference internal" href="modules.html">pydse</a></li> </ul> </div> </div> </nav> <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" > <i data-toggle="wy-nav-top" class="fa fa-bars"></i> <a href="index.html">PyDSE</a> </nav> <div class="wy-nav-content"> <div class="rst-content"> <div role="navigation" aria-label="Page navigation"> <ul class="wy-breadcrumbs"> <li><a href="index.html" class="icon icon-home"></a> »</li> <li>PyDSE</li> <li class="wy-breadcrumbs-aside"> <a href="_sources/readme.rst.txt" rel="nofollow"> View page source</a> </li> </ul> <hr/> </div> <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> <div itemprop="articleBody"> <section id="pydse"> <h1>PyDSE<a class="headerlink" href="#pydse" title="Permalink to this headline"></a></h1> <p>PyDSE is a Python package for State Estimation of unbalanced Distribution Systems.</p> <ul class="simple"> <li><p><strong>Source:</strong> <a class="reference external" href="https://github.com/yelrew/pydse">https://github.com/yelrew/pydse</a></p></li> <li><p><strong>Bug reports:</strong> <a class="reference external" href="https://github.com/yelrew/pydse/issues">https://github.com/yelrew/pydse/issues</a></p></li> <li><p><strong>Documentation:</strong> <a class="reference external" href="https://yelrew.github.io/p_y_d_s_e">https://yelrew.github.io/p_y_d_s_e</a></p></li> </ul> <p>PyDSE operates in actual (non-per unit) network quantities. It provides:</p> <ul class="simple"> <li><p>An interface for OpenDSS data files</p></li> <li><p>Models to represent unbalanced 3-phase networks</p></li> <li><p>Methods to perform load-flow analysis</p></li> <li><p>Methods to perform state estimation in 3-phase networks, including Observability Analysis and Gross Errors check.</p></li> </ul> <p><strong>Measurements supported</strong></p> <ul class="simple"> <li><p><cite>Skm</cite>: complex (active/reactive) power flow</p></li> <li><p><cite>S</cite>: complex (active/reactive) power injection</p></li> <li><p><cite>Ikm</cite>: complex branch-current</p></li> <li><p><cite>I</cite>: complex current injection</p></li> <li><p><cite>|Ikm|</cite>: branch-current magnitude (new in version 1.3)</p></li> </ul> <section id="quick-start"> <h2>Quick start<a class="headerlink" href="#quick-start" title="Permalink to this headline"></a></h2> <p>Run the Branch-Current Estimator on the IEEE-34 feeder, considering artificially generated measurements and real-time measurements:</p> <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="gp">>>> </span><span class="n">dse</span> <span class="o">=</span> <span class="n">Dse</span><span class="p">(</span><span class="n">filename</span><span class="o">=</span><span class="s2">"data/IEEE13mod.dss"</span><span class="p">)</span> <span class="gp">>>> </span><span class="c1"># Adding measurements artificially generated from load flow</span> <span class="gp">>>> </span><span class="n">dse</span><span class="o">.</span><span class="n">addMeas</span><span class="p">(</span><span class="s1">'skm'</span><span class="p">,</span> <span class="n">location</span><span class="o">=</span><span class="s1">'all'</span><span class="p">,</span> <span class="n">accuracy</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span> <span class="n">ignore</span><span class="o">=</span><span class="s1">'632-670,RG60-632'</span><span class="p">)</span> <span class="gp">>>> </span><span class="n">dse</span><span class="o">.</span><span class="n">addMeas</span><span class="p">(</span><span class="s1">'s'</span><span class="p">,</span> <span class="n">location</span><span class="o">=</span><span class="s1">'load'</span><span class="p">,</span> <span class="n">ignore</span><span class="o">=</span><span class="s1">'611'</span><span class="p">)</span> <span class="gp">>>> </span><span class="c1"># Add measurements with actual values</span> <span class="gp">>>> </span><span class="n">dse</span><span class="o">.</span><span class="n">addMeas</span><span class="p">(</span><span class="s1">'skm'</span><span class="p">,</span> <span class="n">location</span><span class="o">=</span><span class="s1">'632-670'</span><span class="p">,</span> <span class="n">nodes</span><span class="o">=</span><span class="s1">'123'</span><span class="p">,</span> <span class="n">accuracy</span><span class="o">=</span> <span class="mf">0.0</span><span class="p">,</span> <span class="go"> value=[1.06725092e6+0.48933956e6j, 524.04365e3+125.60266e3j, 1.10045821e6+0.36163657e6j])</span> <span class="gp">>>> </span><span class="n">dse</span><span class="o">.</span><span class="n">addMeas</span><span class="p">(</span><span class="s1">'skm'</span><span class="p">,</span> <span class="n">location</span><span class="o">=</span><span class="s1">'650632'</span><span class="p">,</span> <span class="n">nodes</span><span class="o">=</span><span class="s1">'123'</span><span class="p">,</span> <span class="n">accuracy</span><span class="o">=</span> <span class="mf">0.0</span><span class="p">,</span> <span class="go"> value=[1.252e+06+6.85e+05j, 9.728e+05+3.792e+05j, 1.342e+06+6.72e+05j])</span> <span class="gp">>>> </span><span class="n">dse</span><span class="o">.</span><span class="n">addMeas</span><span class="p">(</span><span class="s1">'s'</span><span class="p">,</span> <span class="n">location</span><span class="o">=</span><span class="s1">'611'</span><span class="p">,</span> <span class="n">nodes</span><span class="o">=</span><span class="s1">'3'</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="mf">163.5e3</span><span class="o">-</span><span class="mf">15.54e3</span><span class="n">j</span><span class="p">)</span> <span class="gp">>>> </span><span class="n">dse</span><span class="o">.</span><span class="n">runDSE</span><span class="p">(</span><span class="n">report</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span> </pre></div> </div> <p>PyDSE comes with several pre-packaged test cases. To list the cases available, type:</p> <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="gp">>>> </span><span class="kn">from</span> <span class="nn">pydse.examples</span> <span class="kn">import</span> <span class="n">cases</span> <span class="gp">>>> </span><span class="n">cases</span><span class="o">.</span><span class="n">list</span><span class="p">()</span> </pre></div> </div> <p>To execute a case ‘test’, type:</p> <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="gp">>>> </span><span class="n">cases</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s1">'test'</span><span class="p">)</span> </pre></div> </div> <p>The examples are also found in the <a class="reference external" href="https://github.com/yelrew/pydse/tree/master/pydse/examples">examples</a> directory and the <a class="reference external" href="https://yelrew.github.io/p_y_d_s_e_-_d_o_c">documentation</a> .</p> </section> <section id="install"> <h2>Install<a class="headerlink" href="#install" title="Permalink to this headline"></a></h2> <p>Install the latest version of PyDSE:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ pip install --user -U git+ssh://git@github.com/yelrew/pydse </pre></div> </div> <p>or:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/yelrew/pydse.git $ cd pydse && pip install . </pre></div> </div> </section> <section id="bugs"> <h2>Bugs<a class="headerlink" href="#bugs" title="Permalink to this headline"></a></h2> <p>Please report any bugs that you find <a class="reference external" href="https://github.com/yelrew/pydse/issues">here</a>.</p> </section> <section id="license"> <h2>License<a class="headerlink" href="#license" title="Permalink to this headline"></a></h2> <p>Under elaboration:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Copyright</span> <span class="p">(</span><span class="n">C</span><span class="p">)</span> <span class="mi">2021</span><span class="o">-</span><span class="mi">2022</span> <span class="n">Synergy</span> <span class="ow">and</span> <span class="n">the</span> <span class="n">PyDSE</span> <span class="n">Developer</span> <span class="n">Eduardo</span> <span class="n">Werley</span> <span class="n">S</span><span class="o">.</span> <span class="n">Ângelos</span> <span class="o"><</span><span class="n">ew</span><span class="o">.</span><span class="n">angelos</span><span class="nd">@ieee</span><span class="o">.</span><span class="n">org</span><span class="o">></span> </pre></div> </div> </section> </section> </div> </div> <footer> <hr/> <div role="contentinfo"> <p>© Copyright 2022, Eduardo Werley.</p> </div> Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. </footer> </div> </div> </section> </div> <script> jQuery(function () { SphinxRtdTheme.Navigation.enable(true); }); </script> </body> </html>
About
No description, website, or topics provided.
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published