Skip to content

Commit

Permalink
git subrepo pull --branch=release most
Browse files Browse the repository at this point in the history
subrepo:
  subdir:   "most"
  merged:   "9fcde150"
upstream:
  origin:   "git@github.com:MATPOWER/most"
  branch:   "release"
  commit:   "9fcde150"
git-subrepo:
  version:  "0.3.1"
  origin:   "https://github.com/ingydotnet/git-subrepo"
  commit:   "a7ee886"
  • Loading branch information
rdzman committed Oct 31, 2018
1 parent b3add98 commit e7fb4ed
Show file tree
Hide file tree
Showing 13 changed files with 456 additions and 314 deletions.
6 changes: 3 additions & 3 deletions most/.gitrepo
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
;
[subrepo]
remote = git@github.com:MATPOWER/most
branch = master
commit = 3378b9996f3d006692cbcc528a30353c701537f7
parent = b9cda2ec96444bac77be396cb886389f5fd3929d
branch = release
commit = 9fcde1505da5d4ead091a8abc21530ad6ef383b7
parent = b3add98e9784c61f7025a4d70540189cb41ed7f3
cmdver = 0.3.1
13 changes: 11 additions & 2 deletions most/CHANGES.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,17 @@ Change history for MOST
=======================


Since last release
------------------
Version 1.0.1 - *Oct 30, 2016*
------------------------------

#### 10/30/18
- Release 1.0.1.

#### 10/26/18
- **INCOMPATIBLE CHANGE**: Failure of the optimization no longer
halts execution and jumps to the debugger.
- Add `success` flag to `md.results` output MOST Data struct to
indicate success or failure of optimization.

#### 3/19/18
- Fix bugs in `plot_uc_data()` resulting in incorrect legends.
Expand Down
2 changes: 1 addition & 1 deletion most/LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The following is the official license notice:

--------------------------------------------------------------------------

Copyright (c) 1996-2016, Power Systems Engineering Research Center (PSERC)
Copyright (c) 1996-2018, Power Systems Engineering Research Center (PSERC)
and individual contributors (see AUTHORS file for details).
All rights reserved.

Expand Down
81 changes: 44 additions & 37 deletions most/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ power flow and optimal power flow problems.
System Requirements
-------------------

* [MATLAB][3] version 7.3 (R2006b) or later, or
* [GNU Octave][4] version 4.0 or later
* [MATPOWER][5] version 6 or later,
* [MP-Test][6], for running the MOST test suite (included with [MATPOWER][5])
* A good LP/MILP, QP/MIQP solver, such as Gurobi, CPLEX, MOSEK, MATLAB's
Optimization Toolbox, or GLPK (included with Octave).
This version of MOST requires:
* [MATPOWER][2] version 7.x or later, _(see MATPOWER system requirements
for details of required versions of [MATLAB][4] or [GNU Octave][5])_
* _(highly recommended)_ A high-performance LP/MILP, QP/MIQP solver,
such as Gurobi, CPLEX, MOSEK, MATLAB's Optimization Toolbox, or GLPK
_(included with Octave)_.


Installation
Expand All @@ -41,14 +41,14 @@ The preferred method of installation is simply to install [MATPOWER][3],
which is a prerequisite for MOST and also includes its own copy of MOST.

