U ECE 524

I Installing ATP: Lecture 3

• Minimum to Download
» Mingw version of ATP
» ATPDraw -- latest version or latest patch
– Presently Atpdraw57.zip
» PlotXY
• Installation complete set is a little tricky
• Option: ATP Easy Installer
» Download from secure sites in Japan

Intro to ATP and ATPDraw 1 Spring 2012

U ECE 524

I Installing ATPDraw
Lecture 3

• Installation is fairly easy

• Default installation path “Program Files”
• The space in the file name can create
problems running ATP from ATPDraw
» Install it somewhere else. I normally install in
“C:\tools\prog\ATPDraw”
• Install program creates shortcut in the start
menu, but not very cleanly

Intro to ATP and ATPDraw 2 Spring 2012

U Running ATP from ECE 524

I ATPDraw
Lecture 3

• Still need a copy of ATP

• Licensed users can get other versions
• Follow installation directions for yours
• ATPDraw calls ATP from a DOS Batch
file (extension *.bat)
» For example, I call it “RUNATP.BAT”
• Passes full path to file when calls ATP

Intro to ATP and ATPDraw 3 Spring 2012

U ECE 524

I Sample Batch File

Lecture 3

• The following batch file is for Ming32 ATP

SET GNUDIR=C:\tools\prog\atp\
SET PATH=C:\tools\prog\atp;"%PATH%”
tpbig both %1 s -r

The first line defines variable GNUDIR

» Different ATP versions use different name
» Sets program working environment
» The final “\” is important

Intro to ATP and ATPDraw 4 Spring 2012

U ECE 524

I Sample Batch File (cont.) Lecture 3

• Second line adds executable to your search

path (not needed if set this at boot time)
• The next line calls ATP itself
» tpbig both %1 s -R
– “both” tells program to write error messages to screen
and to file (useful for debugging)
– Could also set “disk” to only do disk file or leave blank
for no message
– First “%1” is input data file from ATPDraw

Intro to ATP and ATPDraw 5 Spring 2012

U ECE 524

I Sample Batch File (cont.) Lecture 3

– The “s” is to create appropriate output file.

– “-R” tells ATP overwrite existing output file if one
exists
• This bat file will let you run ATP, and all of
the support program (line constants etc)

Intro to ATP and ATPDraw 6 Spring 2012

U ECE 524

I Editing “startup”
Lecture 3

• ATP reads a file called “startup”

» Resides in same directory as tpbig
» Sets variables for the program
• A few suggested changes from default
» Change PL4 file format to work with PlotXY
– NOBLAN set to 0 {ignore blank lines}
– NEWPL4 set to 2 {won’t work with Analyzer}

Intro to ATP and ATPDraw 7 Spring 2012

U ECE 524

I Setting Up ATPDraw
Lecture 3

• Open up ATPDraw
• Select: “Tools” pull down menu
• Select: “Options...”
• Choose “Preferences” tab
» You select a text editor, or use Notepad (default)
» “ATP” is where you set path to your batch file
• Armafit: which we won’t cover in this course

Intro to ATP and ATPDraw 8 Spring 2012

U ECE 524

I ATPDraw “Preferences”
Lecture 3

Intro to ATP and ATPDraw 9 Spring 2012

U ECE 524

I Further Settings Lecture 3

• The “Files&Folders” tab settings are ok

• However, you do want changes in the
View/ATP tab
» Select “Edit settings” tab
» You may want to change
some of the default
settings. However, you
can change any of these
for a specific data file

Intro to ATP and ATPDraw 10 Spring 2012

U ECE 524

I Simulation Settings Lecture 3

• Default time step (deltaT)

is very small
• Default run time short
• Xopt and Copt ok
• Select “Power Frequency”
» Reset to 60 Hz from 50Hz
» Can mess up some sources

Intro to ATP and ATPDraw 11 Spring 2012

U ECE 524

I Output Settings Lecture 3

• Probably don’t need the

selected “Printout”
options for most cases
• Slow down the program
somewhat
• Plot frequency should be
low and odd.

Intro to ATP and ATPDraw 12 Spring 2012

