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.)

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

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

Not included in version 1 case format.
Included in OPF output, typically not included (or ignored) in input matrix. Here we assume the objective function has units \(u\).
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.

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

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.
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.
Included in power flow and OPF output, ignored on input.
Included in OPF output, typically not included (or ignored) in input matrix. Here we assume the objective function has units \(u\).

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)\)

Not currently used by any Matpower functions.
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}\).

code	description
BA	Energy Storage, Battery
CE	Energy Storage, Compressed Air
CP	Energy Storage, Concentrated Solar Power
FW	Energy Storage, Flywheel
PS	Hydraulic Turbine, Reversible (pumped storage)
ES	Energy Storage, Other
ST	Steam Turbine (includes nuclear, geothermal, and solar steam)
GT	Combustion (Gas) Turbine
IC	Internal Combustion Engine (diesel, piston, reciprocating)
CA	Combined Cycle Steam Part
CT	Combined Cycle Combustion Turbine Part
CS	Combined Cycle Single Shaft
CC	Combined Cycle Total Unit
HA	Hydrokinetic, Axial Flow Turbine
HB	Hydrokinetic, Wave Buoy
HK	Hydrokinetic, Other
HY	Hydroelectric Turbine
BT	Turbines Used in a Binary Cycle
PV	Photovoltaic
WT	Wind Turbine, Onshore
WS	Wind Turbine, Offshore
FC	Fuel Cell
OT	Other
UN	Unknown
JE	Jet Engine
NB	ST - Boiling Water Nuclear Reactor
NG	ST - Graphite Nuclear Reactor
NH	ST - High Temperature Gas Nuclear Reactor
NP	ST - Pressurized Water Nuclear Reactor
IT	Internal Combustion Turbo Charged
SC	Synchronous Condenser
DC	DC ties
MP	Motor/Pump
W1	Wind Turbine, Type 1
W2	Wind Turbine, Type 2
W3	Wind Turbine, Type 3
W4	Wind Turbine, Type 4
SV	Static Var Compensator
DL	Dispatchable Load

code	description
biomass	Biomass
coal	Coal
dfo	Distillate Fuel Oil
geothermal	Geothermal
hydro	Hydro
hydrops	Hydro Pumped Storage
jetfuel	Jet Fuel
lng	Liquefied Natural Gas
ng	Natural Gas
nuclear	Nuclear
oil	Unspecified Oil
refuse	Refuse, Municipal Solid Waste
rfo	Residual Fuel Oil
solar	Solar
syncgen	Synchronous Condenser
wasteheat	Waste Heat
wind	Wind
wood	Wood or Wood Waste
other	Other
unknown	Unknown
dl	Dispatchable Load
ess	Energy Storage System