Getting Started with

OneLiner & Power Flow V11

ii • SECTION 1 GETTING STARTED Getting Started with 1L & PF V11
Contents
SECTION 1 GETTING STARTED 1
1.1 INTRODUCTION .......................................................................................................1
1.2 KEY TYPES AND ACCESS METHODS..................................................................2
SINGLE-USER ACCESS: ...................................................................................2
NETWORK ACCESS:.........................................................................................2
1.3 INSTALL THE SOFTWARE .....................................................................................2
INSTALLING A OneLiner-ONLY EXECUTABLE: .........................................3
INSTALLING A OneLiner/Power Flow COMBINED EXECUTABLE: ...........4
INSTALLING A Power Flow-ONLY EXECUTABLE: .....................................5
1.4 WORKSTATION SETUP...........................................................................................6
INSTALLING A OneLiner-ONLY WORKSTATION: ......................................6
INSTALLING A OneLiner/Power Flow WORKSTATION: ..............................8
INSTALLING A Power Flow-ONLY WORKSTATION: ..................................9
PROBLEM ACESSING HELP FILES FROM WORKSTATIONS: ................11

SECTION 2 SINGLE-USER ACCESS 13

2.1 INTRODUCTION .....................................................................................................13
2.2 INSTALLING THE PROGRAM KEY.....................................................................13
2.3 COMMONLY ASKED QUESTIONS ......................................................................13
2.4 BECOME FAMILIAR WITH THE PROGRAM .....................................................14

SECTION 3 NETWORK ACCESS 15

3.1 INTRODUCTION .....................................................................................................15
3.2 INSTALLATION AT THE SECURITY SERVER ..................................................15
3.3 NETHASP.INI...........................................................................................................17
3.4 QUESTIONS AND ANSWERS ...............................................................................18
3.5 BECOME FAMILIAR WITH THE SOFTWARE....................................................19
3.6 LOCAL ACCESS MODE .........................................................................................19

SECTION 4 DATA CONVERSION 21

4.1 USING EXISTING NETWORK DATA...................................................................21
4.2 CREATE THE ASPEN TEXT DATA FILE.............................................................21
4.3 CHECK THE CONVERTED SHORT CIRCUIT DATA.........................................22
4.4 CHECK THE CONVERTED POWER FLOW DATA ............................................22
4.5 CREATE THE ONE-LINE DIAGRAM ...................................................................22

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• i

SECTION 1 GETTING STARTED

1.1 INTRODUCTION
This document is designed to help new users of ASPEN OneLiner™, ASPEN Power Flow™ and ASPEN
Academic Suite™ to install the software and get started using it. Some of the information in this document is
useful also for existing users.
If you are a new user, the instructions in the following sections will help you install the programs on your hard
disk, convert your existing short circuit data to the ASPEN format, and get acquainted with the software.
If you are a new user, you should read:
• The rest of this section to install the software.
• Section 2 and section 4 if you are making a single-user installation.
• Section 3 and section 4 if you are making the key accessible to all the clients on the computer network.
If you are an existing user, you should read:
• The rest of this section, as well as Section 2 or section 3 if you are installing the software on a new computer.
• Section 4 if you are converting foreign network data to the ASPEN format.

Please call or write ASPEN’s tech support if you have any questions or need any help:

Mailing address: ASPEN

34 N. San Mateo Drive
San Mateo, CA 94401 U.S.A.
Telephone: (650)347-3997
Fax: (650)347-0233
eMail in English: [email protected]
eMail in Spanish or Portuguese: [email protected]
Web Site: www.aspeninc.com

ASPEN’s office hours are from 8:00 a.m. to 5:00 p.m. Pacific Time (GMT-8 in the winter, GMT-7 in the summer),
Monday through Friday.

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• 1

1.2 KEY TYPES AND ACCESS METHODS
Version 11 of OneLiner and Power Flow require HASP HL keys, which are shown on the bottom row of the
picture below. The green USB key is for single-user access. The red USB key is for network access.
The keys on the top row, which include parallel-port keys and the long USB key, are absolute. If you have any
of these older keys, please contact ASPEN to exchange them for the new keys.

SINGLE-USER ACCESS:
A key is for “single-user access” if it is physically connected to a PC, and it is accessible by only the person
working on that PC. Section 2 will show you how to setup a key for single-user access.

