Release 7.1

CHANGES.md

@@ -9,10 +9,11 @@ For change history for [MIPS][2], see [mips/CHANGES.md](mips/CHANGES.md).
 For change history for [MOST][3], see [most/CHANGES.md](most/CHANGES.md).
 
 
-Changes since 7.0
------------------
+Version 7.1 - *Oct 8, 2020*
+---------------------------
 
 #### 10/8/20
+  - Release 7.1.
   - Update to [MP-Test][1] 7.1.
   - Update to [MIPS][2] 1.4.
   - Update to [MP-Opt-Model][27] 3.0.
@@ -30,6 +31,8 @@ Changes since 7.0
     - `'smartmarket'`
     - `'syngrid'`
     - `'tralmopf'`
+  - Add support for [OSQP][29], if installed, to solve the DC OPF, by setting
+    `opf.dc.solver` to `'OSQP'`.
 
 #### 10/1/20
   - **INCOMPATIBLE CHANGE:**  Update `case18`, `case22`, `case69`, `case85`
@@ -3143,3 +3146,4 @@ First Public Release – *Jun 25, 1997*
 [26]: https://github.com/MATPOWER/matpower/issues/89
 [27]: https://github.com/MATPOWER/mp-opt-model
 [28]: http://www.convexoptimization.com/wikimization/index.php/Gurobi_mex
+[29]: https://osqp.org

CITATION

@@ -40,11 +40,11 @@ corresponding case files.
 
 For the sake of reproducibility of research results, it is best to cite
 the specific version of the software used with the version-specfic DOI.
-For example, for version 7.0 of MATPOWER, use:
+For example, for version 7.1 of MATPOWER, use:
 
-  R. D. Zimmerman, C. E. Murillo-Sanchez (2019). MATPOWER (Version 7.0)
+  R. D. Zimmerman, C. E. Murillo-Sanchez (2020). MATPOWER (Version 7.1)
   [Software]. Available: https://matpower.org
-  doi: 10.5281/zenodo.3251119
+  doi: 10.5281/zenodo.4074135
 
 To cite the MATPOWER software generally, without reference to a specific
 version, use the following citation and DOI, with <YEAR> replaced by the
@@ -62,13 +62,13 @@ found via the general DOI at https://doi.org/10.5281/zenodo.3236535.
 The MATPOWER, MIPS and MOST User's Manuals should also be cited
 explicitly in work that refers to or is derived from their content. As
 with the software, the citation and DOI can be version-specific or
-general, as appropriate. For version 7.0 of the MATPOWER User's Manual,
+general, as appropriate. For version 7.1 of the MATPOWER User's Manual,
 use:
 
   R. D. Zimmerman, C. E. Murillo-Sanchez. MATPOWER User's Manual,
-  Version 7.0. 2019. [Online].
-  Available: https://matpower.org/docs/MATPOWER-manual-7.0.pdf
-  doi: 10.5281/zenodo.3251118
+  Version 7.1. 2020. [Online].
+  Available: https://matpower.org/docs/MATPOWER-manual-7.1.pdf
+  doi: 10.5281/zenodo.4074122
 
 For a version non-specific citation, use the following citation and DOI,
 with <YEAR> replaced by the year of the most recent release:

LICENSE

@@ -8,7 +8,7 @@ The following is the official license notice:
 
 --------------------------------------------------------------------------
 
-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

@@ -326,11 +326,11 @@ corresponding case files.
 
 For the sake of reproducibility of research results, it is best to cite
 the specific version of the software used, with the version-specfic DOI.
-For example, for version 7.0 of MATPOWER, use:
+For example, for version 7.1 of MATPOWER, use:
 
->   R. D. Zimmerman, C. E. Murillo-Sanchez (2019). *MATPOWER (Version 7.0)*
+>   R. D. Zimmerman, C. E. Murillo-Sanchez (2020). *MATPOWER (Version 7.1)*
     [Software]. Available: https://matpower.org  
