Merge pull request #20 from CURENT/develop

Release of v0.8.0

.github/ISSUE_TEMPLATE/bug_report.md

@@ -3,7 +3,7 @@ name: Bug report
 about: Create a report to help us improve
 title: ''
 labels: bug
-assignees: cuihantao
+assignees: jinningwang
 
 ---
 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -3,7 +3,7 @@ name: Feature request
 about: Suggest an idea for this project
 title: ''
 labels: ''
-assignees:
+assignees: jinningwang
 
 ---
 

README.md

@@ -12,6 +12,16 @@ Python Software for Power System Dispatch Modeling and Co-Simulation with Dynani
 
 With the built-in interface with dynamic simulation engine, LTB ANDES, AMS enables Dynamics Interfaced Stability Constrained Production Cost and Market Operation Modeling.
 
+AMS produces credible dispatch results.
+The following table shows the comparison of DC optimal power flow results between AMS and other tools.
+
+|               | AMS GUROBI   | AMS ECOS     | PYPOWER      | pandapower   |
+|---------------|--------------|--------------|--------------|--------------|
+| case39.m      | 41,461.94    | 41,461.94    | 41,461.94    | 41,461.94    |
+| ieee14_uced.xlsx | 45.72     | 45.72        | 45.72        | 45.72        |
+| ieee39_uced.xlsx | 36,513.47 | 36,513.47    | 36,513.47    | 36,513.47    |
+| npcc.m        | 57,664,760.85| 57,664,760.85| 57,664,760.85| 57,664,760.85|
+
 AMS is currently under active development.
 Use the following resources to get involved.
 
@@ -41,6 +51,17 @@ See [GitHub contributors][GitHub contributors] for the contributor list.
 
 AMS is licensed under the [GPL v3 License](./LICENSE).
 
+# Related Projects
+
++ [CVXPY](https://github.com/cvxpy/cvxpy)
++ [Visualizations of Mittelmann benchmarks](https://mattmilten.github.io/mittelmann-plots/)
++ [CBC Solver](https://github.com/coin-or/Cbc)
++ [MATPOWER](https://github.com/MATPOWER/matpower)
++ [PYPOWER](https://github.com/rwl/PYPOWER)
++ [pandapower](https://github.com/e2nIEE/pandapower)
+
+Some commercial solvers provide academic licenses, such as COPT, GUROBI, CPLEX, and MOSEK.
+
 * * *
 
 [GitHub releases]:       https://github.com/CURENT/ams/releases

ams/cases/5bus/pjm5bus_uced.json

@@ -110,7 +110,8 @@
       "q0": 0.9861,
       "vmax": 1.1,
       "vmin": 0.9,
-      "owner": null
+      "owner": null,
+      "ctrl": 1.0
     },
     {
       "idx": "PQ_2",
@@ -122,7 +123,8 @@
       "q0": 0.9861,
       "vmax": 1.1,
       "vmin": 0.9,
-      "owner": null
+      "owner": null,
+      "ctrl": 1.0
     },
     {
       "idx": "PQ_3",
@@ -134,7 +136,8 @@
       "q0": 1.3147,
       "vmax": 1.1,
       "vmin": 0.9,
-      "owner": null
+      "owner": null,
+      "ctrl": 1.0
     }
   ],
   "PV": [
@@ -286,7 +289,7 @@
     {
       "idx": 0,
       "u": 1.0,
-      "name": "Line 1-2",
+      "name": "Line AB",
       "bus1": 0,
       "bus2": 1,
       "Sn": 100.0,
@@ -304,9 +307,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 4.0,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -316,7 +319,7 @@
     {
       "idx": 1,
       "u": 1.0,
-      "name": "Line 1-4",
+      "name": "Line AD",
       "bus1": 0,
       "bus2": 3,
       "Sn": 100.0,
@@ -334,9 +337,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 0.0,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -346,7 +349,7 @@
     {
       "idx": 2,
       "u": 1.0,
-      "name": "Line 1-5",
+      "name": "Line AE",
       "bus1": 0,
       "bus2": 4,
       "Sn": 100.0,
@@ -364,9 +367,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 0.0,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -376,7 +379,7 @@
     {
       "idx": 3,
       "u": 1.0,
-      "name": "Line 2-3",
+      "name": "Line BC",
       "bus1": 1,
       "bus2": 2,
       "Sn": 100.0,
@@ -394,9 +397,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 0.0,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -406,7 +409,7 @@
     {
       "idx": 4,
       "u": 1.0,
-      "name": "Line 3-4",
+      "name": "Line CD",
       "bus1": 2,
       "bus2": 3,
       "Sn": 100.0,
@@ -424,9 +427,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 0.0,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -436,7 +439,7 @@
     {
       "idx": 5,
       "u": 1.0,
-      "name": "Line 4-5",
+      "name": "Line DE",
       "bus1": 3,
       "bus2": 4,
       "Sn": 100.0,
@@ -454,9 +457,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 2.4,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -466,7 +469,7 @@
     {
       "idx": 6,
       "u": 1.0,
-      "name": "Line 1-2 (2)",
+      "name": "Line AB2",
       "bus1": 0,
       "bus2": 1,
       "Sn": 100.0,
@@ -484,9 +487,9 @@
       "trans": 0.0,
       "tap": 1.0,
       "phi": 0.0,
-      "rate_a": 999.0,
-      "rate_b": 999.0,
-      "rate_c": 999.0,
+      "rate_a": 4.0,
+      "rate_b": 0.0,
+      "rate_c": 0.0,
       "owner": null,
       "xcoord": null,
       "ycoord": null,
@@ -583,7 +586,7 @@
       "csu": 0.0,
       "csd": 0.0,
       "c2": 0.0,
-      "c1": 1450.0,
+      "c1": 0.145,
       "c0": 0.0
     },
     {
@@ -595,7 +598,7 @@
       "csu": 0.0,
       "csd": 0.0,
       "c2": 0.0,
-      "c1": 3000.0,
+      "c1": 0.3,
       "c0": 0.0
     },
     {
@@ -607,7 +610,7 @@
       "csu": 0.0,
       "csd": 0.0,
       "c2": 0.0,
-      "c1": 4000.0,
+      "c1": 0.4,
       "c0": 0.0
     },
     {
@@ -619,7 +622,7 @@
       "csu": 0.0,
       "csd": 0.0,
       "c2": 0.0,
-      "c1": 3000.0,
+      "c1": 0.1,
       "c0": 0.0
     }
   ],
@@ -717,6 +720,29 @@
       "cnsr": 0.1
     }
   ],
+  "DCost": [
+    {
+      "idx": "DCost_1",
+      "u": 1.0,
+      "name": "Dcost 1",
+      "pq": "PQ_1",
+      "cdp": 1000.0
+    },
+    {
+      "idx": "DCost_2",
+      "u": 1.0,
+      "name": "Dcost 2",
+      "pq": "PQ_2",
+      "cdp": 1000.0
+    },
+    {
+      "idx": "DCost_3",
+      "u": 1.0,
+      "name": "Dcost 3",
+      "pq": "PQ_3",
+      "cdp": 1000.0
+    }
+  ],
   "EDTSlot": [
     {
       "idx": "EDT1",