NETWORK ACCESS:
A key can be setup on a network PC such that anyone on the network can run the program as long as the total
number of simultaneous executions does not exceed the license limit (which is programmed into the key by
ASPEN). Section 3 will show you how to setup a key for network access.

1.3 INSTALL THE SOFTWARE

The following will help you install the OneLiner and Power Flow software onto a hard disk. You need to read
this section if you are installing the software on the computer for the first time. You must have Administrative
Privilege to install the software on Windows NT, 2000, XP or Vista.
Note: If there are more than a few users in your organization and their PCs are connected by a LAN, we suggest
you consider the Workstation Setup method described in section 1.4.
You need to be familiar with the following terminology:
• OneLiner/Power Flow combined executable: Means that you have a license for both OneLiner and Power
Flow, and you have a program key that has authorization for both programs. This is the only option available to
users of the Academic Suite.

2 • SECTION 1 GETTING STARTED Getting Started with 1L & PF V11

• OneLiner-Only executable: Means that you have a license for ASPEN OneLiner, and you have a program key
that has authorization for OneLiner.
• Power Flow-Only executable: Means that you have a license for ASPEN Power Flow, and you have a
program key that has authorization for Power Flow.

INSTALLING A OneLiner-ONLY EXECUTABLE:

1. Insert the OneLiner program CD into a drive.
2. Click on Start then on Run. When the dialog box appears, enter
d:\1LPF\setup in the edit box. (We assume your CD drive is d:)

Press OK.
3. OneLiner/Power Flow Configuration.
The setup program will launch the OneLiner/Power Flow Configuration
Program at the end of the installation process.

If needed, change the Overcurrent Relay Library Directory by click on the

Browse button. This is the directory in which the program will look for the
relay curves.
If needed, change the path names for the distance relay library and the line
table file. Click on the Browse button to the right if you need help in locating
the files.
Select one of the options under the “key type and method of access”
dropdown list box. See section 1.2 for explanation of key access methods.

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• 3

 Make sure the check box labeled “Run OneLiner and Power Flow from a
single executable” is not marked.
Click on “Save Setup”.
4. After the setup program terminates, reboot the PC.

INSTALLING A OneLiner/Power Flow COMBINED EXECUTABLE:

1. Insert the OneLiner program CD into a drive.
2. Click on Start then on Run. When the dialog box appears, enter
d:\1LPF\setup in the edit box. (We assume your CD drive is d:)

Press OK.
3. OneLiner/Power Flow Configuration.
The setup program will launch the OneLiner/Power Flow Configuration
Program at the end of the installation process.

If needed, change the Overcurrent Relay Library Directory by click on the

Browse button. This is the directory in which the program will look for the
relay curves.
If needed, change the path names for the distance relay library and the line
table file. Click on the Browse button to the right if you need help in locating
the files.
Select one of the options under the “key type and method of access”
dropdown list box. See section 1.2 for explanation of key access methods.

4 • SECTION 1 GETTING STARTED Getting Started with 1L & PF V11

 Mark the checkbox labeled “Run OneLiner and Power Flow from a single
executable” near the bottom of the dialog box.
Click on “Save Setup”.
4. After the setup program terminates, reboot the PC.

INSTALLING A Power Flow-ONLY EXECUTABLE:

1. Insert the Power Flow program CD into a drive.
2. Click on Start then on Run. When the dialog box appears, enter d:\
PF\setup in the edit box. (We assume your CD drive is d:)

Press OK.
3. Power Flow Configuration.
The setup program will launch the Power Flow Configuration Program
at the end of the installation process.

Change the path name of the Line Table File, if needed. Click on the Browse
button to the right if you need help in locating the Line Table file.
Click on “Local access” or “Network access” to indicate whether the
program key is setup for single-user or network access. Click on “Save
Setup”.
See sections 1.2 and 1.3 for explanation of key access methods.
Click on “Save Setup”.
4. After the setup program terminates, reboot the PC.

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• 5

