IEEE PSAP PTI data format

seanchio

Partial Description of the IEEE Common Data Format for the   
1 v, `9 Q0 d+ s2 F( `" uExchange of Solved Load Flow Data
7 R5 P/ \' ^% }/ u% R8 DThe complete description can be found in the paper "Common Data
9 q( r3 o. L% C3 X3 N& HFormat 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,
November/December 1973, pp. 1916-1925.
( @: @/ U: U- ]& y3 ZThe data file has lines of up to 128 characters. The lines are grouped
into sections with section headers. Data items are entered in specific
! b# J$ @( i7 t! h" ccolumns. No blank items are allowed, enter zeros instead. Floating point
items should have explicit decimal point. No implicit decimal points
1 B$ U9 H; x% E: w2 L& mare used.
. O  g5 N) ]/ \. a: J) J& s( S) YData type codes: A - Alphanumeric (no special characters)
. H4 f# Z( C& ?& u                 I - Integer
                 F - Floating point
                 * - Mandatory item
Title Data
5 w1 l( g/ B/ N3 ^==========
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.
1 N/ F# o# }+ j6 o+ J; |1 r3 iColumns 11-30   Originator's name (A)
3 J5 ~$ r$ f6 T1 C2 Z6 oColumns 32-37   MVA Base (F*)
Columns 39-42   Year (I)
. L4 ^+ R# j. u' x9 b7 {2 n6 n# CColumn  44      Season (S - Summer, W - Winter)
Column  46-73   Case identification (A)
Bus Data *
==========
) l$ v: X& |) D3 i" Q% O$ ISection start card *:
---------------------
Columns  1-16   BUS DATA FOLLOWS (not clear that any more than BUS in
                1-3 is significant) *