U ECE 524

I Other Settings Lecture 3

• Switch/UM settings ok for most cases (are

for statistical studies only)
• Load flow controls controls how the load
flow initialization is run
• Variables: Use can define parameters
here and pass them different components
» Or control them with Pocket Calculator option
» See help file for more info

Intro to ATP and ATPDraw 13 Spring 2012

U ECE 524

I Saving New Settings Lecture 3

• The “Save” or “Apply” buttons aren’t

sufficient to permanently save change
• Also choose: Tools --> Save Options
• These are all saved into a file called
ATPDraw.ini
» Typically saved in user’s settings
» Could put copy in the directory with
ATPDraw.exe

Intro to ATP and ATPDraw 14 Spring 2012

U ECE 524

I Other Settings Lecture 3

• To set other plotting programs or other post

processing options you need to open a file
» Either select the “File|Open” sequence of click on
the icon
» Initial default is the Examples directory, after that
it is the last directory worked in.
» For now, choose example “Exa_1.adp” (*.adp
represents the drawing files).

Intro to ATP and ATPDraw 15 Spring 2012

U ECE 524

I Example 1 Lecture 3

• Try to run
example case
to make sure
program
installed and
set up
correctly

Intro to ATP and ATPDraw 16 Spring 2012

U ECE 524

I ATP Menu Lecture 3

• A new pulldown menu is now available at

the top of the window, called “ATP”

Intro to ATP and ATPDraw 17 Spring 2012

U ECE 524

I ATP Menu Lecture 3

• Settings is changes deltaT

etc. for a given case
• “Make File As” generates
ATP data file from drawing
• Run ATP calls your bat file
• Each “Edit” calls text editor
• Make Names, makes node
names for drawing
Intro to ATP and ATPDraw 18 Spring 2012
U ECE 524

I Edit Commands Lecture 3

• Allows you to set

additional commands
• Run other ATP versions
» On Current ATP drawing
» On Selected File
• Run plot programs
» On Current PL4
• Use “Update” to set
Intro to ATP and ATPDraw 19 Spring 2012

U ECE 524

I Saving New Settings Lecture 3

• The “Update” buttons isn’t sufficient to

save for next time
• All choose: Tools --> Save Options

Intro to ATP and ATPDraw 20 Spring 2012

U ECE 524

I Running an ATP File Lecture 3

• Now we run the example case opened earlier

• Always a multi-step process
» 1) Make file to create ATP data file from drawing.
– Must do this every time you change drawing
– Default is to place this in “ATP” subdirectory under
ATPDraw home directory (with extension *.ATP)
– Can edit this file with “Edit ATP-File” option (not saved
to drawing file)
» 2) Run your case
» 3) Call plotting program
Intro to ATP and ATPDraw 21 Spring 2012

U ECE 524

I Running an ATP File Lecture 3

• The drawing file saved separately (save often)

• Remember to save your changes often
• Default is to save this in the “Project”
subdirectory under ATPDraw
• Note that if want to save elsewhere, need to
select a new home for both ADP and ATP files
» PL4 and *.lis (or *.out depending on version) are
written to same directory at *.ATP file
» Need to cleanup directories periodically
Intro to ATP and ATPDraw 22 Spring 2012
U ECE 524

I Making You Own File Lecture 3

• Open a new drawing (from File

menu or from icon)
• Can get the component menu by
right clicking mouse in the
drawing screen
• Each item lets you select
components to create
• More later….
Intro to ATP and ATPDraw 23 Spring 2012

U ECE 524

I Associated Files Lecture 3

• Input Datafile (text file)

» Extension options: *.dat or *.atp (ATPDraw)
» Avoid Long File Names
• Plot Datafile (formatted ASCII)
» Extension *.PL4
• Text Output File (plain text)
» Extension: *.LIS (or *.OUT)
» Error Messages in this file

Intro to ATP and ATPDraw 24 Spring 2012

U ECE 524

I Associated Files (cont) Lecture 3

• ATPDraw Schematic File

» Extension: *.acp (or *.adp for older versions)
• Supplement Include File
» Use modular programs
» Examples: Line constants output, subsystems
» Extension options: *.pch, *.pun, *.lib