1.4 WORKSTATION SETUP
If you are planning to install the software on a large number of PCs connected by a LAN, we strongly
recommend that you:
1. User the procedure of Section 1.3 to install the software once in a public directory on a file server,
and
IMPORTANT: You must make sure that the Overcurrent Relay Library Directory, as well as the Distance
Relay Library file and the Lines Table File are all on a file server that can be access by all the users on the
network.
2. Run the Workstation Setup program at each PC to install the key driver and setup the program
icons, which serve as “shortcuts” to the files you installed in step 1. The detailed procedure is
described below.
The Workstation Setup will greatly simplify the administrative tasks because all the executable files, relay
libraries, scripts, and line table files will be at a single location on a file server.
The Workstation Setup can be used for PCs using both single-user and network key access.

INSTALLING A OneLiner-ONLY WORKSTATION:

We assume you have already installed the OneLiner software in a public directory on a file server. You need to
perform the following setup procedure at each PC to enable users to run the OneLiner program:
1. Insert the OneLiner program CD into a drive.
2. Click on Start then on Run. When the dialog box appears, enter
d:\1LPF\WorkstationSetup in the edit box. (We assume your CD drive
is d:)

Press OK.
The setup program will ask you for the Local Directory.
This is where the setup program will store the installation log and the uninstall
program. (This uninstall program will remove only the local shortcuts and will
not delete the executable files on the file server.)
The setup program will then ask you for the Server Directory.
This is the directory on the file server where you have installed the OneLiner
software.

6 • SECTION 1 GETTING STARTED Getting Started with 1L & PF V11

 Press the Browse button to select the network directory.
3. OneLiner/Power Flow Configuration.
The setup program will launch the OneLiner/Power Flow Configuration
Program at the end of the installation process.

By design, you will not be able to change the Overcurrent Relay Library
Directory, or the path names for the distance relay library and the line table
file.
Select one of the options under the “key type and method of access”
dropdown list box. See section 1.2 for explanation of key access methods.
Make sure the check box labeled “Run OneLiner and Power Flow from a
single executable” is not marked.
Click on “Save Setup”.
4. After the setup program terminates, reboot the PC.

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• 7

INSTALLING A OneLiner/Power Flow WORKSTATION:
We assume you have already installed the OneLiner/Power Flow software in a public directory on a file server.
You need to perform the following setup procedure at each PC to enable users to run the programs:
1. Insert the OneLiner program CD into a drive.
2. Click on Start then on Run. When the dialog box appears, enter d:\1LPF\
WorkstationSetup in the edit box. (We assume your CD drive is d:)

Press OK.
The setup program will ask you for the Local Directory.
This is where the setup program will store the installation log and the uninstall
program. (This uninstall program will remove only the local shortcuts and will
not delete the executable files on the file server.)
The setup program will then ask you for the Server Directory.
This is the directory on the file server where you have installed the
OneLiner/Power Flow software.

Press the Browse button to select the network directory.

8 • SECTION 1 GETTING STARTED Getting Started with 1L & PF V11

 3. OneLiner/Power Flow Configuration.
The setup program will launch the OneLiner/Power Flow Configuration
Program at the end of the installation process.

By design, you will not be able to change the Overcurrent Relay Library
Directory , or the path names for the distance relay library and the line
table file.
Select one of the options under the “key type and method of access”
dropdown list box. See sections 1.2 and 1.3 for explanation of key access
methods.
Mark the checkbox labeled “Run OneLiner and Power Flow from a single
executable” near the bottom of the dialog box.
Click on “Save Setup”.
4. After the setup program terminates, reboot the PC.

INSTALLING A Power Flow-ONLY WORKSTATION:

We assume you have already installed the Power Flow software in a public directory on a file server. You need
to perform the following setup procedure at each PC to enable users to run the Power Flow Program:
1. Insert the Power Flow program CD into a drive.
2. Click on Start then on Run. When the dialog box appears, enter d:\
PF\WorkstationSetup in the edit box. (We assume your CD drive is d:)

Press OK.

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• 9

 The setup program will ask you for the Local Directory.
This is where the setup program will store the installation log and the uninstall
program. (This uninstall program will remove only the local shortcuts and will
not delete the executable files on the file server.)
The setup program will then ask you for the Server Directory.
This is the directory on the file server where you have installed the Power Flow
software.

Press the Browse button to select the network directory.

3. Power Flow Configuration.
The setup program will launch the Power Flow Configuration Program
at the end of the installation process.

