1. Ready to release new version

mzy2240 · May 21, 2022 · eb3ed53 · eb3ed53
1 parent bbb3f12
commit eb3ed53
Show file tree

Hide file tree

Showing 27 changed files with 63 additions and 39 deletions.
diff --git a/README.rst b/README.rst
@@ -68,7 +68,7 @@ The ESA team works hard to ensure ESA is well tested, and we strive for
 testing coverage data for ESA, using `coverage
 <https://pypi.org/project/coverage/>`__.
 
-.. table:: ESA's testing coverage as of 2022-02-20 (Git commit: 2b5a8ff)
+.. table:: ESA's testing coverage as of 2022-05-20 (Git commit: bbb3f12)
     :widths: auto
     :align: left
 
@@ -77,7 +77,7 @@ testing coverage data for ESA, using `coverage
     +=================+===================+=================+=================+====================+
     | esa/__init__.py |                 2 |               0 |               2 |                100 |
     +-----------------+-------------------+-----------------+-----------------+--------------------+
-    | esa/saw.py      |               824 |               0 |             824 |                100 |
+    | esa/saw.py      |               848 |               0 |             848 |                100 |
     +-----------------+-------------------+-----------------+-----------------+--------------------+
 
 License

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-1.2.6
+1.2.7
diff --git a/docs/doctrees/environment.pickle b/docs/doctrees/environment.pickle
diff --git a/docs/doctrees/esa.doctree b/docs/doctrees/esa.doctree
diff --git a/docs/doctrees/overview.doctree b/docs/doctrees/overview.doctree
diff --git a/docs/doctrees/welcome.doctree b/docs/doctrees/welcome.doctree
diff --git a/docs/html/.buildinfo b/docs/html/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 437d8a7d4ff36783090e9c4c30038663
+config: 5bbb22a6f84fd03f028d7b14f41d5375
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/html/_static/documentation_options.js b/docs/html/_static/documentation_options.js
@@ -1,6 +1,6 @@
 var DOCUMENTATION_OPTIONS = {
     URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
-    VERSION: '1.2.6',
+    VERSION: '1.2.7',
     LANGUAGE: 'None',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

diff --git a/docs/html/common_issues.html b/docs/html/common_issues.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>Common Issues &#8212; ESA 1.2.6 documentation</title>
+    <title>Common Issues &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/esa.html b/docs/html/esa.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>esa API Documentation &#8212; ESA 1.2.6 documentation</title>
+    <title>esa API Documentation &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
@@ -1288,12 +1288,17 @@
 
 <dl class="py method">
 <dt class="sig sig-object py" id="esa.saw.SAW.get_lodf_matrix">
-<span class="sig-name descname"><span class="pre">get_lodf_matrix</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#esa.saw.SAW.get_lodf_matrix" title="Permalink to this definition">¶</a></dt>
-<dd><p>Obtain LODF matrix in numpy array format.
-By default, it obtains the lodf matrix directly from PW.</p>
+<span class="sig-name descname"><span class="pre">get_lodf_matrix</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">precision</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">3</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#esa.saw.SAW.get_lodf_matrix" title="Permalink to this definition">¶</a></dt>
+<dd><p>Obtain LODF matrix in numpy array or scipy sparse matrix.
+By default, it obtains the lodf matrix directly from PW. If size
+is larger than 1000, then precision will be applied to filter out
+small values and the result will be returned in scipy sparse matrix.</p>
 <dl class="field-list simple">
-<dt class="field-odd">Returns</dt>
-<dd class="field-odd"><p>LODF matrix</p>
+<dt class="field-odd">Parameters</dt>
+<dd class="field-odd"><p><strong>precision</strong> – number of decimal to keep.</p>
+</dd>
+<dt class="field-even">Returns</dt>
+<dd class="field-even"><p>LODF matrix</p>
 </dd>
 </dl>
 </dd></dl>

diff --git a/docs/html/genindex.html b/docs/html/genindex.html
@@ -5,7 +5,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Index &#8212; ESA 1.2.6 documentation</title>
+    <title>Index &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/index.html b/docs/html/index.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>Easy SimAuto (ESA) Documentation &#8212; ESA 1.2.6 documentation</title>
+    <title>Easy SimAuto (ESA) Documentation &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/installation.html b/docs/html/installation.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>Installing ESA &#8212; ESA 1.2.6 documentation</title>
+    <title>Installing ESA &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/objects.inv b/docs/html/objects.inv
diff --git a/docs/html/overview.html b/docs/html/overview.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>ESA Overview &#8212; ESA 1.2.6 documentation</title>
+    <title>ESA Overview &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
@@ -133,7 +133,7 @@ <h2>Testing Coverage<a class="headerlink" href="#testing-coverage" title="Permal
 <p>The ESA team strives to write good tests with 100% coverage. The table
 below provides the latest test coverage data for ESA.</p>
 <table class="colwidths-auto docutils align-left" id="id3">
-<caption><span class="caption-text">ESA’s testing coverage as of 2022-02-20 (Git commit: 2b5a8ff)</span><a class="headerlink" href="#id3" title="Permalink to this table">¶</a></caption>
+<caption><span class="caption-text">ESA’s testing coverage as of 2022-05-20 (Git commit: bbb3f12)</span><a class="headerlink" href="#id3" title="Permalink to this table">¶</a></caption>
 <thead>
 <tr class="row-odd"><th class="head"><p>Name</p></th>
 <th class="head"><p>Num. Statements</p></th>
@@ -150,9 +150,9 @@ <h2>Testing Coverage<a class="headerlink" href="#testing-coverage" title="Permal
 <td><p>100</p></td>
 </tr>
 <tr class="row-odd"><td><p>esa/saw.py</p></td>
-<td><p>824</p></td>
+<td><p>848</p></td>
 <td><p>0</p></td>
-<td><p>824</p></td>
+<td><p>848</p></td>
 <td><p>100</p></td>
 </tr>
 </tbody>

diff --git a/docs/html/py-modindex.html b/docs/html/py-modindex.html
@@ -5,7 +5,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Python Module Index &#8212; ESA 1.2.6 documentation</title>
+    <title>Python Module Index &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/quick_start.html b/docs/html/quick_start.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>Quick Start &#8212; ESA 1.2.6 documentation</title>
+    <title>Quick Start &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/search.html b/docs/html/search.html
@@ -5,7 +5,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Search &#8212; ESA 1.2.6 documentation</title>
+    <title>Search &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
 

diff --git a/docs/html/searchindex.js b/docs/html/searchindex.js
diff --git a/docs/html/snippets.html b/docs/html/snippets.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>Examples &#8212; ESA 1.2.6 documentation</title>
+    <title>Examples &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>

diff --git a/docs/html/welcome.html b/docs/html/welcome.html
@@ -6,7 +6,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
-    <title>Welcome! &#8212; ESA 1.2.6 documentation</title>
+    <title>Welcome! &#8212; ESA 1.2.7 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css" />
     <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
@@ -357,6 +357,14 @@ <h3>Credits and Thanks<a class="headerlink" href="#credits-and-thanks" title="Pe
 <p>Changes made with each ESA release are listed here. Please note that
 versions prior to 1.0.0 are not listed here, but are still available on
 <a class="reference external" href="https://pypi.org/project/esa/#history">PyPi</a>.</p>
+<section id="version-1-2-7">
+<h3>Version 1.2.7<a class="headerlink" href="#version-1-2-7" title="Permalink to this headline">¶</a></h3>
+<ul class="simple">
+<li><p>Officially support PW23</p></li>
+<li><p>Support obtaining LODF matrix from large case (&gt;1000)</p></li>
+<li><p>Fix the self-loop issue when generating inter-substation level graph model</p></li>
+</ul>
+</section>
 <section id="version-1-2-6">
 <h3>Version 1.2.6<a class="headerlink" href="#version-1-2-6" title="Permalink to this headline">¶</a></h3>
 <ul class="simple">

diff --git a/docs/rst/coverage.rst b/docs/rst/coverage.rst
@@ -1,4 +1,4 @@
-.. table:: ESA's testing coverage as of 2022-02-20 (Git commit: 2b5a8ff)
+.. table:: ESA's testing coverage as of 2022-05-20 (Git commit: bbb3f12)
     :widths: auto
     :align: left
 
@@ -7,5 +7,5 @@
     +=================+===================+=================+=================+====================+
     | esa/__init__.py |                 2 |               0 |               2 |                100 |
     +-----------------+-------------------+-----------------+-----------------+--------------------+
-    | esa/saw.py      |               824 |               0 |             824 |                100 |
+    | esa/saw.py      |               848 |               0 |             848 |                100 |
     +-----------------+-------------------+-----------------+-----------------+--------------------+
diff --git a/docs/rst/welcome/changelog.rst b/docs/rst/welcome/changelog.rst
@@ -2,6 +2,14 @@ Changes made with each ESA release are listed here. Please note that
 versions prior to 1.0.0 are not listed here, but are still available on
 `PyPi <https://pypi.org/project/esa/#history>`__.
 
