Sunteți pe pagina 1din 116

Matpower 4.1 User’s Manual

Ray D. Zimmerman

Carlos E. Murillo-S´anchez

December 14, 2011

© 2010, 2011 Power Systems Engineering Research Center (Pserc) All Rights Reserved

Contents

1 Introduction

 

7

1.1

Background

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

7

1.2 License and Terms of Use

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

7

1.3 Citing Matpower

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

8

2 Getting Started

 

9

2.1

System Requirements

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

9

2.2

Installation

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

9

2.3

Running a Simulation

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

10

2.3.1 Preparing Case Input Data

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

11

2.3.2 Solving the Case

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

11

2.3.3 Accessing the Results

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

12

2.3.4 Setting Options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

13

2.4

Documentation

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

13

3 Modeling

 

16

3.1 Data Formats

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

16

3.2 Branches .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

16

3.3 Generators .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

18

3.4

Loads

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

18

3.5 Shunt Elements

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

18

3.6 Network Equations

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

19

3.7 DC Modeling

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

19

4 Power Flow

 

23

4.1 AC Power Flow

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

23

4.2 DC Power Flow

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

25

4.3 runpf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

25

4.4 Linear Shift Factors

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

27

5 Optimal Power Flow

 

29

5.1 Standard AC OPF

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

29

5.2 Standard DC OPF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

30

5.3 Extended OPF Formulation

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

31

 

5.3.1 User-defined Costs

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

31

5.3.2 User-defined Constraints

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

33

5.3.3 User-defined Variables

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

33

 

2

5.4 Standard Extensions

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

34

5.4.1 Piecewise Linear Costs

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

34

. 5.4.3 Generator Capability Curves

5.4.2 Dispatchable Loads

.

.

5.5 Solvers .

.

5.6 runopf

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

6 Extending the OPF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

35

37

5.4.4 Branch Angle Difference Limits

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

38

. .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

38

39

43

6.1 Direct Specification .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

43

6.2 Callback Functions

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

44

6.2.1 ext2int Callback

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

45

6.2.2 formulation Callback

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

47

6.2.3 int2ext Callback

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

49

6.2.4 printpf Callback

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

51

6.2.5 savecase Callback

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

54

6.3 Registering the Callbacks

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

56

6.4 Summary

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

57

6.5 Example Extensions

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

57

6.5.1 Fixed Zonal Reserves

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

57

6.5.2 Interface Flow Limits

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

58

6.5.3 DC Transmission Lines

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

59

7 Unit De-commitment Algorithm

62

8 Acknowledgments

63

Appendix A MIPS – Matlab Interior Point Solver

 

64

A.1

A.2

A.3

A.4

Example 1 .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

67

Example 2 .

Quadratic Programming Solver

Primal-Dual Interior Point Algorithm

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

68

70

71

A.4.1

Notation .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

71

A.4.2

Problem Formulation and Lagrangian

 

.

.

.

.

.

.

.

.

.

.

.

.

72

A.4.3

First Order Optimality Conditions

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

73

A.4.4

Newton Step

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

73

Appendix B Data File Format

76

3

Appendix C

Matpower Options

82

Appendix D

Matpower Files and Functions

 

91

D.1

D.2

Documentation Files Matpower Functions

. Example Matpower Cases

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

91

91

D.3

.

.

.

.

.

.

.

.

.

.

.

.

.

97

D.4

Automated Test Suite

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

98

Appendix E

Extras Directory

 

101

Appendix F

“Smart Market” Code

102

F.1

Handling Supply Shortfall

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

104

F.2

F.3

. Smartmarket Files and Functions

Example

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

104

108

Appendix G Optional Packages

 

109

G.1

BPMPD MEX – MEX interface for BPMPD

.

.

.

.

.

.

.

.

.

.

.

.

109

G.2

CPLEX – High-performance LP and QP Solvers

 

.

.

.

.

.

.

.

.

.

.

109

G.3

Gurobi – High-performance LP and QP Solvers

.

.

.

.

.

.

.

.

.

.

.

.

110

G.4

Ipopt – Interior Point Optimizer

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

111

G.5

.

.

.

.

.

.

.

.

.

.

.

.

.

.

111

G.6

G.7

KNITRO – Non-Linear Programming Solver MINOPF – AC OPF Solver Based on MINOS

. MOSEK – High-performance LP and QP Solvers TSPOPF – Three AC OPF Solvers by H. Wang

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

112

112

G.8

.

.

.

.

.

.

.

.

.

.

.

.

113

References

 

114

4

List of Figures

3-1

5-1

. Relationship of w i to r i for d i = 1 (linear option)

Branch Model

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

17

32

5-2

5-3

Relationship of w i to r i for d i = 2 (quadratic option)

Constrained Cost Variable

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

33

34

5-4

Marginal Benefit or Bid Function

.

.

.

.

.

.

.

.

36

5-5

Total Cost Function for Negative Injection

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

36

5-6

Generator P -Q Capability Curve

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.