1 x9 L  x! `1 T& n  u# i& {8 cColumns  ?- ?   NNNNN ITEMS (column not clear, I would not count on this)
Bus data cards *:
-----------------
Columns  1- 4   Bus number (I) *
Columns  7-17   Name (A) (left justify) *
Columns 19-20   Load flow area number (I) Don't use zero! *
Columns 21-23   Loss zone number (I)
Columns 25-26   Type (I) *
- l; U$ t8 w2 d- U5 ~+ @8 W                 0 - Unregulated (load, PQ)
                 1 - Hold MVAR generation within voltage limits, (PQ)
                 2 - Hold voltage within VAR limits (gen, PV)
                 3 - Hold voltage and angle (swing, V-Theta) (must always
                      have one)
/ x1 z* Z3 v  M) BColumns 28-33   Final voltage, p.u. (F) *
: G" `3 P( V' d: C. b2 p" A3 XColumns 34-40   Final angle, degrees (F) *
. O1 S8 T) j! oColumns 41-49   Load MW (F) *
* M/ C, G$ M6 U( EColumns 50-59   Load MVAR (F) *
8 p/ K, Y( f) K. J$ [: g( HColumns 60-67   Generation MW (F) *
: J  j' S6 S/ vColumns 68-75   Generation MVAR (F) *
Columns 77-83   Base KV (F)
Columns 85-90   Desired volts (pu) (F) (This is desired remote voltage if
                this bus is controlling another bus.
, m8 j: Y7 z. R4 F6 s7 d4 xColumns 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) *
- U2 f& v8 Z2 a9 |' c8 i6 qColumns 115-122 Shunt susceptance B (per unit) (F) *
Columns 124-127 Remote controlled bus number
5 y: Y: r6 X$ X% m' sSection end card:
-----------------
Columns  1- 4   -999
Branch Data *
=============
Section start card *:
% p' I8 V- T( \, b---------------------
Columns  1-16   BRANCH DATA FOLLOWS (not clear that any more than BRANCH
' ]4 Y2 Y0 G8 [                is significant) *
7 R. D  u# t; O' y7 cColumns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
Branch data cards *:
4 P( G. k, n! B: w+ b! R. ~: I--------------------
! D) X$ U% s0 G9 f  ]! rColumns  1- 4   Tap bus number (I) *
+ J2 t2 s" k: p                 For transformers or phase shifters, the side of the model
                 the non-unity tap is on
# C: j8 N! ?0 @. u3 |Columns  6- 9   Z bus number (I) *
                 For transformers and phase shifters, the side of the model
                 the device impedance is on.
) A1 V8 u* k8 c0 M+ N3 {Columns 11-12   Load flow area (I)
) T  t) [# u: aColumns 13-14   Loss zone (I)
Column  17      Circuit (I) * (Use 1 for single lines)
. y0 j/ \/ ]+ f+ e6 d, @& hColumn  19      Type (I) *
                 0 - Transmission line
                 1 - Fixed tap
                 2 - Variable tap for voltage control (TCUL, LTC)
                 3 - Variable tap (turns ratio) for MVAR control
7 m  A. t* b/ s                 4 - Variable phase angle for MW control (phase shifter)
Columns 20-29   Branch resistance R, per unit (F) *
# U1 e. U7 M. i0 N6 Z4 B' O! _Columns 30-40   Branch reactance X, per unit (F) * No zero impedance lines
Columns 41-50   Line charging B, per unit (F) * (total line charging, +B)
Columns 51-55   Line MVA rating No 1 (I) Left justify!
9 a7 b2 s. @: S* C3 q! I) qColumns 57-61   Line MVA rating No 2 (I) Left justify!
Columns 63-67   Line MVA rating No 3 (I) Left justify!
5 I/ H  @+ q9 I( S, F$ Z" CColumns 69-72   Control bus number
! d$ c0 e+ e) e) ?Column  74      Side (I)
9 M3 z2 b1 x9 m7 ?6 n( ^                 0 - Controlled bus is one of the terminals
                 1 - Controlled bus is near the tap side
1 o. T3 W* r% J5 r- }                 2 - Controlled bus is near the impedance side (Z bus)
Columns 77-82   Transformer final turns ratio (F)
- M7 Z  ]0 ?, W3 N: O! z5 aColumns 84-90   Transformer (phase shifter) final angle (F)
" K" j. m4 p0 _* m/ A4 Y, B- ^3 fColumns 91-97   Minimum tap or phase shift (F)
Columns 98-104  Maximum tap or phase shift (F)
( h; K% g4 C( `7 N1 t% JColumns 106-111 Step size (F)
Columns 113-119 Minimum voltage, MVAR or MW limit (F)
2 P. F9 V! N. ?1 k) U3 EColumns 120-126 Maximum voltage, MVAR or MW limit (F)
# u  j" {( N+ @2 e* r& jSection end card:
-----------------
7 s& p' ~+ E. h% jColumns  1- 4   -999
1 P7 @: b: d5 k" J* _+ vLoss Zone Data
9 B! u* M- z  Y3 L* S==============
Section start card
# s8 M9 J5 Z+ K" @9 X0 R- t------------------
Columns  1-16   LOSS ZONES FOLLOWS (not clear that any more than LOSS
                is significant)
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
Loss Zone Cards:
----------------
Columns  1- 3   Loss zone number  (I)
, b# a# A& X+ y, N. a4 G. E# R8 }0 UColumns  5-16   Loss zone name (A)
Section end card:
7 s8 {8 v4 V5 q" x4 ^-----------------
; v1 r/ }7 H* `Columns  1- 3   -99
Interchange Data *
! i) [' R8 E" @5 S==================
2 Z3 l% T& L9 C+ S6 F- S0 QSection start card
------------------
: O4 N9 h' Z- w7 S; nColumns  1-16   INTERCHANGE DATA FOLLOWS (not clear that any more than
                first word is significant).
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
0 `* }7 q% W6 _# v: j3 fInterchange Data Cards *:
, y- Z* l' _  j* {: B# K  p; r-------------------------
, J5 L9 Z8 |* z6 _$ C" kColumns  1- 2   Area number (I) no zeros! *
Columns  4- 7   Interchange slack bus number (I) *
Columns  9-20   Alternate swing bus name (A)
. s0 n" ?; j5 k( P: Y- e9 L* DColumns 21-28   Area interchange export, MW (F) (+ = out) *
( C4 }- T, D) v  ?2 D( }Columns 30-35   Area interchange tolerance, MW (F) *
Columns 38-43   Area code (abbreviated name) (A) *
Columns 46-75   Area name (A)
% E; Q" `+ ~* F3 a9 fSection end card:
-----------------
* v: A+ N2 N) BColumns  1- 2   -9
, n8 o5 W2 u# u: bTie Line Data
: U' h( p- @; G/ q! M  `* _2 W=============
Section start card
' n/ j$ y) m0 n------------------
Columns  1-16   TIE LINES FOLLOW (not clear that any more than TIE
                is significant)
