MATPOWER

The data file format of MATPOWER is excerpted below for quick reference. For more information, see the MATPOWER User’s Manual.

Bus Data

name	column	description
BUS_I	1	bus number (positive integer)
BUS_TYPE	2	bus type (1 = PQ, 2 = PV, 3 = ref, 4 = isolated)
PD	3	real power demand (MW)
QD	4	reactive power demand (MVAr)
GS	5	shunt conductance (MW demanded at V = 1.0 p.u.)
BS	6	shunt susceptance (MVAr injected at V = 1.0 p.u.)
BUS AREA	7	area number (positive integer)
VM	8	voltage magnitude (p.u.)
VA	9	voltage angle (degrees)
BASE_KV	10	base voltage (kV)
ZONE	11	loss zone (positive integer)
VMAX	12	maximum voltage magnitude (p.u.)
VMIN	13	minimum voltage magnitude (p.u.)
LAM_P [1]	14	Lagrange multiplier on real power mismatch (\(u\)/MW)
LAM_Q [1]	15	Lagrange multiplier on reactive power mismatch (\(u\)/MVar)
MU_VMAX [1]	16	Kuhn-Tucker multiplier on upper voltage limit (\(u\)/p.u.)
MU_VMIN [1]	17	Kuhn-Tucker multiplier on lower voltage limit (\(u\)/p.u.)

1. Included in OPF output, typically not included (or ignored) in input matrix. Here we assume the objective function has units \(u\).

Generator Data

name	column	description
GEN_BUS	1	bus number
PG	2	real power output (MW)
QG	3	reactive power output (MVAr)
QMAX	4	maximum reactive power output (MVAr)
QMIN	5	minimum reactive power output (MVAr)
VG [3]	6	voltage magnitude setpoint (p.u.)
MBASE	7	total MVA base of machine, defaults to baseMVA
GEN_STATUS	8	machine status, > 0 for in-service , <= 0 for out-of-service
PMAX	9	maximum real power output (MW)
PMIN	10	minimum real power output (MW)
PC1 [1]	11	lower real power output of PQ capability curve (MW)
PC2 [1]	12	upper real power output of PQ capability curve (MW)
QC1MIN [1]	13	minimum reactive power output at PC1 (MVAr)
QC1MAX [1]	14	maximum reactive power output at PC1 (MVAr)
QC2MIN [1]	15	minimum reactive power output at PC2 (MVAr)
QC2MAX [1]	16	maximum reactive power output at PC2 (MVAr)
RAMP_AGC [1]	17	ramp rate for load following/AGC (MW/min)
RAMP_10 [1]	18	ramp rate for 10 minute reserves (MW)
RAMP_30 [1]	19	ramp rate for 30 minute reserves (MW)
RAMP_Q [1]	20	ramp rate for reactive power (2 sec timescale) (MVAr/min)
APF [1]	21	area participation factor
MU_PMAX [2]	22	Kuhn-Tucker multiplier on upper Pg limit (\(u\)/MW)
MU_PMIN [2]	23	Kuhn-Tucker multiplier on lower Pg

1. Not included in version 1 case format.

2. Included in OPF output, typically not included (or ignored) in input matrix. Here we assume the objective function has units \(u\).

3. Used to determine voltage setpoint for optimal power flow only if opf.use_vg option is non-zero (0 by default). Otherwise generator voltage range is determined by limits set for corresponding bus in bus matrix.

Branch Data

name	column	description
F_BUS	1	"from" bus number
T_BUS	2	"to" bus number
BR_R	3	resistance (p.u.)
BR_X	4	reactance (p.u.)
BR_B	5	total line charging susceptance (p.u.)
RATE_A [1]	6	MVA rating A (long term rating), set to 0 for unlimited
RATE_B [1]	7	MVA rating B (short term rating), set to 0 for unlimited
RATE_C [1]	8	MVA rating C (emergency rating), set to 0 for unlimited
TAP	9	transformer off nominal turns ratio
SHIFT	10	transformer phase shift angle (degrees), positive => delay
BR_STATUS	11	initial branch status, 1 = in-service, 0 = out-of-service
ANGMIN [2]	12	minimum angle difference, Of - Ot (degrees)
ANGMAX [2]	13	maximum angle difference, 0,-0 - (degrees)
PF [3]	14	real power injected at "from" bus end (MW)
QF [3]	15	reactive power injected at "from" bus end (MVAr)
PT [3]	16	real power injected at "to" bus end (MW)
QT [3]	17	reactive power injected at "to" bus end (MVAr)
MU_SF [4]	18	Kuhn-Tucker multiplier on MVA limit at "from" bus (\(u\)/MVA)
MU_ST [4]	19	Kuhn-Tucker multiplier on MVA limit at "to" bus (\(u\)/MVA)
MU_ANGMIN [4]	20	Kuhn-Tucker multiplier lower angle difference limit (\(u\)/degree)
MU_ANGMAX [4]	21	Kuhn

1. Used to specify branch flow limits. By default these are limits on apparent power with units in MVA. However, the 'opf.flow lim' option can be used to specify that the limits are active power or current, in which case the ratings are specified in MW or \(kA·V_{basekV}\), respectively. For current this is equivalent to an MVA value at a 1 p.u. voltage.

2. Not included in version 1 case format. The voltage angle difference is taken to be unbounded below if \(ANGMIN ≤ −360\) and unbounded above if \(ANGMAX ≥ 360\). If both parameters are zero, the voltage angle difference is unconstrained.

3. Included in power flow and OPF output, ignored on input.

4. Included in OPF output, typically not included (or ignored) in input matrix. Here we assume the objective function has units \(u\).

Generator Cost Data

name	column	description
MODEL	1	cost model, 1 = piecewise linear, 2 = polynomial
STARTUP	2	startup cost in US dollars [1]
SHUTDOWN	3	shutdown cost in US dollars [1]
NCOST	4	number of points of an n-segment piecewise linear cost function or coefficients of an n-th order polynomial cost function
COST [2]	5	parameters defining total cost function \(f(p)\)

1. Not currently used by any Matpower functions.

2. MODEL = 1, \(f(p)\) is defined by the coordinates \((p_1, f_1), (p_2, f_2), . . . , (p_N , f_N)\); MODEL = 2, \(f(p) = c_{n}p^{n} + ... + c_{1}p^{1} + c_{0}\).