By design, you will not be able to change the path name of the Line Table
File.
Click on “Local access” or “Network access” to indicate whether the
program key is setup for single-user or network access. Click on “Save
Setup”.
See sections 1.2 and 1.3 for explanation of key access methods.
4. After the setup program terminates, reboot the PC.

10 • SECTION 1 GETTING STARTED Getting Started with 1L & PF V11

PROBLEM ACESSING HELP FILES FROM WORKSTATIONS:
We ship help files for OneLiner and Power Flow in the form of .chm files, which are designed to be viewed
through Internet browsers. The workstation PC’s security policy may prevent the user from viewing these files,
which are stored on the file server. Typical symptoms are:
1. Nothing happens when a user presses the “Help” button in a dialog box.
2. The user gets a “Navigation to the webpage was canceled” message when he or she tries to open a help file
through the Help menu commands (e.g., Help | OneLiner Help Contents and Help | Power Flow Help
Contents commands).
You (the IT person) can fix this problem as follows:
1. Run 'regedit' from the command line.
2. Locate and then click the following subkey:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HTMLHelp\1.x\ItssRestrictions

Create this registry subkey if does not exist.

3. Right-click on the ItssRestrictions subkey, point to New, and then click
DWORD Value.
4. Type MaxAllowedZone, and then press Enter.
5. Right-click the MaxAllowedZone value, and then click Modify.
6. In the Value data box, type a number from 0 and 4, and then click OK.
The values settings are: 0 = My Computer 1 = Local Intranet Zone 2 = Trusted
sites Zone 3 = Internet Zone 4 = Restricted Sites Zone For most CHM files, the
value of 1 should be enough to allow the viewing of CHM files.
7. Exit 'regedit'.

Getting Started with 1L & PF V11 SECTION 1 GETTING STARTED• 11

SECTION 2 SINGLE-USER ACCESS

2.1 INTRODUCTION
This section 2 will show you how to install the program key for single-user access. Please refer to the instruction
in Section 3 if you wish to make the program key accessible by all the users on your local or wide area network.

2.2 INSTALLING THE PROGRAM KEY

You need to read this section if you are installing the software on the computer for the first time.
1. After installing the software, connect the program key to a USB port of your
computer.
If the “Found New Hardware Wizard” appears, you must (a) click on “Cancel” to
exit the wizard, (b) remove the key, and (c) re-install the program (see Section
1). Make sure you have the necessary administrative to install device drivers
under Windows.

2.3 COMMONLY ASKED QUESTIONS

Q: I have two USB keys, one for OneLiner and one for Power Flow. Can I plug both of them onto the same PC?
A: No, this will not work. If you want to run OneLiner and Power Flow on the same PC, you must exchange
your two keys for a single key with authorization for both OneLiner and Power Flow. When you receive the
new key from ASPEN, you need to run the OneLiner/Power Configuration Program and mark the “Run
OneLiner and Power Flow from a single executable” option.

Q: I just upgraded the operating system from Windows XP to Windows Vista. When I try to start the program, it
complains about “Local Hasp key not found or this program is not on the authorization list.” What’s wrong?
A: Windows does not always carry over the HASP-key driver from one operating system to the next. You can
fix this problem by either (1) reinstalling the program, or (2) manually install the HASP driver. To install the
driver manually, click on Start | Run, enter “c:\Program Files\ASPEN\1LPFv11\haspdinst.exe –i” (without the
quotation marks), and click on OK.

Getting Started with 1L & PF V11 SECTION 2 SINGLE-USER ACCESS• 13

2.4 BECOME FAMILIAR WITH THE PROGRAM
We have prepared three self-guided tutorials to help you get acquainted with the OneLiner and Power Flow
software. Now is a good time to run through these tutorials if you have not already done so. The tutorials are
these:
• The Quick Tutorial for OneLiner in Section 2 of the OneLiner on-line help or the printed ASPEN OneLiner
User's Manual.
• The Quick Tutorial for Breaker Rating Module in Section 2 of the Breaker Rating Application Guide on-line
help or the printed ASPEN Breaker Rating Application Guide.
• The Quick Tutorial for ASPEN Power Flow in Section 2 of the ASPEN Power Flow on-line help or the printed
ASPEN Power Flow User's Manual.
Notes to Users of the Academic Version: Use the file SAMPLE09.OLR, instead of SAMPLE30.OLR, for OneLiner's
Quick Tutorial. You will need to make some obvious deviations from the written instructions to use the 9-bus
example.

