IEEE PSAP PTI data format

seanchio

Partial Description of the IEEE Common Data Format for the   
0 C7 o/ ^0 C1 O1 s, m' hExchange of Solved Load Flow Data
The complete description can be found in the paper "Common Data
6 ~5 F: N7 L1 C/ b2 QFormat for the Exchange of Solved Load Flow Data", Working Group on a
Common Format for the Exchange of Solved Load Flow Data, _IEEE
Transactions on Power Apparatus and Systems_, Vol. PAS-92, No. 6,
6 M6 F: G' F" r' [November/December 1973, pp. 1916-1925.
) l& _0 K+ z! s8 m& ^2 K  ?The data file has lines of up to 128 characters. The lines are grouped
into sections with section headers. Data items are entered in specific
+ ]# [; N6 I8 d* I) Xcolumns. No blank items are allowed, enter zeros instead. Floating point
items should have explicit decimal point. No implicit decimal points
are used.
Data type codes: A - Alphanumeric (no special characters)
$ E7 a& Z7 ^: q$ J/ z) z0 ^* h                 I - Integer
                 F - Floating point
                 * - Mandatory item
2 J* z! ]( a: j& H( kTitle Data
==========
First card in file.
Columns  2- 9   Date, in format DD/MM/YY with leading zeros. If no date
                provided, use 0b/0b/0b where b is blank.
2 ~) x" N- w: g6 {/ gColumns 11-30   Originator's name (A)
- V+ @% e& F( ]! w% F  y/ D) yColumns 32-37   MVA Base (F*)
2 K4 X" f# U* k7 X. L$ G7 _" Z: tColumns 39-42   Year (I)
Column  44      Season (S - Summer, W - Winter)
Column  46-73   Case identification (A)
1 S& ~- t/ I' v( aBus Data *
==========
3 R" l/ Y+ i( O8 H7 o. bSection start card *:
---------------------
Columns  1-16   BUS DATA FOLLOWS (not clear that any more than BUS in
( `; I# {% @; n                1-3 is significant) *
Columns  ?- ?   NNNNN ITEMS (column not clear, I would not count on this)
Bus data cards *:
. g+ J$ b3 H# e4 X-----------------
Columns  1- 4   Bus number (I) *
& q% A7 F4 B7 K& v- L% k7 yColumns  7-17   Name (A) (left justify) *
/ t7 A  }3 @* L3 u/ l$ zColumns 19-20   Load flow area number (I) Don't use zero! *
" X6 e6 W6 ]. a& \; nColumns 21-23   Loss zone number (I)
% a/ h% j" f: _! GColumns 25-26   Type (I) *
) o8 ~8 t7 J$ J! H! B                 0 - Unregulated (load, PQ)
8 K: @' X6 e' t5 R4 S/ w0 Y  O                 1 - Hold MVAR generation within voltage limits, (PQ)
                 2 - Hold voltage within VAR limits (gen, PV)
$ w) T$ B; E4 T9 ^5 F                 3 - Hold voltage and angle (swing, V-Theta) (must always
                      have one)
/ A5 U) L8 H1 ^: p% J9 l" S- XColumns 28-33   Final voltage, p.u. (F) *
Columns 34-40   Final angle, degrees (F) *
Columns 41-49   Load MW (F) *
Columns 50-59   Load MVAR (F) *
Columns 60-67   Generation MW (F) *
  I  W1 F0 z5 a! i' Q! `9 ^: k" w% D' NColumns 68-75   Generation MVAR (F) *
Columns 77-83   Base KV (F)
, Q+ I" ^9 ~9 @# c( t5 l9 H* i; RColumns 85-90   Desired volts (pu) (F) (This is desired remote voltage if
                this bus is controlling another bus.
Columns 91-98   Maximum MVAR or voltage limit (F)
Columns 99-106  Minimum MVAR or voltage limit (F)
Columns 107-114 Shunt conductance G (per unit) (F) *
Columns 115-122 Shunt susceptance B (per unit) (F) *
Columns 124-127 Remote controlled bus number
Section end card:
0 _+ Z& x3 }$ g' S- t8 G-----------------
# O9 m5 b  Z) w1 GColumns  1- 4   -999
Branch Data *
2 \- o# ~  [7 z# v=============
& q  W- ^6 ]" `. T  E3 A7 L8 U! kSection start card *:
---------------------
Columns  1-16   BRANCH DATA FOLLOWS (not clear that any more than BRANCH
                is significant) *
) D+ R+ d6 [5 ]! D6 v& M& UColumns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
) ~% R" a9 N1 R) XBranch data cards *:
--------------------
Columns  1- 4   Tap bus number (I) *
* d3 g! u5 d9 c' ]! y: Y' P" D                 For transformers or phase shifters, the side of the model
                 the non-unity tap is on