-    doi: [10.5281/zenodo.3251119](https://doi.org/10.5281/zenodo.3251119)
+    doi: [10.5281/zenodo.4074135](https://doi.org/10.5281/zenodo.4074135)
 
 To cite the MATPOWER software generally, without reference to a specific
 version, use the following citation and DOI, with *\<YEAR\>* replaced by the
@@ -348,13 +348,13 @@ found via the general DOI at https://doi.org/10.5281/zenodo.3236535.
 The MATPOWER, MIPS and MOST User's Manuals should also be cited
 explicitly in work that refers to or is derived from their content. As
 with the software, the citation and DOI can be version-specific or
-general, as appropriate. For version 7.0 of the [MATPOWER User's Manual][8],
+general, as appropriate. For version 7.1 of the [MATPOWER User's Manual][8],
 use:
 
 >   R. D. Zimmerman, C. E. Murillo-Sanchez. *MATPOWER User's Manual,
-    Version 7.0.* 2019.  
-    [Online]. Available: https://matpower.org/docs/MATPOWER-manual-7.0.pdf  
-    doi: [10.5281/zenodo.3251118](https://doi.org/10.5281/zenodo.3251118)
+    Version 7.1.* 2020.  
+    [Online]. Available: https://matpower.org/docs/MATPOWER-manual-7.1.pdf  
+    doi: [10.5281/zenodo.4074122](https://doi.org/10.5281/zenodo.4074122)
 
 For a version non-specific citation, use the following citation and DOI,
 with *\<YEAR\>* replaced by the year of the most recent release:

docs/relnotes/MATPOWER-Announce-7.1.md

@@ -0,0 +1,61 @@
+What's New in MATPOWER 7.1
+--------------------------
+
+#### Released Oct 8, 2020
+
+Below are some of the highlights of the changes since version 7.0 of
+MATPOWER. See the [full release notes][1] and the [`CHANGES.md`][2]
+file for more details. For release notes for previous versions, see
+Appendix H of the [MATPOWER User's Manual][3].
+
+#### New Features:
+- Core optimization model and solver interfaces released as separate
+  package (included), [MP-Opt-Model][4] 3.0, bringing many enhancements:
+  - Support for new QP solver [OSQP][5] for DC OPF
+  - New unified interfaces for nonlinear programming and nonlinear equation
+    solvers
+  - Many new features of the `opt_model` class, including a `solve()`
+    method that selects and calls the appropriate solver based on the
+    automatically detected problem type, and methods for extracting
+    specific variables, costs, constraint values and shadow prices, etc.
+    from a solved model
+  - Performance improvements
+- [MP-Test][6] 7.1, with new modular, extensible `have_feature()` function
+  for detecting optional functionality
+- New options and speed improvements for computing shift factors.
+- Numerous new functions and program options.
+
+#### New Case Files:
+- Nineteen new distribution system cases \[[ref 1][7], [ref 2][8]\].
+  *Thanks to Houssem Bouchekara, et. al.*
+
+#### New Documentation:
+- New [MP-Opt-Model User's Manual][9], included in `mp-opt-model/docs`.
+
+#### Other Improvements:
+- New implementation of Newton power flow for cartesian voltage
+  representations.
+- Improved robustness of Newton power flow with hybrid voltage updates.
+- Significant performance improvement for CPLEX on small DC OPF problems.
+- Update versions of included packages:
+  - MIPS 1.4.
+  - MOST 1.1.
+  - MP-Test 7.1.
+- Numerous bug fixes.
+
+#### Incompatible Changes:
+- Update `case18`, `case22`, `case69`, `case85` and `case141` to more closely
+  match data from original papers, thanks in part to case files contributed
+  by Houssem Bouchekara, et al. Solutions for updated cases may not match
+  exactly. See help text in case files for details.
+
+
+[1]: MATPOWER-Release-Notes-7.1.md
+[2]: ../../CHANGES.md
+[3]: ../MATPOWER-manual.pdf
+[4]: https://github.com/MATPOWER/mp-opt-model
+[5]: https://osqp.org
+[6]: https://github.com/MATPOWER/mptest
+[7]: https://doi.org/10.18799/24056537/2019/3/196
+[8]: https://doi.org/10.36227/techrxiv.12578648.v1
+[9]: https://matpower.org/docs/MP-Opt-Model-manual-3.0.pdf