-
Notifications
You must be signed in to change notification settings - Fork 155
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
19 changed files
with
819 additions
and
373 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -59,13 +59,6 @@ Pre-release | |
| - `\mpver` (update `\mptestver`, `\mpomver`, `\mipsver`, `\mostver`, `\sdpopfver` and `\syngridver` too) | ||
| - do search for all possible old versions 6.1-dev, 7.0b1 | ||
| - Copyright line in `LICENSE`. | ||
| - Update Docker files | ||
| - follow instructions in `docker/Docker-Build-Notes.md` for new Octave | ||
| images, if applicable | ||
| - update value listed for _current release_ of MATPOWER in **Versions** section | ||
| of `docker/MATPOWER-Docker.md`, and add new rows to table. | ||
| - add lines in `build_matpower_images.sh` for new MATPOWER version | ||
| - build and test a new "local" image with MATPOWER Extras installed | ||
| - In `docs/src/MATPOWER-manual/MATPOWER-manual.tex` | ||
| - update output of: | ||
| - `test_matpower` (Section 2.3, Step 3), use `test_matpower_no_options` | ||
|
|
@@ -79,7 +72,7 @@ Pre-release | |
| - Make updates for current version specific citations: | ||
| - version number (3 places) | ||
| - year | ||
| - latest version DOI, current is: 10.5281/zenodo.4074122 | ||
| - latest version DOI, current is: 10.5281/zenodo.11212313 | ||
| - (update here each time) | ||
| ... in the following places ... | ||
| - CITATION file | ||
|
|
@@ -97,7 +90,7 @@ Pre-release | |
| - Make updates for current version specific citations: | ||
| - version number (2 places) | ||
| - year | ||
| - latest version DOI, current is: 10.5281/zenodo.4074135 | ||
| - latest version DOI, current is: 10.5281/zenodo.11212330 | ||
| - (update here each time) | ||
| ... in the following places ... | ||
| - CITATION file | ||
|
|
@@ -111,34 +104,40 @@ Pre-release | |
| - e.g. MIPS, MOST, SynGrid, MP-Sim, sopf1 manuals, TN2, TN3, TN4 | ||
| - Copy latest `MIPS-manual.aux`, `MP-Opt-Model-manual.aux`, `MOST-manual.aux` | ||
| to `docs/src/MATPOWER-manual` for `\externaldocument` | ||
| - Create `MATPOWER-manual.pdf` from `MATPOWER-manual.tex` | ||
| - move to `docs` | ||
| - make copy named `MATPOWER-manual-x.x.pdf` | ||
| - copy to `docs` directory of `matpower.org-static` git repo | ||
| - update `MATPOWER-manual.pdf` symlink on `https://matpower.org/docs/` to point | ||
| to new `MATPOWER-manual-x.x.pdf` (replaces existing current version) | ||
| - `cd dev/projects/matpower.org-static/docs` | ||
| - `rm MATPOWER-manual.pdf` | ||
| - `ln -s ./MATPOWER-manual-x.x.pdf MATPOWER-manual.pdf` | ||
| - commit & push, then pull to matpower.org | ||
| - upload `MATPOWER-manual-x.x.pdf` to Zenodo and finish entry for "New Version" | ||
| - update: | ||
| - Publication date | ||
| - Version | ||
| - Identifiers: | ||
| - version number in "identical to" | ||
| - version specific DOI for "is documented by this upload" | ||
| - add link on `https://matpower.org/doc/manuals/` page | ||
| - Create `MATPOWER-manual.pdf` from `MATPOWER-manual.tex` and move to `docs`. | ||
| - Update Docker files | ||
| - follow instructions in `docker/Docker-Build-Notes.md` for new Octave | ||
| images, if applicable | ||
| - update value listed for _current release_ of MATPOWER in **Versions** section | ||
| of `docker/MATPOWER-Docker.md`, and add new rows to table. | ||
| - add lines in `build_matpower_images.sh` for new MATPOWER version | ||
| - build and test a new "local" image with MATPOWER Extras installed | ||
| - Add release notice with date and version in `CHANGES.md`. | ||
| - Commit all changes to `prep-for-release`. | ||
| - Push `prep-for-release` to GitHub. | ||
| - Make sure CI checks are ok. | ||
| - Make copy of `docs/MATPOWER-manual.pdf` named `MATPOWER-manual-x.x.pdf` | ||
| - copy to `docs` directory of `matpower.org-static` git repo | ||
| - update `MATPOWER-manual.pdf` symlink on `https://matpower.org/docs/` to point | ||
| to new `MATPOWER-manual-x.x.pdf` (replaces existing current version) | ||
| - `cd dev/projects/matpower.org-static/docs` | ||
| - `rm MATPOWER-manual.pdf` | ||
| - `ln -s ./MATPOWER-manual-x.x.pdf MATPOWER-manual.pdf` | ||
| - commit & push, then pull to matpower.org | ||
| - upload `MATPOWER-manual-x.x.pdf` to Zenodo and finish entry for "New Version" | ||
| - update: | ||
| - Publication date | ||
| - Version | ||
| - Identifiers: | ||
| - version number in "identical to" | ||
| - version specific DOI for "Documents" | ||
| - add link on `https://matpower.org/doc/manuals/` page | ||
|
|
||
|
|
||
| Release | ||
| ------- | ||
| - Merge latest `prep-for-release` into `master`. | ||
| - Tag with version number, e.g. `7.0b1`. | ||
| - Tag with version number, e.g. `8.0`. | ||
| - Push `master` to GitHub. | ||
| - create archive with MATPOWER-Extras | ||
| - `cd matpower/untracked/` | ||
|
|
@@ -190,6 +189,10 @@ Release | |
| - use "Releases" category | ||
| - update download counter file at [email protected]:/home4/rdzman/matpower.org-downloads | ||
| - add a column to the header line at the top of matpower-download-log.txt | ||
| - build latest MATPOWER Sphinx documentation | ||
| - commit to matpower-docs | ||
| - push | ||
| - pull to matpower.org | ||
| - MATLAB Central File Exchange | ||
| - https://www.mathworks.com/matlabcentral/fileexchange/72085-matpower/ | ||
| (this is currently just a link) | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,127 @@ | ||
| What's New in MATPOWER 8.0 | ||
| -------------------------- | ||
|
|
||
| #### Released May 17, 2024 | ||
|
|
||
| Below are some of the highlights of the changes since version 7.1 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]. | ||
|
|
||
|
|
||
| #### Major Redesign: | ||
|
|
||
| MATPOWER 8 introduces a major redesign and rewrite of all of the MATPOWER | ||
| internals in the form of the flexible, all-new MATPOWER object-oriented core | ||
| architecture (*MP-Core*) and new two user-level frameworks to access it. | ||
| *(Previously developed under the name [MP-Element][4] in a separate repository | ||
| at [https://github.com/MATPOWER/mp-element][4].)* | ||
|
|
||
| - *MP-Core* -- Provides unparalleled flexibility and customization capabilities | ||
| at all levels. Facilitates new modeling (e.g. unbalanced multiphase elements, | ||
| FACTS devices, etc.), new controls (e.g. optimization of transformer taps, | ||
| PAR angles, etc.), new problem formulations, and more. | ||
| - *Flexible Framework* -- Provides new top-level functions for running power | ||
| flow (PF), continuation power flow (CPF) and optimal power flow (OPF), along | ||
| with new MATPOWER Extension API for user access to the full customization | ||
| capability of MP-Core. | ||
| - *Legacy Framework* -- Allows MP-Core modeling to be used internally by | ||
| legacy functions, facilitating use of legacy test suite. | ||
|
|
||
| See the new [MATPOWER Developer's Manual][5], [MATPOWER Reference Manual][5a] | ||
| and [*MATPOWER Technical Note 5*][6] for details of the new architecture. The | ||
| User's Manual has not yet been updated for the flexible framework. | ||
|
|
||
|
|
||
| #### New Three-Phase and Hybrid Proof-of-Concept Examples | ||
|
|
||
| Prototype examples of PF, CPF, and OPF for: | ||
| - unbalanced three-phase models | ||
| - hybrid transmission (single-phase) / distribution (three-phase) models | ||
| - multiple problem formulations | ||
|
|
||
| **Note:** These are proof-of-concept only, with much work remaining to | ||
| define a full set of three-phase model elements and their respective | ||
| parameters and data formats. _But they do work!_ | ||
|
|
||
|
|
||
| #### New Features: | ||
|
|
||
| - [MIPS][7] 1.5.1 adds to `mplinsolve()` the ability to save an LU | ||
| factorization and reuse it to solve for additional right-hand sides. | ||
| - [MP-Opt-Model][7a] 4.2 adds support for tracing solution curves of | ||
| general parameterized nonlinear equations (PNE), providing generalized | ||
| continuation power flow (CPF) capabilities to MP-Core and adds support | ||
| for Optimization Toolbox 9.5 and later (MATLAB R2023a and later). | ||
| - [MOST][8] 1.3 improves speed and memory usage on certain problems, and | ||
| adds calculation of expected temporal locational marginal | ||
| price (TLMP), includes transitions into first period in ramping | ||
| reserves, and more. | ||
| - [SimulinkMATPOWER][8a], included in [MATPOWER Extras][8b], enables the use | ||
| of MATPOWER from MATLAB's [Simulink®][8c] environment. | ||
| *Thanks to Lukas Ortmann.* | ||
| - New options: | ||
| - New AC power flow solver based on `fsolve()` function, selected by | ||
| setting `'pf.alg'` option to `'FSOLVE'`. | ||
| - New Implicit Z-bus Gauss method power flow for distribution systems, | ||
| selected by setting `pf.alg` option to `'ZG'`. | ||
| - New functions/methods: | ||
| - `run_mp` - Top-level function for running any task (PF, CPF, OPF) with | ||
| the new MP-Core and flexible framework. | ||
| - `run_pf` - Wrapper around `run_mp` for running PF. | ||
| - `run_cpf` - Wrapper around `run_mp` for running CPF. | ||
| - `run_opf` - Wrapper around `run_mp` for running OPF. | ||
|
|
||
|
|
||
| #### New Case Files: | ||
|
|
||
| - Two new European transmission system cases. *Thanks to Florin Capitanescu.* | ||
| - Two new Swedish distribution system cases. *Thanks to Gabriel Malmer.* | ||
|
|
||
|
|
||
| #### New Documentation: | ||
|
|
||
| - [MATPOWER Documentation site][8d] -- new documentation website with MATPOWER | ||
| manuals, reference docs, and how-to guides | ||
| - [MATPOWER Developer's Manual][5] -- describes the architecture of the | ||
| new MP-Core and MATPOWER flexible framework | ||
| - [MATPOWER Reference Manual][5a] -- reference for MATPOWER functions and | ||
| classes, especially those in the new MP-Core and MATPOWER flexible framework | ||
| - [*MATPOWER Technical Note 5*][6] "MP-Element: A Unified MATPOWER | ||
| Element Model, with Corresponding Functions and Derivatives" | ||
|
|
||
|
|
||
| #### Other Improvements: | ||
|
|
||
| - New MATPOWER Docker image (named [`matpower/matpower`][9]) is | ||
| based on the official GNU Octave image ([`gnuoctave/octave`][10]) and | ||
| is available for multiple MATPOWER and Octave versions. | ||
| - Update versions of included packages: | ||
| - MP-Test 8.0 | ||
| - MIPS 1.5.1 | ||
| - MP-Opt-Model 4.2 | ||
| - MOST 1.3 | ||
| - Numerous bug fixes. | ||
|
|
||
|
|
||
| #### Incompatible Changes: | ||
|
|
||
| - Remove several deprecated functions, methods and options. | ||
|
|
||
|
|
||
| [1]: https://github.com/MATPOWER/matpower/blob/master/docs/relnotes/MATPOWER-Release-Notes-8.0.md | ||
| [2]: https://github.com/MATPOWER/matpower/blob/master/CHANGES.md | ||
| [3]: https://github.com/MATPOWER/matpower/blob/master/docs/MATPOWER-manual.pdf | ||
| [4]: https://github.com/MATPOWER/mp-element | ||
| [5]: https://matpower.org/doc/dev-manual/ | ||
| [5a]: https://matpower.org/doc/ref-manual/ | ||
| [6]: https://matpower.org/docs/TN5-MP-Element.pdf | ||
| [7]: https://github.com/MATPOWER/mips | ||
| [7a]: https://github.com/MATPOWER/mp-opt-model | ||
| [8]: https://github.com/MATPOWER/most | ||
| [8a]: https://github.com/MATPOWER/mx-simulink_matpower | ||
| [8b]: https://github.com/MATPOWER/matpower-extras | ||
| [8c]: https://www.mathworks.com/products/simulink.html | ||
| [8d]: https://matpower.org/doc/ | ||
| [9]: https://hub.docker.com/r/matpower/matpower | ||
| [10]: https://hub.docker.com/r/gnuoctave/octave |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.