14 • SECTION 2 SINGLE-USER ACCESS Getting Started with 1L & PF V11

SECTION 3 NETWORK ACCESS

3.1 INTRODUCTION
This section 3 will show you how to install the ASPEN OneLiner software on a local- or wide-area network in
such a way that any PC on the network can execute the program.
One of the PCs on the network must be designated as the "security server.” The security server can be any file
server or client PC on the LAN. The program key is plugged into a USB port of the security server. We will
refer to the other PCs on the network as "clients".
The d:\NETWORK directory on the program CD contains software for the security server and for the clients.
Once installed, the security server software runs on the security server and handles all communication between
clients and the program key. The communication between the clients and the security server is transparent to the
user.
Network HASP keys are red. Single-user keys are green and cannot be used for network access.
Each network key is pre-programmed with a license limit, or the maximum number of instances of
OneLiner/Power Flow that can be run at any one time. The program will start up normally if the license limit
has not been reached. Otherwise, the program will inform the user that the license limit has been reached and
will not commence execution.

3.2 INSTALLATION AT THE SECURITY SERVER

You must first select a PC to be the security server and install the security server software there. The security
server can be a file server or a client PC on the LAN. The software runs as a background task on the security
server and is transparent to the user. You can run any program on the security server, including ASPEN
OneLiner and Power Flow. The security server software will not interfere with the normal operations of the
computer. The following will show you how to install the security server software on a PC that is running
Windows NT, 2000, XP or Vista.
1. Log-in to the NT station or file server with an “Administrator” privilege.
2. Insert the program CD in a drive. Copy the Win32 Server Setup Program,
d:\NETWORK\LMSETUP.EXE, from the Program CD to a temporary
directory on your hard disk.

Getting Started with 1L & PF V11 SECTION 3 NETWORK ACCESS• 15

 3. Execute the program LMSETUP.EXE. When the Setup Type dialog box
appears, make sure that the second radio button labeled “Service (rhsrvice)”
is selected. Follow the instructions in this setup program and accept all
default options.

4. A message box will inform you that “The NetHASP LM requires the HASP
Device Driver… Click YES to install Device Driver now.” Click on YES.
5. At the end of the installation process, you will see a small red icon in the lower
right corner of your screen. Double-click on this icon, you will see a screen
that looks something like this. (The version of NetHASP Licensing Manager
shipped with V11 is 8.32 or later. Otherwise, the window looks the same.)
Note: The security-server software was not installed properly if you cannot find
this icon.

The text within the window will tell you the security server’s status. Make sure
the protocol you want is labeled “loaded.”
6. Connect a red network HASP Key to a USB port on the security server.
If the “Found New Hardware Wizard” appears, you must (a) click on “Cancel” to
exit the wizard, (b) remove the key, and (c) repeat steps 1 through 5 to install the
License Manager. Make sure you have the necessary administrative to install
device drivers under Windows.

16 • SECTION 3 NETWORK ACCESS Getting Started with 1L & PF V11

 7. Optional. The security server will listen to all three protocols (IPX/SPX,
NETBIOS and TCP/IP) unless you tell it otherwise. In many cases, the security
server works better when you ask it to listen to just the one protocol. You can
change the protocols by using the commands under the Load and Remove
menus of this window.
This service will continue running in the background even after you have log out
of the local session.
For more information on this NT service, please consult the on-line help file, which is typically installed at the
directory C:\Program Files\Aladdin\NetHASP LM\.

3.3 NETHASP.INI
When OneLiner/Power Flow starts up with the key under Network-Access, the program will read a text file
named NETHASP.INI to find out what network protocol it should use to communicate with the security server.
It is very important to note that the OneLiner/Power Flow program will read ONLY the NETHASP.INI file that
is in the same directory as the executable files ONELINE.EXE or ASPENPF.EXE.
The file NETHASP.INI is copied to the program directory when you setup the program. This default ini file
causes the OneLiner/Power Flow program to broadcast a message on the network and listen for the keys’
response each time they need to communicate with each other. This ini file does not require the security server
(the PC with the network key attached) to have a fixed IP address. The content of this file is shown below.
[NH_COMMON]
;; This NetHASP.INI file is configured to TCPIP.
NH_TCPIP = Enabled; ; Use the TCP/IP protocol

