U I

Installing ATP:
Mingw version of ATP ATPDraw -- latest version or latest patch
Presently Atpdraw56.zip

ECE 524 Lecture 3

Minimum to Download

Installation is less straightforward. Option: ATP Easy Installer

Download from secure sites in Japan
Intro to ATP and ATPDraw
1

PlotXY

Spring 2010

U I

Installing ATPDraw

ECE 524 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 2010

U I

Running ATP from ATPDraw

ECE 524 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 2010

U I

Sample Batch File

ECE 524 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

Spring 2010

U I Sample Batch File (cont.)

ECE 524 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 2010

U I Sample Batch File (cont.)

ECE 524 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

Spring 2010

U I

Editing startup
Resides in same directory as tpbig Sets variables for the program

ECE 524 Lecture 3

ATP reads a file called startup A few suggested changes from default
Change PL4 file format to work with PlotXY Ignore blank lines

Intro to ATP and ATPDraw

Spring 2010

U I

Editing startup
Resides in same directory as tpbig Sets variables for the program

ECE 524 Lecture 3

ATP reads a file called startup A few suggested changes from default
Change PL4 file format to work with PlotXY
NOBLAN set to 0 NEWPL4 set to 1

Intro to ATP and ATPDraw

Spring 2010

U I

Setting Up ATPDraw

ECE 524 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 wont cover in this course

Intro to ATP and ATPDraw
9

Spring 2010

U I

ATPDraw Preferences

ECE 524 Lecture 3

Intro to ATP and ATPDraw

10

Spring 2010

U I

Further Settings
Problems with lost help files though

ECE 524 Lecture 3

The Directories 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
11

Spring 2010

U I

Simulation Settings

ECE 524 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

12

Spring 2010

U I

Output Settings

ECE 524 Lecture 3

Probably dont 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

13

Spring 2010

U I

Other Settings

ECE 524 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
14

Spring 2010

U I

Saving New Settings

ECE 524 Lecture 3

The Save or Apply buttons arent

sufficient to permanently save change Also choose: Tools --> Save Options These are all saved into a file called ATPDraw.ini
Typically saved in users settings Could put copy in the directory with ATPDraw.exe
Intro to ATP and ATPDraw
15

Spring 2010

U I

Other Settings

ECE 524 Lecture 3

To set plotting program and other 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

16

Spring 2010

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

Example 1

ECE 524 Lecture 3

Intro to ATP and ATPDraw

17

Spring 2010

U I

ATP Menu

ECE 524 Lecture 3

A new pulldown
menu is now available at the top of the window, called ATP

Intro to ATP and ATPDraw

18

Spring 2010

U I

ATP Menu

ECE 524 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
19

Spring 2010

U I

Edit Commands

ECE 524 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
20

Spring 2010

U I

Saving New Settings

ECE 524 Lecture 3

The Update buttons isnt sufficient to

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

Intro to ATP and ATPDraw

21

Spring 2010

U I

Running an ATP File

ECE 524 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
22

Spring 2010

U I

Running an ATP File

ECE 524 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
23

Spring 2010

U I

Making You Own File

ECE 524 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
24

Spring 2010

U I

Associated Files

ECE 524 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: *.OUT or *.LIS Error Messages in this file
Intro to ATP and ATPDraw
25

Spring 2010

U I

Associated Files (cont)

ECE 524 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

26

Spring 2010

U I

Creating a File: Text Based

ECE 524 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
27

Intro to ATP and ATPDraw

Spring 2010

U I

Sample File

ECE 524 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

28

Spring 2010

U I

Sample File (cont.)

ECE 524 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

29

Spring 2010

U I Sections of the Datafile

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

ECE 524 Lecture 3

Intro to ATP and ATPDraw

30

Spring 2010

U I Sections of the Datafile

column 1

ECE 524 Lecture 3

End of section marked with BLANK starting in

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
31

Spring 2010

U I
column 2

Comment Cards

ECE 524 Lecture 3

Good practice to have comments in the file Comments start with a C in column 1 and a blank in
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

32

