开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

A Power System Simulation Package for MATLAB and Octave

• MATPOWER Website - https://matpower.org
• MATPOWER GitHub Project - https://github.com/MATPOWER/matpower

MATPOWER is a package of M-files for solving power flow, continuation power flow and optimal power flow problems using MATLAB or Octave. It is intended as a simulation tool for researchers and educators that is easy to use and modify. MATPOWER is designed to give the best performance possible while keeping the code simple to understand and modify.

MATPOWER releases can be downloaded from the MATPOWER website, and the latest stable and work-in-progress versions can always be downloaded or cloned from the MATPOWER GitHub project. The master branch should always contain a stable version.

System Requirements

• MATLAB version 7.5 (R2007b) or later, or
• GNU Octave version 4 or later

Getting MATPOWER

You can either download an official versioned release or you can obtain the current development version, which we also attempt to keep stable enough for everyday use. The development version includes new features and bug fixes added since the last versioned release.

Versioned Releases

Download the ZIP file of the latest official versioned release from the MATPOWER website. Note: This does include the MATPOWER Extras.

Current Development Version

There are also two options for obtaining the most recent development version of MATPOWER from the master branch on GitHub. Note: This does not include the MATPOWER Extras.

1. Clone the MATPOWER repository from GitHub. Use this option if you want to be able to easily update to the current development release, with the latest bug fixes and new features, using a simple git pull command, or if you want to help with testing or or development. This requires that you have a Git client (GUI or command-line) installed.

   • From the command line:
     • git clone https://github.com/MATPOWER/matpower.git
   • Or, from the MATPOWER GitHub repository page:
     • Click the green Clone or download button, then Open in Desktop.

2. Download a ZIP file of the MATPOWER repository from GitHub. Use this option if you need features or fixes introduced since the latest versioned release, but you do not have access to or are not ready to begin using Git (but don't be afraid to give Git a try).

   • Go to the MATPOWER GitHub repository page.
   • Click the green Clone or download button, then Download ZIP.

See CONTRIBUTING.md for information on how to get a local copy of your own MATPOWER fork, if you are interesting in contributing your own code or modifications.

MATPOWER Docker Image

MATPOWER is also available on Docker Hub as the pre-packaged Docker image tagged matpower/matpower, providing a Linux environment with Octave, MATPOWER, and the MATPOWER Extras pre-installed. See the MATPOWER-Docker page for more details.

Docker images are provided for both versioned releases and development versions.

Installation

Installation and use of MATPOWER requires familiarity with the basic operation of MATLAB or Octave. Make sure you follow the installation instructions for the version of MATPOWER you are installing. The process was simplified with an install script following version 6.0.

1. Get a copy of MATPOWER as described above. Clone the repository or download and extract the ZIP file of the MATPOWER distribution and place the resulting directory in the location of your choice and call it anything you like. We will use <MATPOWER> as a placeholder to denote the path to this directory (the one containing install_matpower.m). The files in <MATPOWER> should not need to be modified, so it is recommended that they be kept separate from your own code.

2. Run the installer.

   • Open MATLAB or Octave and change to the <MATPOWER> directory.

   • Run the installer and follow the directions to add the required directories to your MATLAB or Octave path, by typing:

       install_matpower
     

3. That's it. There is no step 3.

   • But, if you chose not to have the installer run the test suite for you in step 2, you can run it now to verify that MATPOWER is installed and functioning properly, by typing:

       test_matpower
     

Running MATPOWER

To run a simple Newton power flow on the 9-bus system specified in the file case9.m, with the default algorithm options, at the MATLAB or Octave prompt, type:

runpf('case9')

To load the 30-bus system data from case30.m, increase its real power demand at bus 2 to 30 MW, then run an AC optimal power flow with default options, type:

define_constants;
mpc = loadcase('case30');
mpc.bus(2, PD) = 30;
runopf(mpc);

By default, the results of the simulation are pretty-printed to the screen, but the solution can also be optionally returned in a results struct. The following example shows how simple it is, after running a DC OPF on the 118-bus system in case118.m, to access the final objective function value, the real power output of generator 6 and the power flow in branch 51.

results = rundcopf('case118');
final_objective = results.f;
gen6_output     = results.gen(6, PG);
branch51_flow   = results.branch(51, PF);

For additional info, see the MATPOWER User's Manual, the on-line function reference, or the built-in help documentation for the various MATPOWER functions. For example:

help runpf
help runopf
help mpoption
help caseformat

Documentation

There are four primary sources of documentation for MATPOWER.

• MATPOWER User's Manual
• MOST User's Manual
• MATPOWER Online Function Reference
• MATLAB's help command

Manuals

The MATPOWER and MOST User's Manuals are included in the distribution (docs/MATPOWER-manual.pdf and most/docs/MOST-manual.pdf) and the latest released versions are always available online, respectively, at:

• https://matpower.org/MATPOWER-manual.pdf
• https://matpower.org/MOST-manual.pdf.

Previous versions are also available at

• https://matpower.org/doc/manuals

Built-in Help

Each M-file has its own documentation which can be accessed by typing at the MATLAB/Octave prompt:

help <name of M-file>

Documentation for the case data file format can be found by typing:

help caseformat

If something is still unclear after checking the manual and the help, the source code is the documentation.