[NH_TCPIP]

;; ------------------------------------------------------------------------
;; The default port number and the UDP-packet option work in nearly all
;; cases. Remove the comment characters (2 semicolons in columns 1 and 2)
;; and modify these parameters only if necessary.

;;NH_PORT_NUMBER = <Num> ; Set the TCP/IP port number. This is

; optional. The default number is 475.

;;NH_TCPIP_METHOD = TCP or UDP ; Send a TCP packet or UDP packet

; Default: UDP

;; ------------------------------------------------------------------------
;; Use the next line if the PC with the NetHASP key has no fixed IP address.

NH_USE_BROADCAST = Enabled; ; Use TCPI/IP Broadcast mechanism.

;; ------------------------------------------------------------------------
;; Use the follow if the PC with the NetHASP key has a fixed IP address.
;; Make sure you comment out (with two semicolons in columns 1 and 2)
;; the line above that reads "NH_USE_BROADCAST = Enabled" and remove
;; the two simicolons in columns 1 and 2 in the lines below.

;;NH_SERVER_ADDR = xx.xx.xx.xx; ; IP addresses of all the NetHASP

; License Managers you want to search.
; Unlimited addresses and multiple
; lines are possible.
;
; Possible address format examples:
; IP address: 192.114.176.65
; Local Hostname: ftp.aladdin.co.il
;;NH_USE_BROADCAST = Disabled; ; Do not use TCPI/IP Broadcast mechanism.

Getting Started with 1L & PF V11 SECTION 3 NETWORK ACCESS• 17

If the default version of the ini file does not work and your security server has a fixed IP address, we suggest
you edit the file with a text editor to make the following changes:
1. Comment out (with two semicolons in columns 1 and 2) the line that reads "NH_USE_BROADCAST = Enabled"

2. Remove the two semicolons in columns 1 and 2 on the lines that read “NH_SERVER_ADDR = xx.xx.xx.xx”
and “NH_USE_BROADCAST = Disabled”.
3. Replace the string xx.xx.xx.xx with the actual IP address of the security server, such as 192.114.176.65.
The edited file should look like this:
[NH_COMMON]
;; This NetHASP.INI file is configured to TCPIP.
NH_TCPIP = Enabled; ; Use the TCP/IP protocol

[NH_TCPIP]

;; ------------------------------------------------------------------------
;; The default port number and the UDP-packet option work in nearly all
;; cases. Remove the comment characters (2 semicolons in columns 1 and 2)
;; and modify these parameters only if necessary.

;;NH_PORT_NUMBER = <Num> ; Set the TCP/IP port number. This is

; optional. The default number is 475.

;;NH_TCPIP_METHOD = TCP or UDP ; Send a TCP packet or UDP packet

; Default: UDP

;; ------------------------------------------------------------------------
;; Use the next line if the PC with the NetHASP key has no fixed IP address.

;;NH_USE_BROADCAST = Enabled; ; Use TCPI/IP Broadcast mechanism.

;; ------------------------------------------------------------------------
;; Use the follow if the PC with the NetHASP key has a fixed IP address.
;; Make sure you comment out (with two semicolons in columns 1 and 2)
;; the line above that reads "NH_USE_BROADCAST = Enabled" and remove
;; the two simicolons in columns 1 and 2 in the lines below.

NH_SERVER_ADDR = 192.144.176.65; ; IP addresses of all the NetHASP

; License Managers you want to search.
; Unlimited addresses and multiple
; lines are possible.
;
; Possible address format examples:
; IP address: 192.114.176.65
; Local Hostname: ftp.aladdin.co.il
NH_USE_BROADCAST = Disabled; ; Do not use TCPI/IP Broadcast mechanism.

With this ini file, the security server will communicate directly with the clients using the IP address you
provide.

3.4 QUESTIONS AND ANSWERS

Q: I am using a green HASP key now for single-user access, but I want to change it to network access so that
other people in my organization can run it from their PCs. Do I need to get a different network HASP key from
ASPEN?
A: Yes, but you must have a network-capable HASP key, which is red. Please call or write ASPEN to find out if
your key is network capable and to request a network-key exchange if needed.