Spring 2010

U I Comment Cards (cont.)

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

ECE 524 Lecture 3

User can also treat a block of code between keywords

Intro to ATP and ATPDraw

33

Spring 2010

U I

Making You Own File

ECE 524 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
34

Spring 2010

U I

Linear Branches

ECE 524 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
35

Spring 2010

U I Operating on component

ECE 524 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

36

Spring 2010

U I

Resistor Dialog Box

ECE 524 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

37

Spring 2010

U I

Resistor Dialog Box

ECE 524 Lecture 3

Set branch output: Comments

For file For drawing

Intro to ATP and ATPDraw

38

Spring 2010

U I

Inductor

ECE 524 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
39

Spring 2010

U I
Capacitance is in

Capacitor

ECE 524 Lecture 3

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

40

Spring 2010

U I

RLC

ECE 524 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
41

Spring 2010

U I

3 Phase RLC

ECE 524 Lecture 3

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

Intro to ATP and ATPDraw

42

Spring 2010

U I

Capacitor with Initial Voltage Value

ECE 524 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

43

Spring 2010

U I
T=0

Inductor with Initial Current Value

ECE 524 Lecture 3

Still set value for L Plus the current at

Intro to ATP and ATPDraw

44

Spring 2010

U I

Switch Pop Up Menu

ECE 524 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

45

Spring 2010

U I Time Controlled Switch

Set T_close Set T_open
T_open must be larger than T_close

ECE 524 Lecture 3

Imar is absolute
value of current it will interrupt Can select outputs
Intro to ATP and ATPDraw
46

Spring 2010

U I

Three Phase Switch

ECE 524 Lecture 3

Intro to ATP and ATPDraw

47

Spring 2010

U I

Measuring Switch

ECE 524 Lecture 3

No fields to set, but

you must select Current output

Intro to ATP and ATPDraw

48

Spring 2010

U I

Source Pop Up Menu

ECE 524 Lecture 3

Allows you to create

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 2010

U I

Type 11 Source

ECE 524 Lecture 3

Intro to ATP and ATPDraw

50

Spring 2010

U I Single Phase AC Source

ECE 524 Lecture 3

Intro to ATP and ATPDraw

51

Spring 2010

U I Three Phase AC Source

ECE 524 Lecture 3

Intro to ATP and ATPDraw

52

Spring 2010

U I

Version 5.6 AC source

ECE 524 Lecture 3

Intro to ATP and ATPDraw

53

Spring 2010

U I

AC or DC Floating Source

ECE 524 Lecture 3

Created 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

Intro to ATP and ATPDraw

54

Spring 2010

U I

Creating a Circuit

ECE 524 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 2010

U I

Selecting Node Names

ECE 524 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 wont matter Ground symbol will appear
Intro to ATP and ATPDraw
56

Spring 2010

U I

Selecting Node Names

ECE 524 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 Make Names or Make File
ATPDraw assigns names if you dont

Intro to ATP and ATPDraw

57

Spring 2010

U I

Building a System

ECE 524 Lecture 3

Most recent
component displayed in a palette on screen for easier reuse Can also copy your components
58

Intro to ATP and ATPDraw

Spring 2010

U I

Probes and 3 Phase

ECE 524 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 2010

U I ATPDraw ATP Data File

File itself is less readable:

ECE 524 Lecture 3

BEGIN NEW DATA CASE C -------------------------------------------------------C Generated by ATPDRAW January, Wednesday 23, 2008 C A Bonneville Power Administration program C by H. K. Hidalen 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 2010

U I ATPDraw ATP Data File

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

ECE 524 Lecture 3

1 >< TSTART >< TSTOP > -1. 1.E3

Intro to ATP and ATPDraw

61

Spring 2010

U I

When handing in homework assignments

ECE 524 Lecture 3

Include any hand calculations you did to set up

the problem Include circuit diagram Include *.atp file Include simulation plots

See examples in upcoming lectures

Intro to ATP and ATPDraw
62

Zoom in on key results Capture key numbers Interpretation of the results matters!

Spring 2010