9 M6 ^& J0 `0 [/ {+ F$ v7 UColumns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
: f" n, \/ ?, o" `+ MTie Line Cards:
  `7 i& l1 v* ?' u. g5 ^) z---------------
Columns  1- 4   Metered bus number (I)
9 m$ H6 e/ P2 v! W! mColumns  7-8    Metered area number (I)
Columns  11-14  Non-metered bus number (I)
Columns  17-18  Non-metered area number (I)
Column   21     Circuit number
Section end card:
; ]* t# |6 L  m5 @8 H-----------------
Columns  1- 3   -999
END OF DATA
" s4 x$ G# k1 o
5 e& A9 a' @4 n. j7 S+ V+ DPSAP File Format
) [7 K0 K$ F6 v, {6 {8 g: j8 `May 20, 1993
The PECO PSAP File Format is fully described in the _PJM Power System
& @+ \; \" H1 D1 p  T& tAnalysis Package Use's Guide_, available from the Philadelphia
8 t3 h* S) X: r$ o. h: z0 `Electric Company. The following is a rough description of the
1 G2 K$ M/ g# \3 xmost important parts of the format.
5 L/ K' U8 [: P  q) M  yA 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.
The 1 code indicates that the next card is the case title. Only one
title is allowed per case.
4 ?- u4 |* H9 BThe 4 card indicates that line data follows. The line data ends with
1 P& }5 A. i& C1 b' D0 c0 [" U+ na 9999 card.
. m  I" [) c0 z5 r0 |The 5 card indicates that bus data follows. The bus data ends with
* `: r! {, p% ~7 e- X5 qa 9999 card.
7 L; r; y" z/ L9 KThe 15 card indicates that area interchange data follows. The data ends with
' l8 `7 u* {" D, F! C0 sa 9999 card.
. Q# Z8 L5 E! q9 O" vLine Data Card (Code 4 cards)
=============================
: Q) ^; k; w% `* xCols    Data
3 k$ E) C3 ?& V% k8 G; m* D$ B  B1-4     From bus number
# I# g( S" @3 j' N" n  X6       Change code (blank in 4 section)
7       'C' if second card present for same line. Used for transformers.
# d* y' ?' n) a& B9-12    To bus number
14      Circuit number (blank in 4 section)
. l$ ^$ J1 b! S' c16      'T' or 'F' - Load flow area of bus at this end of line gets losses.
. K- ?6 H! l/ @18-23   Line resistance in percent of base. (NOT per unit.)
& D, J" i: {3 D9 G& m: M        (percent = 100 x per unit) Two default decimal places.
1 t5 k  F/ B- y) u+ s, d1 e) [24-29   Line reactance, in percent. Two default decimal places.
30-35   Line charging MVAR (total). Three default decimal places.
36-40   Transformer tap (per unit turns ratio). Three default decimal
        places, 1000 = 1.000.
41-45   Min tap, for OLTC. Three default decimal places.
46-50   Max tap, for OLTC. Three default decimal places.
; G* o! `9 ~$ n" `8 _: M  L. y7 F6 h51-55   Phase shift angle, for OL phase shifter. Two default decimal places.
56-60   Remote voltage control bus number. Negative if lower tap increases
* W" f2 h; e9 }        voltage of this bus.
61-64   Normal MVA rating
65-68   Emergency MVA rating
/ {4 w8 M3 v+ W6 o  S69-72   MVA Base. Default value 100 MVA if blank.
Second Line Card (follows 'C' in first card)
% `' }9 \; u' e============================================
1-17    Same as first card, except no 'C'. Can be left blank.
35-40   Desired MVAR flow or Min voltage setpoint for OLTC.
3 i) Y+ `* a8 `9 N41-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.
57-60   Controlled line from bus.
0 B# L& Z# ?0 B; c: ?" W62-65   Controlled line to bus.
67-70   Available taps (number of taps)
71-75   Maximum voltage setpoint. Three default decimal places.
$ A) }4 R( n# p! g7 O+ TBus Cards (Code 5 cards)
========================
1-4     Bus number
, V: O1 D/ i3 j0 C6       Change code (blank in 5 section)
/ r- a$ n* }$ ]& e: P2 N8 B. E/ t7       Continue code (blank in 5 section)
8       Regulated bus code:
! n+ `2 R  O; N& y/ d( U! P         Blank - load (PQ) bus
! X, l8 h+ j# z) q/ |         1     - gen (PV) bus
         2     - swing (V-Theta) bus
$ c. f9 Q. i% Y9 X# t5 b10-21   Name
23-26   Bus voltage (control setpoint or solved value).
+ ]" k' d  q& r; G! O        Three default decimal places.
$ Z8 x, X- Z2 M5 }% b27-30   Bus angle
4 K: P: R& B' }; u; f* ~31-35   Generation MW
36-40   Generation MVAR (from solution)
* ^! {) E/ H5 s41-45   Generation MVAR low limit
+ ?" X0 e$ }- t46-50   Generation MVAR high limit
51-55   Bus at which generation controls voltage
/ i- o7 |3 Z" U56-60   Load MW
0 k' V5 R0 o6 i( i61-65   Load MVAR
66-70   Shunt MVAR. Reactors are minus.
+ U2 d3 X- Z: a0 ~71-72   Load flow area. (Used for area interchange and losses).
1 h+ S3 O$ }  l1 t/ j2 d( DArea Interchange Cards (Code 15 cards)
======================================
3-4     Load flow area number
5-8     Swing bus for area interchange. Adjusts generation at this bus
; `! e; h' n$ U' s        to meet area interchange requirement.
1 ^0 W; r+ o7 N$ R2 O9-14    Area exports, MW. (+ = out of area)
5 ?/ u3 a1 G7 c5 I$ I15-19   Area Interchange tolerance, MW
20-55   Area name
56-60   Area load (usually left blank)
61-65   Area losses (usually left blank)



Description of the PTI Load Flow Data Format
============================================
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
========================
1 D) |; `$ l; vFirst 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
. T8 ?4 w- O6 L+ ~2 ~Bus Data
* ?7 `0 l, t6 l+ B& ]========
* b. o" V: j* s: H) wBus data records, terminated by a record with a bus number of zero.
I,IDE,PL,QL,GL,BL,IA,VM,VA,'NAME',BASKL,ZONE
I - Bus number (1 to 29997)
IDE - Bus type
. ]1 N4 F6 Y0 G  n7 F        1 - Load bus (no generation)
3 v! B# L; I1 ^( w- j        2 - Generator or plant bus
        3 - Swing bus
" K- F/ i3 T# `, a0 O        4 - Islolated bus
PL - Load MW
QL - Load MVAR
GL - Shunt conductance, MW at 1.0 per unit voltage
: Q- e' t5 Z" A5 F, `- ~ BL - Shunt susceptance, MVAR at 1.0 per unit voltage. (- = reactor)
; ]( g( c* ]! y9 w+ H IA - Area number, 1-100
VM - Voltage magnitude, per unit
VA - Voltage angle, degrees
NAME - Bus name, 8 characters, must be enclosed in quotes
- U( L% V* F) P% D+ `3 f1 l+ ` BASKV - Base voltage, KV
ZONE - Loss zone, 1-999
Generator Data
2 {, g% ^/ \" M3 k# O7 k==============
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
* A3 L- E8 ~, P# E+ @6 E% C0 oID - Machine identifier (0-9, A-Z)
  o; [4 t6 b: T- APG - MW output
) e6 g  p! `# U/ f1 a; {, DQG - MVAR output
5 n* H6 I* c) [& k9 xQT - Max MVAR
/ L0 a" n6 Z( n' XQB - Min MVAR
VS - Voltage setpoint
IREG - Remote controlled bus index (must be type 1), zero to control own
voltage, and must be zero for gen at swing bus
MBASE - Total MVA base of this machine (or machines), defaults to system
0 m: Y1 h% C- M4 v9 i3 D MVA base.
ZR,ZX - Machine impedance, pu on MBASE
RT,XT - Step up transformer impedance, p.u. on MBASE
6 W4 x) p/ [: t6 G. b5 ^8 DGTAP - Step up transformer off nominal turns ratio
STAT - Machine status, 1 in service, 0 out of service
RMPCT - Percent of total VARS required to hold voltage at bus IREG
to come from bus I - for remote buses controlled by several generators
: z; M0 u4 w/ E/ APT - Max MW
: U' i  U. _" c- r! xPB - Min MW
Branch Data
( i: H6 I* z2 z===========
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
+ c; m* T, `5 W  ?CKT - Circuit identifier (two character) not clear if integer or alpha
5 Q% F+ L# ?+ D% R) P' XR - Resistance, per unit
X - Reactance, per unit
B - Total line charging, per unit
RATEA - MVA rating A
+ q# j/ \% X7 b; b$ VRATEB, RATEC - Higher MVA ratings
# ?! W- b% x# i8 G4 t% S! NRATIO - Transformer off nominal turns ratio
3 j! Q" D2 l% c- K/ fANGLE - Transformer phase shift angle
' l% C9 [- E1 cGI,BI - Line shunt complex admittance for shunt at from end (I) bus, pu.
& Y4 A9 ^) U+ {6 YGJ,BJ - Line shunt complex admittance for shunt at to end (J) bus, pu.
5 m' N, t- f+ ?* sST - Initial branch status, 1 - in service, 0 - out of service
Transformer Adjustment Data
1 u# f- }( s' |" a! C===========================
Ends with record with from bus of zero
I,J,CKT,ICONT,RMA,RMI,VMA,VMI,STEP,TABLE
I - From bus number
J - To bus number
CKT - Circuit number
ICONT - Number of bus to control. If different from I or J, sign of ICONT
7 C! U3 V$ V$ p$ M) n) ~ determines control. Positive sign, close to impedance (untapped) bus
: J) d2 ^3 m2 H% n7 E of transformer. Negative sign, opposite.
RMA - Upper limit of turns ratio or phase shift
RMI - Lower limit of turns ratio or phase shift
& L) s. x8 Q) t' d' L2 P  F6 XVMA - Upper limit of controlled volts, MW or MVAR
% A3 ~- g5 d* CVMI - Lower limit of controlled volts, MW or MVAR
0 K1 _: u& Q, jSTEP - Turns ratio step increment
TABLE - Zero, or number of a transformer impedance correction table 1-5
Area Interchange Data
" W1 M7 H5 c* g=====================
. \3 V" X& I6 Q. Q' ^/ K. ^0 ~Ends with I of zero
# l# u8 _( b4 F" H+ rI,ISW,PDES,PTOL,'ARNAM'
I - Area number (1-100)
ISW - Area interchange slack bus number
PDES - Desired net interchange, MW + = out.
/ B$ }7 `$ k' U& K, bPTOL - Area interchange tolerance, MW
ARNAM - Area name, 8 characters, enclosed in single quotes.
% a' ~& _! l" q9 ?' MDC Line Data
. V1 y- k, ~% u. c5 V( @============
$ R0 R: m3 |! [1 _' w# `6 g$ aEnds with I of zero
Each DC line has three consecutive records
; b8 j" z. ?+ D) `  iI,MDC,RDC,SETVL,VSCHD,VCMOD,RCOMP,DELTI,METER
IPR,NBR,ALFMAX,ALFMN,RCR,XCR,EBASR,TRR,TAPR,TPMXR,TPMNR,TSTPR
1 O" E) H0 ^) M  K0 i/ N% L+ RIPI,NBI,GAMMX,GAMMN,RCI,XCI,EBASI,TRI,TAPI,TPMXI,TPMNI,TSTPI
I - DC Line number
$ Z: k! f( `( {. B; ?% hMDC - Control mode 0 - blocked 1 - power 2 - current
/ R- a& p& u- j9 ]6 @RDC - Resistance, ohms
/ M/ I& \+ c; M" k3 d% Y9 M; v( R% nSETVL - Current or power demand
VSCHD - Scheduled compunded DC voltage, KV
+ `5 z0 B& N$ l. ]1 ?: M; WVCMOD - Mode switch DC voltage, KV, switch to current control mode below this
RCOMP - Compounding resistance, ohms
8 o2 G5 H" q5 |* v! @2 ODELTI - Current margin, per unit of desired current
METER - Metered end code, R - rectifier I - Inverter
! A0 h) ]; W5 n/ ~7 @IPR - Rectifier converter bus number
NBR - Number of birdges is series rectifier
ALFMAX - Maximum rectifier firing angle, degrees
ALFMN - Minimum rectifier firing angle, degrees
$ S6 d* H- G4 J/ a; ^* ARCR - Rectifier commutating transformer resistance, per bridge, ohms
XCR - Rectifier commutating transformer reactance, per bridge, ohms
" R# S: x) e4 ^8 @EBASR - Rectifier primary base AC volts, KV
TRR - Rectifier transformer ratio
TAPR - Rectifier tap setting
TPMXR - Maximum rectifier tap setting
TPMNR - Minimum rectifier tap setting
TSTPR - Rectifier tap step
* n( [; ~+ e* m7 hThird record contains inverter quantities corresponding to rectifier
quantities above.
. ]7 P1 T# b0 G# n8 G$ OSwitch Shunt Data
, M- i3 E) I+ k; [=================
7 U6 a( g& O8 ?+ y8 }Ends with I = 0.
I,MODSW,VSWHI,VSWLO,SWREM,BINIT,N1,B1,N2,B2...N8,B8
I - Bus number
0 `; ^1 f( E9 ~6 O" C" e8 dMODSW - Mode 0 - fixed 1 - discrete 2 - continuous
% h5 ]6 x2 Y( ^; @VSWHI - Desired voltage upper limit, per unit
VSWLO - Desired voltage lower limit, per unit
' c7 j) I) D6 v' m$ D6 G( H" GSWREM - Number of remote bus to control. 0 to control own bus.
* r, v" O3 F+ P7 R, K( b7 ^VDES - Desired voltage setpoint, per unit
BINIT - Initial switched shunt admittance, MVAR at 1.0 per unit volts
N1 - Number of steps for block 1, first 0 is end of blocks
B1 - Admittance increment of block 1 in MVAR at 1.0 per unit volts.
% `" h6 ]( r1 ~- l( BN2, B2, etc, as N1, B1

fellowieee

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