18 • SECTION 3 NETWORK ACCESS Getting Started with 1L & PF V11

Q: My company has two HASP keys. Both of them are setup for single-user access. I want to change them to
network access so that up to two people in my organization can run the program simultaneously. Can I setup the
two keys for network access at two different security servers?
A: No, this method will not work. Please contact ASPEN to exchange your two one-user keys for a new key that
has authorization for two users.

Q: I have setup a key for network access. Can I run OneLiner on the security server under single-user access?
A: No. Once a key is setup for network access, all the users must access the key through the network.

3.5 BECOME FAMILIAR WITH THE SOFTWARE

We have prepared a number of self-guided tutorials to help you get acquainted with the OneLiner and Power
Flow software. Now is a good time to run through these tutorials if you have not already done so. The tutorials
are these:
• The Quick Tutorial for OneLiner in Section 2 of the OneLiner on-line help or the printed ASPEN OneLiner
User's Manual.
• The Quick Tutorial for Breaker Rating Module in Section 2 of the Breaker Rating Application Guide on-line
help or the printed ASPEN Breaker Rating Application Guide.
• The Quick Tutorial for ASPEN Power Flow in Section 2 of the ASPEN Power Flow on-line help or the printed
ASPEN Power Flow User's Manual.

3.6 LOCAL ACCESS MODE

The local access mode lets you run the software on a single PC when the network is down or unavailable.
1. Connect the network HASP key to a USB port of your computer.
The network HASP key is red.
2a. For OneLiner users: From the Start | All Programs , click on the ASPEN
OneLiner v11 folder. Within the folder, click on the OneLiner Configuration
menu item.
When the dialog box appears, change the Key Type and Method of Access to
“HASP key; Local access”, as shown below.

Getting Started with 1L & PF V11 SECTION 3 NETWORK ACCESS• 19

 2b. For Power Flow users: From the Start | All Programs , click on the ASPEN
Power Flow v11 folder. Within the folder, click on the Power Flow
Configuration menu item.
When the dialog box appears, change the Key Type and Method of Access to
“Local access”, as shown below.

20 • Getting Started with 1L & PF V11

SECTION 4 DATA CONVERSION

4.1 USING EXISTING NETWORK DATA

OneLiner and Power Flow can help you make use of your existing network data. The procedure is as follows:
1. Using a data conversion program provided by ASPEN, convert your
existing short circuit data to a text data file of the ASPEN format.
2. OneLiner Users Only: Open the text data file with the File | Read Text Data
File command. Execute the Faults | Bus Fault Summary command to check
the accuracy of the converted short-circuit data.
3. Power Flow Users only: Open the text data file with the File | Read Text
Data File command. Execute the PFlow | Power Flow command to solve the
case. Execute PFlow | Solution Browser to check the accuracy of the
converted power-flow data.
4. Using OneLiner or Power Flow, create the one-line diagram for the portion
of the network that you are studying.
The details of these steps are described in the rest of this Section 4.
If you do not have any data files, the best way to proceed is to:
1. Use the New command under the File menu to create a new binary data file.
2. Use the Bus, Line, and other commands under the New menu to create the
new buses, transmission lines, etc.
3. Ignore the rest of this section 4.

4.2 CREATE THE ASPEN TEXT DATA FILE

The OneLiner and Power Flow software comes with a number of frequently used data conversion programs to
help you convert your existing network data into a text file of the ASPEN format. These data conversion
programs include:
• ANAFAS Format – included as ANAFAS.EXE
• ANAREDE Format – included as ANAREDE.EXE
• PTI PSS/E format (Power Technologies, Inc) - included as PTI.EXE

Getting Started with 1L & PF V11 SECTION 4 DATA CONVERSION• 21

• GE format - included as EPC.EXE (for the GE Short Circuit Format) and EPCPF.EXE (for the GE PSLF
format)
• Transmission 2000 format (Commonwealth Associates) - included as T2000.EXE.
Please consult the Data Conversion on-line help under the Help | Data Conversion Help Contents command for
information on their usage and limitations. This on-line help also has advice on how to compare these
program’s results to those from OneLiner.
If you have other data conversion needs, please call ASPEN for information.

