Release 1.1

Author: rdzman

CHANGES.md

@@ -2,10 +2,13 @@ Change history for MOST
 =======================
 
 
-Changes since 1.0.2
--------------------
+Version 1.1 - *Oct 8, 2020*
+---------------------------
+
+*Requires MATPOWER with 7.1 or later (for MP-Opt-Model 3.0 or later).*
 
-*Requires MATPOWER with 7.1 or later (for MP-Opt-Model 2.2 or later).*
+#### 10/8/20
+  - Release 1.1.
 
 #### 9/9/20
   - Use `@opt_model/get_soln()` to extract variable and shadow price

CITATION

@@ -17,12 +17,12 @@ Scheduling Tool (MOST) explicitly acknowledge that fact by citing both the
 The MATPOWER Optimal Scheduling Tool (MOST) User's Manual should also be
 cited explicitly in work that refers to or is derived from its content.
 The citation and DOI can be version-specific or general, as appropriate.
-For version 1.0.2, use:
+For version 1.1, use:
 
   R. D. Zimmerman, C. E. Murillo-Sanchez. MATPOWER Optimal Scheduling
-  Tool (MOST) User's Manual, Version 1.0.2. 2019. [Online].
-  Available: https://matpower.org/docs/MOST-manual-1.0.2.pdf
-  doi: 10.5281/zenodo.3251047
+  Tool (MOST) User's Manual, Version 1.1. 2020. [Online].
+  Available: https://matpower.org/docs/MOST-manual-1.1.pdf
+  doi: 10.5281/zenodo.4073878
 
 For a version non-specific citation, use the following citation and DOI,
 with <YEAR> replaced by the year of the most recent release:

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 1996-2019, Power Systems Engineering Research Center (PSERC)
+Copyright (c) 1996-2020, Power Systems Engineering Research Center (PSERC)
 and individual contributors (see AUTHORS file for details).
 All rights reserved.
 

README.md

@@ -56,11 +56,12 @@ t_most_30b_1_1_0.......ok
 t_most_30b_3_1_0.......ok
 t_most_fixed_res.......ok
 t_most_30b_1_1_0_uc....ok
-t_most_uc..............ok
-t_most_suc.............ok
+t_most_mpopf...........ok
+t_most_uc..............ok (264 of 330 skipped)
+t_most_suc.............ok (148 of 185 skipped)
 t_most_w_ds............ok
-All tests successful (615 of 615)
-Elapsed time 84.68 seconds.
+All tests successful (310 passed, 412 skipped of 722)
+Elapsed time 46.18 seconds.
 ```
 
 If, for some reason, you prefer to install your own copy of MOST directly
@@ -139,12 +140,12 @@ citing both the 2011 MATPOWER paper and the 2013 MOST paper.
 The [MATPOWER Optimal Scheduling Tool (MOST) User's Manual][7] should
 also be cited explicitly in work that refers to or is derived from its
 content. The citation and DOI can be version-specific or general, as
-appropriate. For version 1.0.2, use:
+appropriate. For version 1.1, use:
 
 >   R. D. Zimmerman, C. E. Murillo-Sanchez. *MATPOWER Optimal Scheduling
-    Tool (MOST) User's Manual, Version 1.0.2*. 2019. [Online].
-    Available: https://matpower.org/docs/MOST-manual-1.0.2.pdf  
-    doi: [10.5281/zenodo.3251047](https://doi.org/10.5281/zenodo.3251047)
+    Tool (MOST) User's Manual, Version 1.1*. 2020. [Online].
+    Available: https://matpower.org/docs/MOST-manual-1.1.pdf  
+    doi: [10.5281/zenodo.4073878](https://doi.org/10.5281/zenodo.4073878)
 
 For a version non-specific citation, use the following citation and DOI,
 with *\<YEAR\>* replaced by the year of the most recent release:

docs/MOST-manual.pdf

@@ -0,0 +1,48 @@
+What's New in MOST 1.1
+----------------------
+
+#### Released Oct 8, 2020
+
+Below is a summary of the changes since version 1.0.2 of MOST. See the
+[`CHANGES.md`][1] file for all the gory details. For release notes for
+previous versions, see Appendix B of the [MOST User's Manual][2].
+
+#### Changes:
+  - Requires [MATPOWER][4] 7.1 or later.
+  - Output of `most_summary()` includes sections for fixed loads and for
+    expected stored energy for storage units.
+  - Relies on [MP-Opt-Model][3] 3.0, which can be found at
+    https://github.com/MATPOWER/mp-opt-model and is included in
+    [MATPOWER][4] 7.1.
+    - Significant performance improvement for some problems when constructing
+    sparse matrices for linear constraints or quadratic costs (e.g. during
+    problem setup).
+    *Thanks to Daniel Muldrew.*
+    - Uses the `@opt_model/solve()` method rather than calling
+      `miqps_matpower()` or `qps_matpower()` directly.
+    - Uses the `@opt_model/get_soln()` method to extract variable and shadow
+      price results, rather than doing the indexing manually.
+
+#### Bugs Fixed:
+  - Fix bug [#6][5] where building a model without solving it, or solving a
+    previously built model resulted in a fatal error.
+    *Thanks to Baraa Mohandes.*
+  - Fix bug [#11][6] where storage constraints were not correct for
+    `t=1` and `rho` not equal to 1. *Thanks to Baraa Mohandes.*
+  - Fix issue [#16][7], where the `om` field of the output MOST data struct
+    (`mdo`) was a handle to the same object as as the `om` field of the
+    input MOST data struct (`mdi`), meaning that changing one would modify
+    the other. *Thanks to Baraa Mohandes.*
+
+#### Incompatible Changes:
+  - Objective function value returned in `mdo.QP.f` updated to include the
+    previously missing constant term.
+
+
+[1]: ../../CHANGES.md
+[2]: ../MOST-manual.pdf
+[3]: https://github.com/MATPOWER/mp-opt-model
+[4]: https://github.com/MATPOWER/matpower
+[5]: https://github.com/MATPOWER/most/issues/6
+[6]: https://github.com/MATPOWER/most/issues/11
+[7]: https://github.com/MATPOWER/most/issues/16