Intro to ATP and ATPDraw 25 Spring 2012

U Creating a File: Text ECE 524

I Based Lecture 3

• Use fixed width fonts with your text editor

» If use MS-Word or Word-Pad make sure use Courier
• Plain text editor better option
» Best if it provides column number
• Older ATP versions do not perform type
checking, use all upper case for variables
• Column alignment is very important
• The ATP rule book refers to individual lines as
data cards
Intro to ATP and ATPDraw 26 Spring 2012
U ECE 524

I Sample File Lecture 3

C Brian K. Johnson
C Simulation for problem 3.11 in Greenwood
BEGIN NEW DATA CASE
C ........................... Miscellaneous data ..............................
C DeltaT<---TMax<---XOpt<---COpt<-Epsiln<-TolMat<-TStart
5.0E-5 0.1
C --IOut<--IPlot<-IDoubl<-KSSOut<-MaxOut<---IPun<-MemSav<---ICat<-NEnerg<-IPrSup
500 1 1
C
C ........................... Circuit data ...................................
C Bus1->Bus2->Bus3->Bus4-><----R<----L<----C
VS V1 0.149 4.73
BLANK ends circuit data
C
C ........................... Switch data ....................................
C ***** Close at 160 degrees, or 70 degrees past peak ********
C Bus-->Bus--><---Tclose<----Topen<-------Ie O
V1 0.02407 999. 1
BLANK ends switch data
C

Intro to ATP and ATPDraw 27 Spring 2012

U ECE 524

I Sample File (cont.) Lecture 3

C ...........................Source data ......................................

C Bus--><I<Amplitude<Frequency<--T0|Phi0<---0=Phi0 <----Tstart<----Tstop
14VS 28.16913E3 60. -90. 0. -1. 9999.
BLANK ends source data
C
C ........................... Output Request Data ............................
C Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->Bus-->
V1 VS
BLANK ends output requests
BLANK ends plot request
BEGIN NEW DATA CASE
BLANK ends all cases

Intro to ATP and ATPDraw 28 Spring 2012

U ECE 524

I Sections of the Datafile Lecture 3

• An ATP datafile must at a minimum have the

following sections
» Header/Miscellaneous Data Cards
» Circuit Data
» Switch Data
» Source Data
» Output request data
» Plot request data

Intro to ATP and ATPDraw 29 Spring 2012

U ECE 524

I Sections of the Datafile Lecture 3

• End of section marked with “BLANK” starting in

column 1
» Rest of the card is comment
» An accidental blank line in data file is treated as end
of section – fix in startup file discussed earlier
• Graphical interfaces such as ATPDraw insulate
user from needing to work at this level
• Still useful to know what is going on at this level
» For Debugging
» If someone sends you an older file
Intro to ATP and ATPDraw 30 Spring 2012
U ECE 524

I Comment Cards Lecture 3

• Good practice to have comments in the file

• Comments start with a “C” in column 1 and a blank in
column 2
C *****************************
C * This is a sample comment *
C *****************************

• ATP allows “in-line” comments. Place comment

between “{ and }’”
• Make sure that you don't block useful data fields

Intro to ATP and ATPDraw 31 Spring 2012

U ECE 524

I Comment Cards (cont.) Lecture 3

• User can also treat a block of code between keywords

$DISABLE and $ENABLE
$DISABLE
all lines in between keywords are ignored
$ENABLE

Intro to ATP and ATPDraw 32 Spring 2012

U ECE 524

I Making You Own File Lecture 3

• Set deltaT and Tmax!!!

• Open a new drawing (from File
menu or from icon)
• Can get the component menu by
right clicking mouse in the
drawing screen
• Each item lets you select
components to create
Intro to ATP and ATPDraw 33 Spring 2012

U ECE 524

I Linear Branches Lecture 3

• These are the basic circuit

elements
• Single phase and three phase
options
• C:U(0) and L:I(0) are capacitor
and inductor with voltage/current
initial conditions
• Note ATPDraw uses U for voltage
Intro to ATP and ATPDraw 34 Spring 2012
U ECE 524

