IEEE PSAP PTI data format

seanchio

Partial Description of the IEEE Common Data Format for the   
Exchange of Solved Load Flow Data
- c0 f6 @3 h8 @- M2 bThe complete description can be found in the paper "Common Data
$ B1 s, [! T) A- w- e% DFormat for the Exchange of Solved Load Flow Data", Working Group on a
: ~1 Z2 e/ D- ~3 X) bCommon Format for the Exchange of Solved Load Flow Data, _IEEE
+ e, w/ a: L% O! rTransactions on Power Apparatus and Systems_, Vol. PAS-92, No. 6,
November/December 1973, pp. 1916-1925.
# m4 v( J4 |4 LThe data file has lines of up to 128 characters. The lines are grouped
, }+ F# Y8 w- ~# e& J& O" yinto sections with section headers. Data items are entered in specific
6 e0 b; B' }( E2 m- `columns. No blank items are allowed, enter zeros instead. Floating point
6 X; q$ I6 M# ^# A, e$ u1 ~items should have explicit decimal point. No implicit decimal points
are used.
Data type codes: A - Alphanumeric (no special characters)
1 R) A7 {0 ^! H# E                 I - Integer
# ^2 L1 G. l8 t  ~                 F - Floating point
                 * - Mandatory item
9 F/ {. O/ C  R2 k8 D+ yTitle 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.
Columns 11-30   Originator's name (A)
9 q: R6 J" i* b6 t3 P0 eColumns 32-37   MVA Base (F*)
Columns 39-42   Year (I)
# ?' O" v( u0 Q3 e' S, d& W3 N5 w5 OColumn  44      Season (S - Summer, W - Winter)
Column  46-73   Case identification (A)
Bus Data *
5 x. l8 {( g. V) N==========
. P- Q; Y& s2 [+ i: A% U- oSection start card *:
) e1 }5 U" Z0 K: |1 D! B% V3 w---------------------
Columns  1-16   BUS DATA FOLLOWS (not clear that any more than BUS in
                1-3 is significant) *
* O) ?% D/ F3 P& \) AColumns  ?- ?   NNNNN ITEMS (column not clear, I would not count on this)
Bus data cards *:
-----------------
4 L8 u2 \  y: [9 Q9 zColumns  1- 4   Bus number (I) *
Columns  7-17   Name (A) (left justify) *
1 b, C) ?1 k- e7 GColumns 19-20   Load flow area number (I) Don't use zero! *
, L, R& Q/ O& T1 t5 W4 w0 ]Columns 21-23   Loss zone number (I)
Columns 25-26   Type (I) *
                 0 - Unregulated (load, PQ)
1 p+ U) H/ x* J3 ]1 `: {                 1 - Hold MVAR generation within voltage limits, (PQ)
                 2 - Hold voltage within VAR limits (gen, PV)
" d8 v* X* g; Q                 3 - Hold voltage and angle (swing, V-Theta) (must always
                      have one)
Columns 28-33   Final voltage, p.u. (F) *
Columns 34-40   Final angle, degrees (F) *
Columns 41-49   Load MW (F) *
! F. m, K: i, f+ hColumns 50-59   Load MVAR (F) *
Columns 60-67   Generation MW (F) *
. G0 r2 V# D" z6 ~Columns 68-75   Generation MVAR (F) *
8 Q$ n9 Q3 }1 \$ O2 }0 _Columns 77-83   Base KV (F)
Columns 85-90   Desired volts (pu) (F) (This is desired remote voltage if
3 y, P: Q# V2 E( \) B                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) *
1 _- u$ j% |8 _) PColumns 124-127 Remote controlled bus number
Section end card:
-----------------
9 |: Q4 N9 u4 N& eColumns  1- 4   -999
2 a* U) i8 j& A) MBranch Data *
=============
Section start card *:
---------------------
0 m. D1 f0 Y, s6 x) `! s6 X3 mColumns  1-16   BRANCH DATA FOLLOWS (not clear that any more than BRANCH
* H, e; Z0 j! L; `, C2 @                is significant) *
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
7 v$ G; e: H! B2 J& ^0 LBranch data cards *:
" A- R- _" V7 l3 x--------------------
Columns  1- 4   Tap bus number (I) *
                 For transformers or phase shifters, the side of the model
                 the non-unity tap is on
Columns  6- 9   Z bus number (I) *
& M0 z$ W4 p2 E# L! q+ h0 `                 For transformers and phase shifters, the side of the model
                 the device impedance is on.
Columns 11-12   Load flow area (I)
, y9 N" u: L. d6 fColumns 13-14   Loss zone (I)
4 U, j- D- H9 F9 [. W. q" ]$ Q! JColumn  17      Circuit (I) * (Use 1 for single lines)
, A% O* [8 y+ V' }+ NColumn  19      Type (I) *
                 0 - Transmission line
% w  C6 n; T. ]) }/ S8 j                 1 - Fixed tap
" N' i1 E7 }. h& @) q                 2 - Variable tap for voltage control (TCUL, LTC)
                 3 - Variable tap (turns ratio) for MVAR control
& b/ Z/ a" q: R' }                 4 - Variable phase angle for MW control (phase shifter)
/ U( A' K  w) D& v4 O6 JColumns 20-29   Branch resistance R, per unit (F) *
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)
; Q) a% r# p" M  ?% t( N) {/ jColumns 51-55   Line MVA rating No 1 (I) Left justify!
3 g% w9 C( y- N* B2 E9 F/ X0 WColumns 57-61   Line MVA rating No 2 (I) Left justify!
Columns 63-67   Line MVA rating No 3 (I) Left justify!
: U! N( @1 D% s1 w9 WColumns 69-72   Control bus number
( J% O) n( {& P; {! F% D5 Z1 v% `1 aColumn  74      Side (I)
                 0 - Controlled bus is one of the terminals
                 1 - Controlled bus is near the tap side
                 2 - Controlled bus is near the impedance side (Z bus)
Columns 77-82   Transformer final turns ratio (F)
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)
7 r: j# k3 {$ gColumns 120-126 Maximum voltage, MVAR or MW limit (F)
0 k3 e2 O% q" Z3 H, ASection end card:
  h, i& q4 \3 [5 A* m-----------------
Columns  1- 4   -999
Loss Zone Data
==============
Section start card
0 T! x2 @. v: l% r------------------
) s0 Y. O6 E* dColumns  1-16   LOSS ZONES FOLLOWS (not clear that any more than LOSS
! H" x' @& H( T$ F0 E9 ]                is significant)
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
7 L2 u2 v/ C* h' D4 b4 nLoss Zone Cards:
----------------
Columns  1- 3   Loss zone number  (I)
! E+ K$ U! K$ u5 v  |Columns  5-16   Loss zone name (A)
, Q. F' v' Y4 l8 b2 @# p+ HSection end card:
-----------------
* g7 T4 v: d+ }. T1 VColumns  1- 3   -99
* ^1 N7 ]5 L( O/ \* O5 c) I8 TInterchange Data *
==================
Section start card
8 @1 r- a! o* \  i------------------
Columns  1-16   INTERCHANGE DATA FOLLOWS (not clear that any more than
7 T$ s, x4 P8 g                first word is significant).
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
Interchange Data Cards *:
  M+ d3 R0 x5 r6 N: Y' ], M8 ~-------------------------
Columns  1- 2   Area number (I) no zeros! *
, e) A9 y& [2 w+ B' hColumns  4- 7   Interchange slack bus number (I) *
% p, B9 ]) `4 {! G' tColumns  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)
Section end card:
( E% ]9 A& C, ^5 K4 G-----------------
Columns  1- 2   -9
0 Z5 n! D/ L6 F$ ]0 a3 sTie Line Data
=============
4 F) ]% L. s7 N6 }7 v9 e! pSection start card
------------------
Columns  1-16   TIE LINES FOLLOW (not clear that any more than TIE
9 Q* J. G* s3 v2 s. O; A2 @8 M  A                is significant)
Columns 40?- ?  NNNNN ITEMS (column not clear, I would not count on this)
Tie Line Cards:
---------------
6 l( e/ m$ K# ]. AColumns  1- 4   Metered bus number (I)
, n5 T2 T3 O5 ?1 t9 ~" K4 ?Columns  7-8    Metered area number (I)
Columns  11-14  Non-metered bus number (I)
Columns  17-18  Non-metered area number (I)
6 T$ j+ b% h/ N7 y! [2 T# RColumn   21     Circuit number
Section end card:
-----------------
Columns  1- 3   -999
END OF DATA

' I! C, T5 j1 \0 w, ^+ ZPSAP File Format
- Q- ^8 H1 p! f$ @May 20, 1993
# R# P2 d, K7 k0 A; AThe 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.
A 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
3 W+ }7 d  s1 q  T: A* G$ gwhich 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.
/ d7 G4 R! U7 Z5 |' n/ ]3 @The 4 card indicates that line data follows. The line data ends with
a 9999 card.
( a9 y. W. v: w/ O. @1 B# I1 f- ~The 5 card indicates that bus data follows. The bus data ends with
a 9999 card.
, Y3 a9 m9 J  A1 q5 E* qThe 15 card indicates that area interchange data follows. The data ends with
a 9999 card.
9 X* `6 v4 e1 g0 _& C, oLine Data Card (Code 4 cards)
( O5 D  C6 L3 y=============================
Cols    Data
. ?  z9 }6 O/ X1 [0 d2 Z% p1-4     From bus number
; ^* u8 A2 G8 d6 b6       Change code (blank in 4 section)
+ n; J% |5 b. k7       '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.
9 y2 V" {3 E. b# {5 W! h, N18-23   Line resistance in percent of base. (NOT per unit.)
3 |; t3 V; Z3 t8 F7 H$ b0 z        (percent = 100 x per unit) Two default decimal places.
2 W1 l1 _  b7 M24-29   Line reactance, in percent. Two default decimal places.
! g: t1 ^+ f+ {+ G' C* S. r$ R30-35   Line charging MVAR (total). Three default decimal places.
36-40   Transformer tap (per unit turns ratio). Three default decimal
/ r2 p; G" l8 f1 O5 S9 l! l5 N* Z: A        places, 1000 = 1.000.
41-45   Min tap, for OLTC. Three default decimal places.
46-50   Max tap, for OLTC. Three default decimal places.
7 T8 p5 \$ I0 H2 `$ e' D1 C9 S51-55   Phase shift angle, for OL phase shifter. Two default decimal places.
56-60   Remote voltage control bus number. Negative if lower tap increases
  B7 [; ^$ R+ R. `        voltage of this bus.
: o. }* r: r) ]1 e8 ^1 f8 K61-64   Normal MVA rating
65-68   Emergency MVA rating
69-72   MVA Base. Default value 100 MVA if blank.
Second Line Card (follows 'C' in first card)
============================================
0 O$ R7 C, v2 W2 L. t+ h% v1-17    Same as first card, except no 'C'. Can be left blank.
  w" Q& {, ?/ Q/ G" Y35-40   Desired MVAR flow or Min voltage setpoint for OLTC.
41-45   Min phase shifter degrees. Two default decimal places.
8 e/ e7 ?. ]5 E9 x' A46-50   Max phase shifter degrees. Two default decimal places.
51-55   Desired MW flow for phase shifter.
% R5 R+ t* J: T57-60   Controlled line from bus.
62-65   Controlled line to bus.
67-70   Available taps (number of taps)
71-75   Maximum voltage setpoint. Three default decimal places.
Bus Cards (Code 5 cards)
: V4 z$ V. F" N& p$ R========================
( q- @5 P! I* j" I- E7 d' u: V+ g1-4     Bus number
6       Change code (blank in 5 section)
7       Continue code (blank in 5 section)
8       Regulated bus code:
         Blank - load (PQ) bus
         1     - gen (PV) bus
         2     - swing (V-Theta) bus
10-21   Name
23-26   Bus voltage (control setpoint or solved value).
5 ~1 X: v6 _" r7 i" M        Three default decimal places.
3 g5 @6 z) `7 L9 T) y/ \8 k- u6 p4 O27-30   Bus angle
3 W" M4 J& P5 O% s; ?* j) W31-35   Generation MW
36-40   Generation MVAR (from solution)
41-45   Generation MVAR low limit
" ~2 V4 |4 t, l8 g46-50   Generation MVAR high limit
51-55   Bus at which generation controls voltage
56-60   Load MW
61-65   Load MVAR
66-70   Shunt MVAR. Reactors are minus.
71-72   Load flow area. (Used for area interchange and losses).
Area Interchange Cards (Code 15 cards)
======================================
( X  u9 q5 b9 Z) b  K* M  @% _" w3-4     Load flow area number
  _( |! P1 d, z. B( @3 N# m5-8     Swing bus for area interchange. Adjusts generation at this bus
; u3 G  v3 k& f" b        to meet area interchange requirement.
, L9 D" E( b% D. d5 h# b9 o9-14    Area exports, MW. (+ = out of area)
15-19   Area Interchange tolerance, MW
) V$ g6 W8 d% P( ^( w9 v7 r20-55   Area name
56-60   Area load (usually left blank)
61-65   Area losses (usually left blank)

+ {1 {! n6 ^. ?

' B3 S% x! |1 q! H; v. B2 kDescription 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.
  r5 x0 w0 x: }; O3 MCase Identification Data
/ r: I# x" d/ o/ S' {) R& g========================
5 ^& ~+ c! p* p, s2 v+ p$ i; X- O) aFirst record: IC,SBASE
+ D2 }  a4 O5 E2 z8 M IC - 0 for base case, 1 for change data to be added
SBASE - System MVA base
' T# g5 [0 n0 e$ ?9 k# J& T2 I1 WRecords 2 and 3 - two lines of heading, up to 60 characters per line
Bus Data
========
) i+ m6 o* H2 }0 i) JBus data records, terminated by a record with a bus number of zero.
I,IDE,PL,QL,GL,BL,IA,VM,VA,'NAME',BASKL,ZONE
5 H  D1 P9 _! v: g( T I - Bus number (1 to 29997)
$ X! ]* u. M) c$ N: {2 \  @" b; W IDE - Bus type
' Z8 C' z0 Z; D9 s6 x7 k        1 - Load bus (no generation)
; K% v  l! |' m& Y        2 - Generator or plant bus
        3 - Swing bus
1 s/ K- m' d  S" Q! ?3 Q% f3 T        4 - Islolated bus
, k. m7 m0 e6 \2 g2 a* u) r PL - Load MW
" o, U$ w6 V" j. | QL - Load MVAR
* }" B7 \  G* s, E% { GL - Shunt conductance, MW at 1.0 per unit voltage
BL - Shunt susceptance, MVAR at 1.0 per unit voltage. (- = reactor)
IA - Area number, 1-100
VM - Voltage magnitude, per unit
VA - Voltage angle, degrees
' d( ]& q& z0 o7 d8 L- A NAME - Bus name, 8 characters, must be enclosed in quotes
8 ^% x3 f4 @# d$ Q, x4 }2 \; f BASKV - Base voltage, KV
3 d) |' {9 b/ |* c3 g ZONE - Loss zone, 1-999
2 H# h! O7 M+ d2 AGenerator Data
# D5 Y' E. b( a4 ]4 p6 J* V==============
: A. P3 R- K9 D5 \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
ID - Machine identifier (0-9, A-Z)
( ?8 C5 [: o  d) zPG - MW output
QG - MVAR output
QT - Max MVAR
QB - Min MVAR
VS - Voltage setpoint
% G6 Z' R0 @+ }# t' [IREG - Remote controlled bus index (must be type 1), zero to control own
voltage, and must be zero for gen at swing bus
+ }5 p% g6 k( |2 O3 DMBASE - Total MVA base of this machine (or machines), defaults to system
MVA base.
ZR,ZX - Machine impedance, pu on MBASE
RT,XT - Step up transformer impedance, p.u. on MBASE
; B1 Z7 Q  i! g2 z% w4 XGTAP - 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
PT - Max MW
PB - Min MW
Branch Data
===========
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
5 g2 I5 A$ o5 Y5 n9 fI - From bus number
J - To bus number
CKT - Circuit identifier (two character) not clear if integer or alpha
& I6 A1 S- U5 ?R - Resistance, per unit
X - Reactance, per unit
% T6 T2 v& T: `1 Q' R" fB - Total line charging, per unit
RATEA - MVA rating A
. v/ Q% @0 G7 J+ k4 w" d" C' uRATEB, RATEC - Higher MVA ratings
9 H( t5 ?, v" H6 S& b- ORATIO - 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.
% E8 J) a* n- k6 ~. o; zST - Initial branch status, 1 - in service, 0 - out of service
* z# r: E* Q5 M6 x5 ~Transformer Adjustment Data
===========================
Ends with record with from bus of zero
" \4 ~- m" _/ }I,J,CKT,ICONT,RMA,RMI,VMA,VMI,STEP,TABLE
I - From bus number
: t, U8 v, Y, J$ v2 \6 e! sJ - To bus number
CKT - Circuit number
$ D) {% R; q( Q4 G4 a% d) V% b% G# CICONT - Number of bus to control. If different from I or J, sign of ICONT
determines control. Positive sign, close to impedance (untapped) bus
of transformer. Negative sign, opposite.
7 M6 F% Y' @9 ~' DRMA - Upper limit of turns ratio or phase shift
% Z/ F. c9 T! P! d5 W+ RRMI - Lower limit of turns ratio or phase shift
2 v% E, @+ c( r7 P6 I7 xVMA - Upper limit of controlled volts, MW or MVAR
; g, y4 W; C3 k3 l! ^3 }- K+ ZVMI - Lower limit of controlled volts, MW or MVAR
STEP - Turns ratio step increment
TABLE - Zero, or number of a transformer impedance correction table 1-5
Area Interchange Data
* r7 \4 G  e7 f' i8 e=====================
1 Y, z  ~- }/ B, r# @3 M/ W* [Ends with I of zero
I,ISW,PDES,PTOL,'ARNAM'
( O% F4 d5 v7 f6 f: _9 Z8 bI - Area number (1-100)
( m/ L' f3 r& K( AISW - Area interchange slack bus number
PDES - Desired net interchange, MW + = out.
PTOL - Area interchange tolerance, MW
ARNAM - Area name, 8 characters, enclosed in single quotes.
DC Line Data
* f: z7 \& n& k- Y' Z============
Ends with I of zero
2 |0 d) ]2 Q/ L6 Y4 v( L  aEach DC line has three consecutive records
) }7 a( g2 p4 g7 E8 EI,MDC,RDC,SETVL,VSCHD,VCMOD,RCOMP,DELTI,METER
5 [) v1 X* ?7 q6 @# vIPR,NBR,ALFMAX,ALFMN,RCR,XCR,EBASR,TRR,TAPR,TPMXR,TPMNR,TSTPR
IPI,NBI,GAMMX,GAMMN,RCI,XCI,EBASI,TRI,TAPI,TPMXI,TPMNI,TSTPI
1 M! q5 h: W5 iI - DC Line number
3 i2 f$ {7 ]  L: [: ]7 Q  p+ @- [MDC - Control mode 0 - blocked 1 - power 2 - current
* v- u$ r) L+ S4 b! ?# c/ }RDC - Resistance, ohms
SETVL - Current or power demand
& }3 W- Q5 Z( h% v6 _( j! ^VSCHD - Scheduled compunded DC voltage, KV
5 o. e# q  v% F7 R% TVCMOD - Mode switch DC voltage, KV, switch to current control mode below this
; ]3 m  ^: e) R/ rRCOMP - Compounding resistance, ohms
DELTI - Current margin, per unit of desired current
3 K: k0 S' @# p8 j1 WMETER - Metered end code, R - rectifier I - Inverter
+ D0 H. ]/ N; l% i% P7 W% \IPR - Rectifier converter bus number
+ P( J, X  m- o4 y% e9 v( pNBR - Number of birdges is series rectifier
ALFMAX - Maximum rectifier firing angle, degrees
ALFMN - Minimum rectifier firing angle, degrees
RCR - Rectifier commutating transformer resistance, per bridge, ohms
XCR - Rectifier commutating transformer reactance, per bridge, ohms
EBASR - Rectifier primary base AC volts, KV
1 t- @, A1 x6 ~: @8 t& E- iTRR - Rectifier transformer ratio
5 `. g% }" y! ~+ s9 o5 S8 x9 UTAPR - Rectifier tap setting
TPMXR - Maximum rectifier tap setting
TPMNR - Minimum rectifier tap setting
$ l! ^; o& P/ j7 S) k: |TSTPR - Rectifier tap step
5 D+ M5 _& k* Q  LThird record contains inverter quantities corresponding to rectifier
quantities above.
Switch Shunt Data
7 Y# j& x, V2 O7 z) {) t=================
4 ~5 g4 l1 A. b4 pEnds with I = 0.
0 f$ X2 D8 Q) \# M) v4 HI,MODSW,VSWHI,VSWLO,SWREM,BINIT,N1,B1,N2,B2...N8,B8
I - Bus number
MODSW - Mode 0 - fixed 1 - discrete 2 - continuous
VSWHI - Desired voltage upper limit, per unit
VSWLO - Desired voltage lower limit, per unit
5 ]  f% x9 x- sSWREM - Number of remote bus to control. 0 to control own bus.
VDES - Desired voltage setpoint, per unit
9 }6 X% f5 f  Z: r$ ^. jBINIT - 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.
8 [3 H' P! Z7 w' NN2, B2, etc, as N1, B1

fellowieee

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