If you have followed the directions for installing MATPOWER found in
the [MATPOWER User's Manual][7], then MOST should already be installed and
the [MATPOWER User's Manual][6], then MOST should already be installed and
the appropriate paths added to your MATLAB path.

To run the test suite and verify that MOST is properly installed and
functioning, at the MATLAB prompt, type `test_most`. The result
should resemble the following, possibly including extra tests,
depending on the availablility of optional packages:
```matlab
```
>> test_most
t_most_3b_1_1_0........ok
t_most_3b_3_1_0........ok
Expand All @@ -59,14 +59,14 @@ t_most_30b_3_1_0.......ok
t_most_30b_1_1_17......ok
t_most_30b_3_1_17......ok
t_most_fixed_res.......ok
t_most_w_ds............ok
t_most_30b_1_1_0_uc....ok
t_most_sp..............ok
t_most_spuc............ok (576 of 720 skipped)
t_most_uc..............ok (208 of 260 skipped)
t_most_suc.............ok (148 of 185 skipped)
All tests successful (762 passed, 932 skipped of 1694)
Elapsed time 93.13 seconds.
t_most_spuc............ok (432 of 720 skipped)
t_most_uc..............ok (156 of 260 skipped)
t_most_suc.............ok (111 of 185 skipped)
t_most_w_ds............ok
All tests successful (995 passed, 699 skipped of 1694)
Elapsed time 84.68 seconds.
```

If, for some reason, you prefer to install your own copy of MOST directly
Expand All @@ -85,7 +85,7 @@ Documentation
-------------

There are two primary sources of documentation for MOST. The first is
the [MOST User's Manual][8], which gives an overview of the capabilities
the [MOST User's Manual][7], which gives an overview of the capabilities
and structure of MOST and describes the problem formulation. It
can be found in your MATPOWER distribution at `<MATPOWER>/most/docs/MOST-manual.pdf`
and the latest version is always available at:
Expand All @@ -104,61 +104,68 @@ Publications

1. R. D. Zimmerman, C. E. Murillo-Sanchez, and R. J. Thomas,
["MATPOWER: Steady-State Operations, Planning and Analysis Tools
for Power Systems Research and Education,"][12] *Power Systems, IEEE
for Power Systems Research and Education,"][9] *Power Systems, IEEE
Transactions on*, vol. 26, no. 1, pp. 12–19, Feb. 2011.
DOI: [10.1109/TPWRS.2010.2051168][11].
DOI: [10.1109/TPWRS.2010.2051168][9].

2. C. E. Murillo-Sanchez, R. D. Zimmerman, C. L. Anderson, and
R. J. Thomas, ["Secure Planning and Operations of Systems with
Stochastic Sources, Energy Storage and Active Demand,"][12]
*Smart Grid, IEEE Transactions on*, vol. 4, no. 4, pp. 2220–2229,
Dec. 2013.
DOI: [10.1109/TSG.2013.2281001][12].
R. J. Thomas, ["Secure Planning and Operations of Systems with
Stochastic Sources, Energy Storage and Active Demand,"][10]
*Smart Grid, IEEE Transactions on*, vol. 4, no. 4, pp. 2220–2229,
Dec. 2013.
DOI: [10.1109/TSG.2013.2281001][10].

3. A. J. Lamadrid, D. Munoz-Alvarez, C. E. Murillo-Sanchez,
R. D. Zimmerman, H. D. Shin and R. J. Thomas, ["Using the MATPOWER
Optimal Scheduling Tool to Test Power System Operation Methodologies
Under Uncertainty,"][11] *Sustainable Energy, IEEE Transactions on*,
2018.
DOI: [10.1109/TSTE.2018.2865454][11].


Citing MATPOWER and MOST
------------------------

We request that publications derived from the use of MATPOWER explicitly
acknowledge that fact by citing [reference \[1\]][11] above, namely:
acknowledge that fact by citing [reference \[1\]][9] above, namely:

> R. D. Zimmerman, C. E. Murillo-Sanchez, and R. J. Thomas,
"MATPOWER: Steady-State Operations, Planning and Analysis Tools
for Power Systems Research and Education," Power Systems, IEEE
Transactions on, vol. 26, no. 1, pp. 12–19, Feb. 2011.
for Power Systems Research and Education," *Power Systems, IEEE
Transactions on*, vol. 26, no. 1, pp. 12–19, Feb. 2011.

Additionally, we request that publications derived from the use of
the [MATPOWER Optimal Scheduling Tool (MOST)][1], explicitly
acknowledge that fact by citing [reference \[2\]][12] as well as [\[1\]][11].
acknowledge that fact by citing [reference \[2\]][10] as well as [\[1\]][9].

> C. E. Murillo-Sanchez, R. D. Zimmerman, C. L. Anderson, and
R. J. Thomas, "Secure Planning and Operations of Systems with
Stochastic Sources, Energy Storage and Active Demand," Smart Grid,
IEEE Transactions on, vol. 4, no. 4, pp. 2220–2229, Dec. 2013.
Stochastic Sources, Energy Storage and Active Demand," *Smart Grid,
IEEE Transactions on*, vol. 4, no. 4, pp. 2220–2229, Dec. 2013.


Contributing
------------

Please see our [contributing guidelines][9] for details on how to
Please see our [contributing guidelines][8] for details on how to
contribute to the project or report issues.


License
-------

MOST is distributed under the [3-clause BSD license][10].
MOST is distributed under the [3-clause BSD license][12].

----
[1]: https://github.com/MATPOWER/most
[2]: http://www.pserc.cornell.edu/matpower/
[3]: https://github.com/MATPOWER/matpower
[4]: http://www.mathworks.com/
[5]: https://www.gnu.org/software/octave/
[6]: https://github.com/MATPOWER/mptest
[7]: https://github.com/MATPOWER/matpower/blob/master/docs/MATPOWER-manual.pdf
[8]: https://github.com/MATPOWER/most/blob/master/docs/MOST-manual.pdf
[9]: CONTRIBUTING.md
[10]: LICENSE
[11]: https://doi.org/10.1109/TPWRS.2010.2051168
[12]: https://doi.org/10.1109/TSG.2013.2281001
[6]: https://github.com/MATPOWER/matpower/blob/master/docs/MATPOWER-manual.pdf
[7]: https://github.com/MATPOWER/most/blob/master/docs/MOST-manual.pdf
[8]: CONTRIBUTING.md
[9]: https://doi.org/10.1109/TPWRS.2010.2051168
[10]: https://doi.org/10.1109/TSG.2013.2281001
[11]: https://doi.org/10.1109/TSTE.2018.2865454
[12]: LICENSE
Binary file modified most/docs/MOST-manual.pdf
Binary file not shown.
31 changes: 31 additions & 0 deletions most/docs/relnotes/MOST-Release-Notes-1.0.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
What's New in MOST 1.0.1
------------------------

#### Released Oct 30, 2018

Below is a summary of the changes since version 1.0 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].

#### Bugs Fixed:
- Fix bugs in `plot_uc_data()` resulting in incorrect legends.
- Fix dimension of `RampWear` cost indexing if `mdi.OpenEnded` is true.
- Add missing constant term to objective function value reported by
`most_summary`.

#### Other Changes:
- LaTeX source code for [MOST User's Manual][2] included in `docs/src`.
- Updated to use OOP notation for `opt_model` object, and avoid calls
to deprecated methods, using `init_indexed_name()` and
`add_lin_constraint()` instead.
- Updated to use MATPOWER's new quadratic costs in `opt_model` in
place of the legacy cost model.

#### Incompatible Changes:
- Failure of the optimization no longer halts execution and jumps to
the debugger.
- Requires MATPOWER 7.x or later.


[1]: ../../CHANGES.md
[2]: ../MOST-manual.pdf
Loading

0 comments on commit e7fb4ed

Please sign in to comment.