I Operating on component Lecture 3

• Once you select a component you can rotate

it by single clicking the right mouse button on
it.
» Use to structure your drawing more nicely
» This also selects polarity for branch outputs
• Double-click left button to open a window to
edit values

Intro to ATP and ATPDraw 35 Spring 2012

U ECE 524

I Resistor Dialog Box Lecture 3

• Set value for resistance

in Ohms
• Node names not set
• Can add comment
• $Vintage,1 sets high
precision numbers
• Edit definitions: allows
redefine model-
advanced feature

Intro to ATP and ATPDraw 36 Spring 2012

U ECE 524

I Resistor Dialog Box Lecture 3

• Set branch output:

• Comments
» For file
» For drawing

Intro to ATP and ATPDraw 37 Spring 2012

U ECE 524

I Inductor Lecture 3

• L is in mH unless you
have set Xopt to a
frequency
• Label creates a label on
the drawing next to the
component
• Help menus are pretty
good
• Kp numerical oscillation
damping constant
» Adds parallel resistor
» More on that later
Intro to ATP and ATPDraw 38 Spring 2012
U ECE 524

I Capacitor Lecture 3

• Capacitance is in
microFarads unless
Copt set
• Note program sets a
default value to prevent
errors if you randomly
connect nodes
• Ks numerical oscillation
damping constant
» Adds series resistor
» More on that later

Intro to ATP and ATPDraw 39 Spring 2012

U ECE 524

I RLC Lecture 3

• RLC lets you set

R, L, and C or
any combination
• Creates same
data card as R,
L, or C alone, but
lets you do all
fields
• Series RLC
Intro to ATP and ATPDraw 40 Spring 2012
U ECE 524

I 3 Phase RLC Lecture 3

• Can choose a
series 3 phase
RLC
• Options include
Y connected
• and Delta
connected

Intro to ATP and ATPDraw 41 Spring 2012

U Capacitor with Initial ECE 524

I Voltage Value Lecture 3

• Still set value

for C
• Also set positive
and negative
voltage relative
to ground at
T=0
• Will be useful
for homework
#1

Intro to ATP and ATPDraw 42 Spring 2012

U Inductor with Initial ECE 524

I Current Value Lecture 3

• Still set value

for L
• Plus the
current at T=0

Intro to ATP and ATPDraw 43 Spring 2012

U ECE 524

I Switch Pop Up Menu Lecture 3

• In most cases you will use a time

controlled switch (single or three
phase)
• Measuring Switches (always
closed)
• TACS controlled switches

Intro to ATP and ATPDraw 44 Spring 2012

U ECE 524

I Time Controlled Switch Lecture 3

• Set T_close I

• Set T_open
» T_open must be
larger than T_close
• Imar is absolute
value of current it
will interrupt
• Can select outputs

Intro to ATP and ATPDraw 45 Spring 2012

U ECE 524

I Time Controlled Switch Lecture 3

• Can also set a

time sequence for
repeated
open/close
operations.
• Up to 16

Intro to ATP and ATPDraw 46 Spring 2012

U ECE 524

I Three Phase Switch Lecture 3

• Individual
timing for
each phase
• No reclose
characteristic

Intro to ATP and ATPDraw 47 Spring 2012

U ECE 524

I Measuring Switch Lecture 3

• No fields to
set, but you
must select
“Current”
output M

Intro to ATP and ATPDraw 48 Spring 2012

U ECE 524

I Source Pop Up Menu Lecture 3

• Allows you to create ATPDraw 5.5- ATPDraw 5.6+

ordinary sources
• Machines and TACS
controlled sources on
other pop-up menus
• Most of these sources
are referenced to
ground

Intro to ATP and ATPDraw 49 Spring 2012

U ECE 524

I Type 11 Source Lecture 3

Intro to ATP and ATPDraw 50 Spring 2012

U Version 5.6+ AC source ECE 524

I (1&3 phase)
Lecture 3

1 ph voltage 3 ph current
source source

Intro to ATP and ATPDraw 51 Spring 2012

U Single Phase AC Source ECE 524