4.3 CHECK THE CONVERTED SHORT CIRCUIT DATA

This step is optional, but we strongly recommend that you use the Bus Fault Summary feature of OneLiner to
check the accuracy of the data conversion prior to laying out the one-line diagram, as follows:
1. Start up ASPEN OneLiner
2. Execute the File | Open Text Data File command to open the DXT file
3. Run the Faults | Bus Fault Summary command. Accept all the default options and click on OK. The
program will generate a table showing the fault current and Thevenin impedance for all the buses.
We suggest you compare the fault currents with those of your existing short circuit program. They should match
to within a small tolerance – usually on the order of one percent. If they do not match, call ASPEN and proceed
no further.

4.4 CHECK THE CONVERTED POWER FLOW DATA

It is always a good idea to compare the solution of the Power Flow to that of your existing program before you
start laying out the one-line.
After starting the Power Flow, open the text data file created in Section 4.2 and then use the PFlow | Power
Flow command to solve the program. After the solution converges, we suggest you use the PFlow | Solution
Browser to view the solution in a tabular form.
The power flow solution should be close to that from your existing program. It is important to note that the
solutions may not be exactly the same because (1) power flow problem is nonlinear and therefore the solution
may not be unique, and (2) the order in which the automatic controls are adjusted often have a significant effect
on the solution. If there is a drastic difference in the solutions, please call ASPEN and proceed no further.

4.5 CREATE THE ONE-LINE DIAGRAM

Open the text data file with the File | Open Text Data File command if you have not done so already. The screen
is blank at this stage because the text data file contains no graphical information.
The Diagram | Place Bus command in the program lets you place the buses on the one-line diagram. You need
not place all the buses before simulating short circuits or power flow. However, for short circuit simulations,
you must place, at the minimum, the buses that you wish to fault plus any neighboring buses of interest.

22 • SECTION 4 DATA CONVERSION Getting Started with 1L & PF V11

Refer to the Quick Tutorial (in Section 2 of the ASPEN OneLiner User's Manual or Section 2 of the ASPEN
Power Flow User’s Manual) for an example on how to use the import procedure. The following are some
handy tips.
State your bus-sorting preference. Before you place any buses, execute the Diagram | Options command and
specify whether you want the buses sorted by their number or by their name and nominal kV. This will affect how
the buses are listed in the Diagram | Place dialog box that you will need to use.
Start from the middle of your system. When you execute the File | Open Text Data File command, the
window is at the center of the world coordinate. (The square knobs on the scroll bars show you the relative position
of the window within the world coordinate.) You should place buses that are roughly in the middle of your system
at this location and gradually work outwards. Have a one-line diagram of the system handy for reference, if at all
possible.
Be aware of spacing. You want to place buses close enough together so that you will be able to see the
simulation results for a number of buses. Yet you want to allow enough space between the buses so that the names
and numerical values are clearly separated. See the file SAMPLE30.OLR for an example of spacing.
Locate a bus within the Diagram | Place Bus dialog box. This dialog box will appear when you click the right
mouse button at an empty spot and execute the Place Bus command in the floating menu. You can quickly locate a
bus in the list box by typing the bus name or the bus number – depending on your bus-sorting preference. After you
type the character on the keyboard, the list will show as selected the first bus that starts with that character. You
may need to use the scroll bar to browse the list until the bus you want is visible.
Place neighbors of a bus that is already visible. A bus is displayed with a hollow bus symbol if one or more
of its immediate neighbors have not been placed. You can place these neighbors by (1) clicking the right mouse
button on the hollow bus symbol, and (2) execute the Place Bus command in the floating menu. The program will
automatically show you a dialog box listing all the neighbors that have not been placed. Click on OK.
Save the file every 10 or 20 minutes. A session starts when you open a file, and it ends when you close the
file or exit the program. Within a session, you should use the File | Save command frequently to save the latest
result to disk. This helps to safeguard your work in case of a program or system crash. For even greater security,
save successive files under different names. This way you will have an archive of your work at different stages.
Move a group of buses. You can use the mouse to lasso a number of buses and connected equipment and
move them with the mouse. You may have to do this every now and then to tidy up the one-line diagram.

Getting Started with 1L & PF V11 SECTION 4 DATA CONVERSION• 23