Columns  6- 9   Z bus number (I) *
+ h! m3 ~* n. o5 y0 v; f                 For transformers and phase shifters, the side of the model
                 the device impedance is on.
% @! ^) f* O; O" v& s- wColumns 11-12   Load flow area (I)
Columns 13-14   Loss zone (I)
Column  17      Circuit (I) * (Use 1 for single lines)
" s, N2 N7 h0 M, s% B$ V0 U  ^Column  19      Type (I) *
                 0 - Transmission line
                 1 - Fixed tap
8 V5 S3 j1 b% `# {0 h( L' ]. T( ^                 2 - Variable tap for voltage control (TCUL, LTC)
0 }5 s; a' J0 Y% t' b) A                 3 - Variable tap (turns ratio) for MVAR control
                 4 - Variable phase angle for MW control (phase shifter)
+ z# O9 S) U2 |( h) b- q4 p* AColumns 20-29   Branch resistance R, per unit (F) *
Columns 30-40   Branch reactance X, per unit (F) * No zero impedance lines
+ F: l$ _; z3 }3 L1 M6 BColumns 41-50   Line charging B, per unit (F) * (total line charging, +B)
' R+ d+ |0 \) X2 c1 R7 v0 u/ LColumns 51-55   Line MVA rating No 1 (I) Left justify!
Columns 57-61   Line MVA rating No 2 (I) Left justify!
Columns 63-67   Line MVA rating No 3 (I) Left justify!
/ \3 }: ]5 T8 q, b' o# c( NColumns 69-72   Control bus number
Column  74      Side (I)
" l  C! s8 K$ d! L- d                 0 - Controlled bus is one of the terminals
& E& G2 a" l7 P4 s0 d) O                 1 - Controlled bus is near the tap side
" y$ \: Q1 K5 A- L- M                 2 - Controlled bus is near the impedance side (Z bus)
5 K1 ~4 ]+ e) t  f# GColumns 77-82   Transformer final turns ratio (F)
5 V1 B7 f" q% b: A2 D+ ?Columns 84-90   Transformer (phase shifter) final angle (F)
Columns 91-97   Minimum tap or phase shift (F)
Columns 98-104  Maximum tap or phase shift (F)
Columns 106-111 Step size (F)
Columns 113-119 Minimum voltage, MVAR or MW limit (F)
" k" Q; x5 e. f) R! l( A+ zColumns 120-126 Maximum voltage, MVAR or MW limit (F)
Section end card:
; J8 G! |4 V; w; I" q2 I-----------------
Columns  1- 4   -999
* P7 s7 |/ @4 }Loss Zone Data
==============
2 o+ B$ V$ H$ s# ]: C/ S# N  Q) iSection start card
------------------
Columns  1-16   LOSS ZONES FOLLOWS (not clear that any more than LOSS
                is significant)
* l% m' o, \  v/ I7 j* y0 V+ L0 }2 FColumns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
Loss Zone Cards:
----------------
Columns  1- 3   Loss zone number  (I)
& z) S* K; O  S+ Z/ g1 J4 XColumns  5-16   Loss zone name (A)
Section end card:
; ~, b5 Y4 \2 m8 l( _( F3 Z  D. Z) C-----------------
Columns  1- 3   -99
Interchange Data *
==================
Section start card
------------------
Columns  1-16   INTERCHANGE DATA FOLLOWS (not clear that any more than
6 V: {5 a% W$ e8 W1 T                first word is significant).
" e( X, F2 h( J  d' BColumns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
Interchange Data Cards *:
-------------------------
Columns  1- 2   Area number (I) no zeros! *
Columns  4- 7   Interchange slack bus number (I) *
Columns  9-20   Alternate swing bus name (A)
Columns 21-28   Area interchange export, MW (F) (+ = out) *
Columns 30-35   Area interchange tolerance, MW (F) *
Columns 38-43   Area code (abbreviated name) (A) *
Columns 46-75   Area name (A)
$ d, ~/ O$ }4 b+ }Section end card:
-----------------
Columns  1- 2   -9
Tie Line Data
2 z6 q" r: N% V, x# I=============
Section start card
  e" |4 M9 a' B/ C' a+ [------------------
Columns  1-16   TIE LINES FOLLOW (not clear that any more than TIE
; [2 r- d' F+ R$ I$ L5 v                is significant)
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
6 V7 C+ c; c) b5 v% n: tTie Line Cards:
9 A% s- o: V* ~5 A5 Z' M, k---------------
; g$ G& M) g5 t+ i7 P( qColumns  1- 4   Metered bus number (I)
( N6 \# J  }0 }: a3 ZColumns  7-8    Metered area number (I)
Columns  11-14  Non-metered bus number (I)
$ X3 G0 ^  _1 s$ y3 qColumns  17-18  Non-metered area number (I)
Column   21     Circuit number
/ q- k$ W4 U0 NSection end card:
-----------------
Columns  1- 3   -999
END OF DATA
: J4 c  `2 Z# W+ q4 q# ?
! F" C0 p! S! p& [5 A" A, c3 }8 r3 aPSAP File Format
+ X) }7 U* ~) X8 c( Q8 XMay 20, 1993
& ~. _* B0 N! @The PECO PSAP File Format is fully described in the _PJM Power System
Analysis Package Use's Guide_, available from the Philadelphia
Electric Company. The following is a rough description of the
most important parts of the format.
8 K) p- E) a1 C) Z  z1 x7 {) N! RA PSAP data file is divided into sections by code cards. The code is
in the first three columns. There are something like 60 codes, of
which only four are described in this document.
7 e+ N) A/ q9 s, X2 NThe 1 code indicates that the next card is the case title. Only one
5 f4 D* |% R( c- Mtitle is allowed per case.
$ k; I3 b1 k, x4 ]  n2 G' X+ R; qThe 4 card indicates that line data follows. The line data ends with
a 9999 card.
  c) P5 H5 F6 a  J" `5 V5 w0 pThe 5 card indicates that bus data follows. The bus data ends with
