Release 1.3.1.

Author: rdzman

CHANGES.md

@@ -2,11 +2,15 @@ Change history for MOST
 =======================
 
 
-since 1.3
----------
+Version 1.3.1 - *Jul 7, 2025*
+-----------------------------
+
+#### 7/7/25
+  - Release 1.3.1.
 
 #### 5/23/25
-  - Include HiGHS solver, if available in unit commitment tests.
+  - Include [HiGHS][13] solver (via [HiGHSMEX][14] interface), if
+    available, in unit commitment tests.
 
 #### 3/19/25
   - Fix issue caused by tiny non-zero values for commitment variables.
@@ -364,3 +368,5 @@ Version 1.0 - *Jun 1, 2016*
 [10]: https://github.com/MATPOWER/most/issues/39
 [11]: https://github.com/MATPOWER/mp-opt-model
 [12]: https://github.com/MATPOWER/most/issues/45
+[13]: https://highs.development
+[14]: https://github.com/savyasachi/HiGHSMEX

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.3, use:
+For version 1.3.1, use:
 
   R. D. Zimmerman, C. E. Murillo-Sanchez. MATPOWER Optimal Scheduling
-  Tool (MOST) User's Manual, Version 1.3. 2024. [Online].
-  Available: https://matpower.org/docs/MOST-manual-1.3.pdf
-  doi: 10.5281/zenodo.11177189
+  Tool (MOST) User's Manual, Version 1.3.1. 2025. [Online].
+  Available: https://matpower.org/docs/MOST-manual-1.3.1.pdf
+  doi: 10.5281/zenodo.15829809
 
 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-2024, Power Systems Engineering Research Center (PSERC)
+Copyright (c) 1996-2025, Power Systems Engineering Research Center (PSERC)
 and individual contributors (see AUTHORS file for details).
 All rights reserved.
 

README.md

@@ -57,12 +57,12 @@ t_most_30b_3_1_0.......ok
 t_most_fixed_res.......ok
 t_most_30b_1_1_0_uc....ok
 t_most_mpopf...........ok
-t_most_uc..............ok (272 of 340 skipped)
-t_most_suc.............ok (148 of 185 skipped)
+t_most_uc..............ok (345 of 414 skipped)
+t_most_suc.............ok (185 of 222 skipped)
 t_most_tlmp............ok
 t_most_w_ds............ok
-All tests successful (359 passed, 420 skipped of 779)
-Elapsed time 39.45 seconds.
+All tests successful (360 passed, 530 skipped of 890)
+Elapsed time 15.92 seconds.
 ```
 
 If, for some reason, you prefer to install your own copy of MOST directly
@@ -141,12 +141,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.3, use:
+appropriate. For version 1.3.1, use:
 
 >   R. D. Zimmerman, C. E. Murillo-Sanchez. *MATPOWER Optimal Scheduling
-    Tool (MOST) User's Manual, Version 1.3*. 2024. [Online].
-    Available: https://matpower.org/docs/MOST-manual-1.3.pdf  
-    doi: [10.5281/zenodo.11177189](https://doi.org/10.5281/zenodo.11177189)
+    Tool (MOST) User's Manual, Version 1.3.1*. 2025. [Online].
+    Available: https://matpower.org/docs/MOST-manual-1.3.1.pdf  
+    doi: [10.5281/zenodo.15829809](https://doi.org/10.5281/zenodo.15829809)
 
 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

@@ -31,10 +31,11 @@ Pre-release
     - `mp-docs-shared/prolog.rst.txt` - in URL in raw-html for |MOSTman|
 - In `README.md` and `docs/src/MOST-manual/MOST-manual.tex`
   - update output of `test_most` in Section 2.2
-    - may require first doing:
+    - may require first doing (to disable all solvers except Gurobi):
       ```matlab
         have_feature('cplex', 0);
         have_feature('glpk', 0);
+        have_feature('highs', 0);
         have_feature('intlinprog', 0);
         have_feature('mosek', 0);
         rmpath('/Users/ray/dev/projects/sopf/dist');
@@ -61,7 +62,7 @@ Pre-release
   - Make updates for current version specific citations:
     - version number (3 places)
     - year
-    - latest version DOI, current is: 10.5281/zenodo.11177189
+    - latest version DOI, current is: 10.5281/zenodo.15829809
       - (update here each time)
     ... in the following places ...
     - CITATION file

docs/other/MOST-Release-Checklist.md

@@ -0,0 +1,37 @@
+What's New in MOST 1.3.1
+------------------------
+
+#### Released Jul 7, 2025
+
+Below is a summary of the changes since version 1.3 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:
+  - `most_summary()` now skips display of non-existent contingencies.
+  - Include [HiGHS](https://highs.dev) solver (via
+    [HiGHSMEX](https://github.com/savyasachi/HiGHSMEX) interface), if
+    available, in unit commitment tests.
+
+#### Bugs Fixed:
+  - Fix [issue #45][3] where `most()` does not properly handle cases with
+    contingencies defined only in some periods/scenarios.
+    *Thanks to Stefano Nicolin.*
+  - Fix issue with `most_summary()` when ramp results are missing.
+  - Tweak tests to work around bug in HiGHS-based `linprog` and
+    `intlinprog` in Optimization Toolbox R2024a and R2024b.
+  - Fix issue caused by tiny non-zero values for commitment variables.
+    Don't count on MP-Opt-Model's `miqps_<solver>()` functions to round
+    integer variable solutions.
+
+#### PRO Version
+  - There is now a PRO version of MOST that adds support for MATPOWER DC
+    lines as described in Section 7.6.3 of the [MATPOWER User's Manual][4].
+    Please contact [info@matpower.org](mailto:info@matpower.org?subject=MOST%20Pro&body=Please%20send%20me%20information%20on%20obtaining%20MOST%20Pro.)
+    for information on obtaining this version.
+
+
+[1]: ../../CHANGES.md
+[2]: ../MOST-manual.pdf
+[3]: https://github.com/MATPOWER/most/issues/45
+[4]: https://matpower.org/docs/MATPOWER-manual-8.1.pdf

docs/relnotes/MOST-Release-Notes-1.3.1.md

@@ -22,7 +22,7 @@
 author = 'Ray D. Zimmerman, Carlos E. Murillo-Sánchez'
 
 # The full version, including alpha/beta/rc tags
-release = '1.3'
+release = '1.3.1'
 
 
 # -- General configuration ---------------------------------------------------