Short Guide How-to-run-ATP 2023
Short Guide How-to-run-ATP 2023
For the following illustrations it is assumed that the ATP-EMTP programs, various versions
based on different Fortran compilers, compiled as EEUGSETUP.EXE for EEUG members in 2023
are installed on your PC without any change.
This annual distribution includes the universal line model (ULM) for transients
implemented as a DLL (according to Zanon, Leal, De Conti "Implementation of the
universal line model in the alternative transient program", EPSR, 2021. The model is
implemented as a TYPE94 foreign model in ATP. It is supported by ATPDraw v7.5
directly without any other external program dependencies. Steady-state initialization
is not included in this version ULM 3.2.
Previously several other versions were also distributed., but these are for now skipped to be
able to include the ULM model with increased speed and robustness.
Difference between default and Giga version of ATP is the table sizes, i.e. maximum program
dimensions for the components of the Giga version are much larger than the default version.
ATP does not own a GUI under Windows. Therefore it is executed in a DOS window, either
using command line parameters or by a simple dialog using keyboard. Command line parameters
are described in the Readme files of the corresponding ATP program version. The most
convenient way to work with ATP is to use ATPDraw, graphical pre-processor and execute ATP
within ATPDraw. Current version 7.5 of ATPDraw enables easy execution of ATP without DOS
batch file (.BAT).
ATPDraw is a graphical preprocessor for ATP, i.e. user can draw his/her circuit using built-in
objects and create finally an ATP input data file (*.atp) via ATP < run ATP or by pressing F2.
Before executing ATP, the command to run ATP should be better checked as shown in the
screen capture below. The installation routine EEUGSETUP.EXE automatically register ATP
program and plotting program PlotXY into the ATPDraw Options < Preferences (Fig. 1).
ATPDraw starting from version 6.1 has a new feature called ATP Setup Wizard that is accessible
via ATP < Setup ATP connection F10 (see Fig. 2) and also via Tool Bar. ATP Setup Wizard
window is shown on the next page. It is recommended to use ATP Setup Wizard to connect the
desired ATP version to ATPDraw.
Alternatively, RUNTP.BAT created by the SETUP program in the ATPdirectory can be used. As
default the Giga version with maximum table sizes for memory allocation is connected to
ATPDraw to execute ATP.
ATP input data files (*.atp or *.dat) and output file (*.lis) can be viewed/edited using internal
text editor of ATPDraw or an external editor like free source code editor Notepad++
(https://notepad-plus-plus.org). The Notepad++ is included in the installation routine
EEUGSetup.exe for members. To view plots, plotting program PlotXY.exe is registered in
ATPDraw.ini ( Tools < Preferences < Programs window of ATPDraw; see Fig. 1).
After a simulation has been performed using “Compile + run current file (F2)” command on the
toolbar, the created plot file (*.pl4) can be viewed using “Execute Plot Command (F8)”
command of the toolbar. Please check first under ATP Settings, Output, if the option “Plotted
output” is activated in ATPDraw as shown in Fig. 4.
8 L4FULL NOQUOT JJEATS NUMBUS NOTAB NOPISA MSCSV MAXL31 LIM132 MAXMVC
0 0 0 -1 0 0 0 400 0 80
If ATP Analzer is preferred to display/plot the output variables, then in STARTUP NEWPL4=0
and NOPISA=1 should be set. Please note that ATP Analyzer is relatively old program
Another graphical plotting program is GTTPLOT developed and constantly updated by Orlando
Hevia. GTPPLOT will be available as command in ATPDraw via ATP < run GTPPLOT after the
installation. GTTPLOT is driven by entering commands via keyboard.
For the ATPDraw use, please refer to the Help function, the up-to-date ATPDraw manual for
version 7.5 (ATPDrawManual75.pdf) and Readme file (Readme.pdf) for further information.
ATPDraw allows starting with version 7.1 embedded plotting of simulation results. This feature
can be accessed via Add Objects < Draw Plot.
The diagram on the next page shows the steps from generation of a simulation case using
ATPDraw up to viewing simulation results using several plotting programs.
Important note:
Avoid strictly blank “8” character in directory and file names during the installation of
ATP, ATPDraw and later in your working directory and file names.
Although ATPDraw starting with version 6.1 can handle ATP file names with blank
characters (not directory names!) it is not recommended to use blank characters in
ATPDraw project files and consequently in ATP data files.