* ~2 _' ?& |$ T# H- Ka 9999 card.
5 p. Q" E' Y+ Y4 [The 15 card indicates that area interchange data follows. The data ends with
% j$ \7 F$ x/ G5 J' pa 9999 card.
Line Data Card (Code 4 cards)
& y+ ]8 Z4 V2 J# {# e=============================
Cols    Data
8 R& V. K# Z0 K; l. I1-4     From bus number
6       Change code (blank in 4 section)
7       'C' if second card present for same line. Used for transformers.
9-12    To bus number
14      Circuit number (blank in 4 section)
16      'T' or 'F' - Load flow area of bus at this end of line gets losses.
18-23   Line resistance in percent of base. (NOT per unit.)
) Y9 g8 E% c" u  g5 X0 d3 C0 K  p        (percent = 100 x per unit) Two default decimal places.
24-29   Line reactance, in percent. Two default decimal places.
3 X$ K$ Z* f# X6 K30-35   Line charging MVAR (total). Three default decimal places.
& N! r. c9 c7 m$ m36-40   Transformer tap (per unit turns ratio). Three default decimal
0 A0 C9 @( P8 v" Z2 \        places, 1000 = 1.000.
41-45   Min tap, for OLTC. Three default decimal places.
8 }3 v& {! E/ y2 G46-50   Max tap, for OLTC. Three default decimal places.
51-55   Phase shift angle, for OL phase shifter. Two default decimal places.
/ t. l, K: Z' P; Z4 [56-60   Remote voltage control bus number. Negative if lower tap increases
5 {0 b9 G0 |7 M' s; t/ P( M: p        voltage of this bus.
5 F8 S# G( y$ f; V1 `& r; \61-64   Normal MVA rating
65-68   Emergency MVA rating
% ^7 F2 _! b8 e4 h8 p: J5 _: r69-72   MVA Base. Default value 100 MVA if blank.
+ O+ R- D$ C) T) _6 J1 \Second Line Card (follows 'C' in first card)
============================================
3 W5 n- J( {& |* g$ z1-17    Same as first card, except no 'C'. Can be left blank.
35-40   Desired MVAR flow or Min voltage setpoint for OLTC.
$ ]. o$ p( S7 F/ O8 O- \41-45   Min phase shifter degrees. Two default decimal places.
46-50   Max phase shifter degrees. Two default decimal places.
51-55   Desired MW flow for phase shifter.
( `, s' m- E" v# Y* @3 V2 r6 h( v4 s57-60   Controlled line from bus.
62-65   Controlled line to bus.
% e% x% j+ w$ `# i% T67-70   Available taps (number of taps)
71-75   Maximum voltage setpoint. Three default decimal places.
Bus Cards (Code 5 cards)
( E! f# s4 l2 M  I! D+ h- V) D; c8 a========================
1-4     Bus number
6       Change code (blank in 5 section)
& Y! s( ~# m0 G7       Continue code (blank in 5 section)
" S# K' v- _2 m. D& x0 T' t# Q8       Regulated bus code:
8 R' W. X. c/ U8 _' X* B& z' ^         Blank - load (PQ) bus
         1     - gen (PV) bus
         2     - swing (V-Theta) bus
10-21   Name
' q& w' E4 h7 h8 N23-26   Bus voltage (control setpoint or solved value).
        Three default decimal places.
) h7 y6 w- v9 ~8 E27-30   Bus angle
31-35   Generation MW
36-40   Generation MVAR (from solution)
41-45   Generation MVAR low limit
; L) T- d5 j; u0 f46-50   Generation MVAR high limit
# u  n, j' p/ q51-55   Bus at which generation controls voltage
56-60   Load MW
61-65   Load MVAR
66-70   Shunt MVAR. Reactors are minus.
& m6 k+ R  f3 E" ]71-72   Load flow area. (Used for area interchange and losses).
9 A) k, f% y  O4 K$ b& L. n* X) {Area Interchange Cards (Code 15 cards)
) }$ U  F& D# t: U2 j4 f======================================
  ~, D+ `( ?0 \: J3-4     Load flow area number
5-8     Swing bus for area interchange. Adjusts generation at this bus
" N0 F8 j3 G4 T5 Y; x# ^        to meet area interchange requirement.
, {8 ?0 W: p+ O  w9-14    Area exports, MW. (+ = out of area)
( b( \; p- U" }7 M0 J  [15-19   Area Interchange tolerance, MW
20-55   Area name
56-60   Area load (usually left blank)
7 y! ~0 }4 |5 b61-65   Area losses (usually left blank)
5 T) e$ \  h3 F- p" [

5 r! i  q. v2 f5 S
Description of the PTI Load Flow Data Format
9 U% t, S. `) r% S9 l5 {1 q7 s============================================
Note that PTI reserves the right to change the format at any time.
For use with the IEEE 300 bus test case in PTI format.
Case Identification Data
========================
6 W; x) h3 q+ C0 CFirst record: IC,SBASE
IC - 0 for base case, 1 for change data to be added
SBASE - System MVA base
Records 2 and 3 - two lines of heading, up to 60 characters per line
( E3 m' Q2 k# }7 v! UBus Data
* _5 L( F, H0 P, T2 I& h9 N========
5 s: H0 N$ S5 MBus data records, terminated by a record with a bus number of zero.
+ m1 ~+ L" Z" ~! S3 t% QI,IDE,PL,QL,GL,BL,IA,VM,VA,'NAME',BASKL,ZONE
I - Bus number (1 to 29997)
IDE - Bus type
        1 - Load bus (no generation)
        2 - Generator or plant bus
        3 - Swing bus
) N9 \0 \  j8 q, B        4 - Islolated bus
$ t1 D& F' ~5 Z, o7 V PL - Load MW
) Q* B3 w/ {( P# F, _ QL - Load MVAR
. Q! N9 }1 }# o8 w GL - Shunt conductance, MW at 1.0 per unit voltage
BL - Shunt susceptance, MVAR at 1.0 per unit voltage. (- = reactor)
2 n" q, U8 n1 M IA - Area number, 1-100
5 l" \4 i: e# b7 T  ]% b VM - Voltage magnitude, per unit
1 W3 A& e; t# ^% u VA - Voltage angle, degrees
& e, ?6 H& j5 O! W' A+ i NAME - Bus name, 8 characters, must be enclosed in quotes
% d# ~# {, U( O BASKV - Base voltage, KV
ZONE - Loss zone, 1-999
, W/ p4 J! ^3 c) |. G) P- vGenerator Data
==============
Generator data records, terminated by a generator with an index of zero.
I,ID,PG,QG,QT,QB,VS,IREG,MBASE,ZR,ZX,RT,XT,GTAP,STAT,RMPCT,PT,PB
I - Bus number
/ e& s! r4 F' [ID - Machine identifier (0-9, A-Z)
PG - MW output
) N/ G- T/ k7 o  ]. J5 K  IQG - MVAR output
QT - Max MVAR
7 M: F: [2 z/ U9 X2 @; |QB - Min MVAR
VS - Voltage setpoint
IREG - Remote controlled bus index (must be type 1), zero to control own
/ ]0 t8 \% {) g9 L& w5 S voltage, and must be zero for gen at swing bus
& Y6 Z5 w3 C' p7 f' L5 b' jMBASE - Total MVA base of this machine (or machines), defaults to system
MVA base.
ZR,ZX - Machine impedance, pu on MBASE
$ q9 u9 |$ G5 G; R. Y, c; b& yRT,XT - Step up transformer impedance, p.u. on MBASE
GTAP - Step up transformer off nominal turns ratio
STAT - Machine status, 1 in service, 0 out of service
' k1 \! p. \% pRMPCT - Percent of total VARS required to hold voltage at bus IREG
to come from bus I - for remote buses controlled by several generators
) _# R  M2 P# t& nPT - Max MW
PB - Min MW
Branch Data
===========
9 e) u- m# e4 H0 V( v2 c. A8 N# `Branch records, ending with a record with from bus of zero
I,J,CKT,R,X,B,RATEA,RATEB,RATEC,RATIO,ANGLE,GI,BI,GJ,BJ,ST
I - From bus number
J - To bus number
CKT - Circuit identifier (two character) not clear if integer or alpha
R - Resistance, per unit
) A) m/ X" t1 wX - Reactance, per unit
B - Total line charging, per unit
$ ?# J' |5 V! KRATEA - MVA rating A
RATEB, RATEC - Higher MVA ratings
' C1 Y" p% N( k! d- z- A: HRATIO - Transformer off nominal turns ratio
ANGLE - Transformer phase shift angle
GI,BI - Line shunt complex admittance for shunt at from end (I) bus, pu.
GJ,BJ - Line shunt complex admittance for shunt at to end (J) bus, pu.
ST - Initial branch status, 1 - in service, 0 - out of service
Transformer Adjustment Data
5 ^) h, c0 G3 a! l3 O. q7 T===========================
( T5 U% i/ g: ?7 {1 }) sEnds with record with from bus of zero
7 A# q) w8 w/ h9 }( ]; @, g( hI,J,CKT,ICONT,RMA,RMI,VMA,VMI,STEP,TABLE
5 E7 s+ l$ L' r0 U" T- zI - From bus number
) H# Z' B. _: g" JJ - To bus number
CKT - Circuit number
9 M! r! P* I, ^% P( i4 m3 QICONT - Number of bus to control. If different from I or J, sign of ICONT
, n" R. ]9 u& [& _0 f- z" L determines control. Positive sign, close to impedance (untapped) bus
of transformer. Negative sign, opposite.
7 c1 Y- ~  q( y  p1 N  ERMA - Upper limit of turns ratio or phase shift
RMI - Lower limit of turns ratio or phase shift
VMA - Upper limit of controlled volts, MW or MVAR
VMI - Lower limit of controlled volts, MW or MVAR
STEP - Turns ratio step increment
" y! s5 u2 |/ O1 Z, \TABLE - Zero, or number of a transformer impedance correction table 1-5
Area Interchange Data
=====================
Ends with I of zero
I,ISW,PDES,PTOL,'ARNAM'
& r+ P  S; D1 JI - Area number (1-100)
ISW - Area interchange slack bus number
/ ~+ u8 S& t5 d9 cPDES - Desired net interchange, MW + = out.
PTOL - Area interchange tolerance, MW
' X' w) M) J9 k' DARNAM - Area name, 8 characters, enclosed in single quotes.
( _8 a7 x" T) }DC Line Data
============
" Z  b- Y  @# \( B0 l, iEnds with I of zero
Each DC line has three consecutive records
2 ], t8 T5 @, X3 i" ^) y% g# FI,MDC,RDC,SETVL,VSCHD,VCMOD,RCOMP,DELTI,METER
' _! b0 N3 P6 B% Y/ ~IPR,NBR,ALFMAX,ALFMN,RCR,XCR,EBASR,TRR,TAPR,TPMXR,TPMNR,TSTPR
- O, h2 o! q$ F4 J- U1 F  l9 dIPI,NBI,GAMMX,GAMMN,RCI,XCI,EBASI,TRI,TAPI,TPMXI,TPMNI,TSTPI
I - DC Line number
MDC - Control mode 0 - blocked 1 - power 2 - current
4 E+ e& j, n6 MRDC - Resistance, ohms
SETVL - Current or power demand
% B9 M0 a4 \" G% O: t4 kVSCHD - Scheduled compunded DC voltage, KV
VCMOD - Mode switch DC voltage, KV, switch to current control mode below this
4 Q2 l# {0 Y# x* |2 `" |RCOMP - Compounding resistance, ohms
0 v* U) L/ ?) ~& U& E1 q1 EDELTI - Current margin, per unit of desired current
, R+ G# L6 p: I. k8 _METER - Metered end code, R - rectifier I - Inverter
IPR - Rectifier converter bus number
NBR - Number of birdges is series rectifier
$ l. y- ?- M* @$ A  I: sALFMAX - Maximum rectifier firing angle, degrees
0 F4 a" f. u% P4 M' v' o/ H: ~ALFMN - Minimum rectifier firing angle, degrees
2 G- o  L1 `& z" k1 }* URCR - Rectifier commutating transformer resistance, per bridge, ohms
# h5 N3 z; N6 U9 W6 \' ^, \2 jXCR - Rectifier commutating transformer reactance, per bridge, ohms
EBASR - Rectifier primary base AC volts, KV
TRR - Rectifier transformer ratio
4 B" F2 w& e8 w1 c9 hTAPR - Rectifier tap setting
) }; \: z0 }3 m! a% I( aTPMXR - Maximum rectifier tap setting
TPMNR - Minimum rectifier tap setting
TSTPR - Rectifier tap step
3 a# b. F! T8 r% o+ |$ BThird record contains inverter quantities corresponding to rectifier
quantities above.
: ?! r$ S3 a$ t+ LSwitch Shunt Data
: \  r& q- ]6 d0 H) O2 ]; \=================
- ^0 H7 i7 Q8 s' d% fEnds with I = 0.
; w* E% U8 ~% ~  iI,MODSW,VSWHI,VSWLO,SWREM,BINIT,N1,B1,N2,B2...N8,B8
/ r% N) b* E2 y1 g( i3 G- I: s2 DI - Bus number
) ]8 a9 h. J, l3 c  \% S* N* LMODSW - Mode 0 - fixed 1 - discrete 2 - continuous
  n1 K- ?2 D- C  U8 wVSWHI - Desired voltage upper limit, per unit
1 X3 v0 f% U, N8 d7 [VSWLO - Desired voltage lower limit, per unit
SWREM - Number of remote bus to control. 0 to control own bus.
, T5 C4 @. n% j& ~+ j% ^' W- j. oVDES - Desired voltage setpoint, per unit
BINIT - Initial switched shunt admittance, MVAR at 1.0 per unit volts
" I. ?1 {' R4 o( p6 w/ M6 A8 R  ]N1 - Number of steps for block 1, first 0 is end of blocks
3 b, ?3 n2 r& o6 l7 @4 Y- s. |B1 - Admittance increment of block 1 in MVAR at 1.0 per unit volts.
3 C' a5 t) N% R' ~$ h2 t3 ~N2, B2, etc, as N1, B1

fellowieee

http://www.ee.washington.edu/research/pstca/index.html