User’s Manual

Version 7.0

Ray D. Zimmerman
Carlos E. Murillo-Sánchez

June 20, 2019

© 2010–2019 Power Systems Engineering Research Center (PSerc)
All Rights Reserved

1 Introduction
 1.1 Background
 1.2 License and Terms of Use
 1.3 Citing Matpower
 1.4 Matpower Development
 1.5 Sponsoring the Matpower Project
2 Getting Started
 2.1 System Requirements
 2.2 Getting Matpower
 2.3 Installation
 2.4 Running a Simulation
 2.5 Documentation
3 Modeling
 3.1 Data Formats
 3.2 Branches
 3.3 Generators
 3.4 Loads
 3.5 Shunt Elements
 3.6 Network Equations
 3.7 DC Modeling
4 Power Flow
 4.1 AC Power Flow
 4.2 DC Power Flow
 4.3 Distribution Power Flow
 4.4 runpf
 4.5 Linear Shift Factors
5 Continuation Power Flow
 5.1 Parameterization
 5.2 Predictor
 5.3 Corrector
 5.4 Step Length Control
 5.5 Event Detection and Location
 5.6 runcpf
6 Optimal Power Flow
 6.1 Standard AC OPF
 6.2 Standard DC OPF
 6.3 Extended OPF Formulation
 6.4 Standard Extensions
 6.5 Solvers
 6.6 runopf
7 Extending the OPF
 7.1 Direct Specification
 7.2 Callback Functions
 7.3 Callback Stages and Example
 7.4 Registering the Callbacks
 7.5 Summary
 7.6 Example Extensions
8 Unit De-commitment Algorithm
9 Miscellaneous Matpower Functions
 9.1 Input/Output Functions
 9.2 System Information
 9.3 Modifying a Case
 9.4 Conversion between External and Internal Numbering
 9.5 Forming Standard Power Systems Matrices
 9.6 Miscellaneous
10 Acknowledgments
A MIPS – Matpower Interior Point Solver
 A.1 Example 1
 A.2 Example 2
 A.3 Quadratic Programming Solver
 A.4 Primal-Dual Interior Point Algorithm
B Data File Format
C Matpower Options
 C.1 Mapping of Old-Style Options to New-Style Options
D Matpower Files and Functions
 D.1 Directory Layout and Documentation Files
 D.2 Matpower Functions
 D.3 Example Matpower Cases
 D.4 Automated Test Suite
E Matpower Extras
F “Smart Market” Code
 F.1 Handling Supply Shortfall
 F.2 Example
 F.3 Smartmarket Files and Functions
G Optional Packages
 G.1 BPMPD_MEX – MEX interface for BPMPD
 G.2 CLP – COIN-OR Linear Programming
 G.3 CPLEX – High-performance LP and QP Solvers
 G.4 GLPK – GNU Linear Programming Kit
 G.5 Gurobi – High-performance LP and QP Solvers
 G.6 Ipopt – Interior Point Optimizer
 G.7 Artelys Knitro – Non-Linear Programming Solver
 G.8 MINOPF – AC OPF Solver Based on MINOS
 G.9 MOSEK – High-performance LP and QP Solvers
 G.10 Optimization Toolbox – LP, QP, NLP and MILP Solvers
 G.11 PARDISO – Parallel Sparse Direct and Multi-Recursive Iterative Linear Solvers
 G.12 SDP_PF – Applications of a Semidefinite Programming Relaxation of the Power Flow Equations
 G.13 TSPOPF – Three AC OPF Solvers by H. Wang
H Release History
 H.1 Pre 1.0 – released Jun 25, 1997
 H.2 Version 1.0 – released Sep 17, 1997
 H.3 Version 1.0.1 – released Sep 19, 1997
 H.4 Version 2.0 – released Dec 24, 1997
 H.5 Version 3.0 – released Feb 14, 2005
 H.6 Version 3.2 – released Sep 21, 2007
 H.7 Version 4.0 – released Feb 7, 2011
 H.8 Version 4.1 – released Dec 14, 2011
 H.9 Version 5.0 – released Dec 17, 2014
 H.10 Version 5.1 – released Mar 20, 2015
 H.11 Version 6.0 – released Dec 16, 2016
 H.12 Version 7.0 – released Jun 20, 2019
References