I (ATPDraw 5.5 or earlier)

Lecture 3

Intro to ATP and ATPDraw 52 Spring 2012

U Three Phase AC Source ECE 524

I (ATPDraw 5.5 or earlier)

Lecture 3

Intro to ATP and ATPDraw 53 Spring 2012

U ECE 524

I AC or DC Floating Source
Lecture 3

• AC source implemented
using the Ideal
Transformer Component
• Frequency default is
50Hz unless you change
default power frequency
in settings menu
• Better to use a Norton
equivalent to create
ungrounded (as dc does)
+

Intro to ATP and ATPDraw 54 Spring 2012

U ECE 524

I Creating a Circuit Lecture 3

• Components are
highlighted in red until you
edit values
• Can connect components
together by dragging left
mouse button between
nodes and then clicking on
finishing node
• 1 Ph or 3 Ph on context
Intro to ATP and ATPDraw 55 Spring 2012

U ECE 524

I Selecting Node Names Lecture 3

• Double click left button to

get node data window
• Type node name in SWT
» 6 characters max
» ALL CAPS or numbers or
will have errors
• Can ground the node
» Name won’t matter
» Ground symbol will appear
Intro to ATP and ATPDraw 56 Spring 2012
U ECE 524

I Selecting Node Names Lecture 3

• Can choose to Display name on the screen

• If you have a connection between nodes, all
nodes will get a name you assigned when
use “Sub-process > Make Node Names” or
“Make ATP File”
» ATPDraw assigns names if you don’t (XX0001,
etc)

Intro to ATP and ATPDraw 57 Spring 2012

U ECE 524

I Building a System Lecture 3

• Can also
copy your
components
• Remembers
output
requests
and values
• Need to
enter new
names

Intro to ATP and ATPDraw 58 Spring 2012

U ECE 524

I Probes and 3 Phase Lecture 3

• Menu for voltage and

current measurements
• “Probe Volt” is line to
ground voltage
• “Probe Branch Volt
“puts in dummy branch
as does “probe curr”
• Select 1 or 3 ph

Intro to ATP and ATPDraw 59 Spring 2012

U ECE 524

I ATPDraw ATP Data File Lecture 3

• File itself is less readable:

BEGIN NEW DATA CASE
C --------------------------------------------------------
C Generated by ATPDRAW January, Wednesday 23, 2008
C A Bonneville Power Administration program
C by H. K. Høidalen at SEfAS/NTNU - NORWAY 1994-2006
C --------------------------------------------------------
C dT >< Tmax >< Xopt >< Copt >
5.E-5 .1
500 1 1 1 1 0 0 1 0
C 1 2 3 4 5 6 7 8
C 345678901234567890123456789012345678901234567890123456789012345678901234567890
/BRANCH
C < n1 >< n2 ><ref1><ref2>< R >< L >< C >
C < n1 >< n2 ><ref1><ref2>< R >< A >< B ><Leng><><>0
VS RL .149 0
RL LV 4.73 0

Intro to ATP and ATPDraw 60 Spring 2012

U ECE 524

I ATPDraw ATP Data File Lecture 3

/SWITCH
C < n 1>< n 2>< Tclose ><Top/Tde >< Ie ><Vf/CLOP >< type >
LV .02407 1.E3 1
/SOURCE
C < n 1><>< Ampl. >< Freq. ><Phase/T0>< A1 >< T1 >< TSTART >< TSTOP >
14VS 0 28169. 60. -90. -1. 1.E3
/OUTPUT
VS
BLANK BRANCH
BLANK SWITCH
BLANK SOURCE
BLANK OUTPUT
BLANK PLOT
BEGIN NEW DATA CASE
BLANK

Intro to ATP and ATPDraw 61 Spring 2012

U When handing in ECE 524

I homework assignments
Lecture 3

• Include any hand calculations you did to set up

the problem
• Include circuit diagram
• Include text from the *.atp file
• Include simulation plots
» Zoom in on key results
» Capture key numbers
» Interpretation of the results matters!
• See examples in upcoming lectures
Intro to ATP and ATPDraw 62 Spring 2012