+Version 1.2.7
+^^^^^^^^^^^^^
+
+* Officially support PW23
+* Support obtaining LODF matrix from large case (>1000)
+* Fix the self-loop issue when generating inter-substation level graph model
+
+
 Version 1.2.6
 ^^^^^^^^^^^^^
 

diff --git a/esa/__init__.py b/esa/__init__.py
@@ -16,4 +16,4 @@
 # Please keep the docstring above up to date with all the imports.
 from .saw import SAW, PowerWorldError, COMError, CommandNotRespectedError,\
     Error
-__version__ = "1.2.6"
+__version__ = "1.2.7"
diff --git a/tests/cases/wscc_9/WSCC 9 bus.pwd b/tests/cases/wscc_9/WSCC 9 bus.pwd
diff --git a/tests/cases/wscc_9/WSCC 9 bus_pws_version_23.PWB b/tests/cases/wscc_9/WSCC 9 bus_pws_version_23.PWB
diff --git a/tests/test_saw.py b/tests/test_saw.py
@@ -477,7 +477,7 @@ def test_3wxformer(self):
 
         # Key fields have changed for 3 winding transformers between
         # versions.
-        if VERSION in [21, 22]:
+        if VERSION in [21, 22, 23]:
             expected = ['BusIdentifier', 'BusIdentifier:1', 'BusIdentifier:2',
                         'LineCircuit']
         elif VERSION == 17:
@@ -550,7 +550,7 @@ class IdentifyNumericFieldsTestCase(unittest.TestCase):
     # noinspection PyMethodMayBeStatic
     def test_correct(self):
         # Intentionally make the fields out of alphabetical order.
-        if VERSION in [21, 22]:
+        if VERSION in [21, 22, 23]:
             fields = ['LineStatus', 'LockOut', 'LineR', 'LineX', 'BusNum']
             expected = np.array([False, False, True, True, True])
         elif VERSION == 17: