TRANSMISSION &
DISTRIBUTION
A Division of Global Power
POWER SYSTEM STABILITY CALCULATION TRAINING
D14
15
A t ti i P th
D
ay
14
-
15
-
A
u
t
oma
ti
on us
i
ng
P
y
th
on
December 5, 2013Prepared by: Mohamed El Chehaly
eBook for You
OUTLINE
2
OUTLINE
• Introduction
• Application Program Interface
• PSS®E Extension Modules
• Power Flow Operation
•
Power Flow Data Changing
•
Power
Flow
Data
Changing
• Subsystem Definition
• Dynamics Simulation
• Single Element and Subsystem Data Retrieval
• Results Data Retrieval
eBook for You
3
INTRODUCTION
INTRODUCTION
eBook for You
Introduction to PSS®E Automation
4
INTRODUCTION
Introduction
to
PSS®E
Automation
Response
files
or
“
idv
”
:
Contains
a
set
of
Response
files
or
idv
:
Contains
a
set
of
instructions and inputs emulating the
program
operation
manual
program
operation
manual
IPLAN programs:
Sim
p
le
p
ro
g
rammin
g
lan
g
ua
g
edesi
g
ned fo
r
p
pg g
gg
g
PSS®E
Created in a text editor and compiled
Limited capabilities compared to modern
programming languages
eBook for You
Introduction to PSS®E Automation
5
INTRODUCTION
Introduction
to
PSS®E
Automation
Python
programs
:
Python
programs
:
Interpreted object-oriented programming language
(
no com
p
iler
)
(
p)
In PSS®E since version 30
Faster development, flexibility, power data
processing and easy integration with othe
r
applications and programming languages
eBook for You
Recording an Automation File
6
INTRODUCTION
Recording
an
Automation
File
eBook for You
Running an Automation File
7
INTRODUCTION
Running
an
Automation
File
eBook for You
8
APPLICATION PROGRAM
APPLICATION
PROGRAM
INTERFACE
eBook for You
Controlling PSS®E Using the API
9
APPLICATION PROGRAM INTERFACE
Controlling
PSS®E
Using
the
API
Set of callable routines for building
ft li ti
so
ft
ware app
li
ca
ti
ons
API is the primary and recommended
method for accessing PSS®E functionality
method
for
accessing
PSS®E
functionality
for automation
API is described in manual
PSS®E
API
is
described
in
manual
PSS®E
Application Program Interface
Descriptions of the syntax for using each
Descriptions
of
the
syntax
for
using
each
API routine in each automation method
Siemens PTI support users who use batch
Siemens
PTI
support
users
who
use
batch
commands and Python programs only.
eBook for You
Default Values
10
APPLICATION PROGRAM INTERFACE
Default
Values
_i: Default integer value
_f: Default real value
s: Default strin
g
value_
g
Example:
def temp ( a
=
1, b
=
2):
def
temp
(
a
1,
b
2):
print a
print b
print
b
return
temp(
i
4)
temp(
_
i
,
4)
eBook for You
11
PSS®E EXTENSION MODULES
PSS®E
EXTENSION
MODULES
eBook for You
Modules for Python
12
PSS®E EXTENSION MODULES
Modules
for
Python
P
P id t th PSS®E API
P
sspy:
P
rov
id
es access
t
o
th
e
PSS®E
API
Pssarrays: Provides Python functions to
retrieve PSS®E solutions results
retrieve
PSS®E
solutions
results
Pssexcel: Provides Python functions
export PSS®E data or solution results to
export
PSS®E
data
or
solution
results
to
Excel
Pssplot
: Provides access to the
PSS®Plot
Pssplot
:
Provides
access
to
the
PSS®Plot
API
eBook for You
Modules for Python
13
PSS®E EXTENSION MODULES
Modules
for
Python
El
PidPthf ti t
E
xce
l
py:
P
rov
id
es
P
y
th
on
f
unc
ti
ons
t
o
interface with Excel (create, populate and
format workbooks)
format
workbooks)
Dyntools
: Tools for processing channel
Dyntools
:
Tools
for
processing
channel
output files
eBook for You
PSSPY
14
PSS®E EXTENSION MODULES
PSSPY
PFlOti
P
ower
Fl
ow
O
pera
ti
on
Power Flow Data Changing
Oi lP Fl
O
pt
i
ma
l
P
ower
Fl
o
w
Dynamic Simulation
Subsystem Definition
Diagram View APIs
Single Element Data Retrieval
Subsystem Data Retrieval
eBook for You
15
POWER FLOW OPERATION
POWER
FLOW
OPERATION
eBook for You
CASE
16
POWER FLOW OPERATION
CASE
Use this API to open a Saved Case (.sav)
eBook for You
NEWCASE2
17
POWER FLOW OPERATION
NEWCASE2
Use this API to open a new Saved Case
(
sav
)
(
.
sav
)
eBook for You
SAVE
18
POWER FLOW OPERATION
SAVE
Use this API to save a Saved Case (.sav)
eBook for You
FNSL
19
POWER FLOW OPERATION
FNSL
Use this API to apply Newton-Raphson
calculation
calculation
eBook for You
FDNS
20
POWER FLOW OPERATION
FDNS
Use this API to apply fixed-slope Newton-
Raphson
calculation
Raphson
calculation
eBook for You
DSCN
21
POWER FLOW OPERATION
DSCN
Use this API to disconnect a bus
eBook for You
PURG
22
POWER FLOW OPERATION
PURG
Use this API to delete an equipment
eBook for You
Other Functions
23
POWER FLOW OPERATION
Other
Functions
POUT: Print the power flow solution results
ANSI:
Calculate fault currents according to
ANSI:
Calculate
fault
currents
according
to
ANSI
ASCC2:
Apply a series of fault at various
ASCC2:
Apply
a
series
of
fault
at
various
locations
IECS3: Calculate fault currents according to
IEC
DFAX: Build a Distribution Factor Data File
(
dfx
)
(
.
dfx
)
ACCC: Apply the AC contingency calculation
function
function
eBook for You
Other Functions
24
POWER FLOW OPERATION
Other
Functions
PV_ENGINE3: Run PV analysis
QV ENGINE:
Run QV analysis
QV
_
ENGINE:
Run
QV
analysis
CONG: Convert generators
CONL:
Convert loads
CONL:
Convert
loads
ORDR: Calculate a sparsity preserving
ordering of buses
FACT: Factorize the network admittance
matrix
TYSL:
Run switching study network solutions
TYSL:
Run
switching
study
network
solutions
eBook for You
25
POWER FLOW DATA
POWER
FLOW
DATA
CHANGING
eBook for You