Measurement WBK11A User Manual
*
WavePort/312P
User’s Manual
Power Measurement, Display, Storage, & Analysis Instrument
with EasyPower
Measure
Software
IOtech, Inc.
25971 Cannon Road
Cleveland, OH 44146-1833
Phone: (440) 439-4091
Fax: (440) 439-4093
E-mail: sales@iotech.com
Internet: http://www.iotech.com
WavePort/312P
User’s Manual
1006-0901 Rev 1.0
p/n
Original release 8/98 per EO# 2081R3
*WavePort/312P was formerly known as PowerVista/312. PowerVista® is a registered trademark of PowerVista
Software. With exception of this cover page, the WavePort/312P product name has not yet been incorporated into this
document.
© 1998 by IOtech, Inc.
December 1999
Printed in the United States of America
Warranty
PowerVista/312’s warranty is as stated on the enclosed warranty card. No other warranty is expressed or
implied. The warranty is void if the product is operated in excess of specified limits for electrical and
environmental conditions or if handled carelessly or in disregard of standard Electro-Static Discharge
precautions. We do not guarantee product suitability for all applications.
Limitation of Liability
IOtech, Inc. cannot be held liable for any damages resulting from the use or misuse of this product.
Copyright, Trademark, and Licensing Notice
All IOtech documentation, software, and hardware are copyright with all rights reserved. No part of this product
may be copied, reproduced or transmitted by any mechanical, photographic, electronic, or other method without
IOtech’s prior written consent. IOtech product names are trademarked; other product names, as applicable, are
trademarks of their respective holders. All supplied IOtech software (including miscellaneous support files,
drivers, and sample programs) may only be used on one installation. You may make archival backup copies.
FCC Statement
IOtech devices emit radio frequency energy in levels compliant with Federal Communications Commission
rules (Part 15) for Class A devices. If necessary, refer to the FCC booklet How To Identify and Resolve
Radio-TV Interference Problems (stock # 004-000-00345-4) which is available from the U.S. Government
Printing Office, Washington, D.C. 20402.
CE Notice
Many IOtech products carry the CE marker indicating they comply with the safety and emissions standards of
the European Community. As applicable, we ship these products with a Declaration of Conformity stating
which specifications and operating conditions apply.
Warnings and Cautions
Refer all service to qualified personnel. This caution symbol warns of possible personal injury or equipment
damage under noted conditions. Follow all safety standards of professional practice and the recommendations
in this manual. Using this equipment in ways other than described in this manual can present serious safety
hazards or cause equipment damage.
This warning symbol is used in this manual or on the equipment to warn of possible injury or death from
electrical shock under noted conditions.
This ESD caution symbol urges proper handling of equipment or components sensitive to damage from
electrostatic discharge. Proper handling guidelines include the use of grounded anti-static mats and wrist
straps, ESD-protective bags and cartons, and related procedures.
Specifications and Calibration
Specifications are subject to change without notice. Significant changes will be addressed in an addendum or
revision to the manual. As applicable, IOtech calibrates its hardware to published specifications. Periodic
hardware calibration is not covered under the warranty and must be performed by qualified personnel as
specified in this manual. Improper calibration procedures may void the warranty.
Quality Notice
IOtech has maintained ISO 9001 certification since 1996. Prior to shipment, we thoroughly test our products
and review our documentation to assure the highest quality in all aspects. In a spirit of continuous
improvement, IOtech welcomes your suggestions.
PowerVista/312 User’s Manual
i
Table of Contents
1 Introduction and Hardware Setup
1.1 What is PowerVista/312 ……1-1
1.1.1 What Makes Up the Hardware ……1-1
1.1.2 What Is EasyPower Measure ……1-2
1.2 Understanding the Hardware ……1-2
1.1.3 Frequently Asked Questions ……1-4
1.1.4 Mounting the Laptop ……1-5
1.1.5 Connecting the PC ……1-6
2 Install Software & Change PC Settings
2.1 Introduction to EasyPower Measure
Viewer ……2-1
2.2 Install EasyPower Measure ……2-1
2.3 Disable Power Management ……2-1
2.4 Disable CD ROM Auto Insert
Notification ……2-2
2.5 Disable Win95 Screen Savers and
Energy Management Functions ……2-2
2.6 Disable Virtual Memory Management [if
necessary] ……2-3
2.7 Disable Additional Process Time
Stealers [if necessary] ……2-4
3.7.5 Cycle Harmonics Backward …… 3-8
3.7.6 Take Snapshot …… 3-8
3.8 Window Management …… 3-9
3.8.1 Determining Focus …… 3-9
3.8.2 Cascade …… 3-10
3.8.3 Tile Horizontal …… 3-10
3.8.4 Tile Vertical …… 3-10
3.8.5 Arrange Icons …… 3-11
3.8.6 Autosize Result Windows …… 3-11
3.9 Toolbar and Status Bar Visibility 3-11
3.9.1 Main Toolbar …… 3-12
3.9.2 Phasing Toolbar …… 3-12
3.9.3 Status Bar …… 3-13
3.10 Database View …… 3-14
3.10.1 Database Viewing and Selection
……3-14
3.10.2 Column Descriptions …… 3-15
3.10.3 Shot Configuration Loading - “Critical
Configuration” …… 3-15
3.10.4 Printing - Copying Shot List …… 3-15
3.11 Graphical Result Window Features
…… 3-16
3.12 Input Level Meter…… 3-17
3.13 Help …… 3-18
4 Device Configuration
3 Software Framework
3.1 Overview …… 3-1
3.2 File Access …… 3-2
3.2.1 File New …… 3-2
3.2.2 File Open …… 3-2
3.2.3 File Save As …… 3-2
3.2.4 File Close …… 3-3
3.2.5 File Clear …… 3-3
3.2.6 Write ASCII …… 3-3
3.2.7 File Exit …… 3-3
3.3 User Configuration …… 3-3
3.3.1 Load User Config …… 3-4
3.3.2 Save User Config …… 3-4
3.3.3 Update Default Config …… 3-4
3.4 Printing …… 3-4
3.4.1 Print …… 3-5
3.4.2 Print Preview …… 3-5
3.4.3 Print Setup …… 3-5
3.5 Copy - Paste Shots …… 3-5
3.5.1 Copy Shots …… 3-5
3.5.2 Paste Shots …… 3-6
3.5.3 Change Shot Titles …… 3-6
3.6 Copy to Clipboard …… 3-6
3.6.1 Copy Graphics or Text …… 3-6
3.6.2 Copy Delimited Data …… 3-6
3.7 Tools …… 3-7
3.7.1 Engineering vs. Percent Toggle … 3-7
3.7.2 Cycle Graph Forward …… 3-7
3.7.3 Cycle Graph Backward …… 3-8
3.7.4 Cycle Harmonics Forward …… 3-8
4.1 Signal Connections ……4-1
4.1.1 Differential Inputs ……4-2
4.1.2 Connection Procedure ……4-3
4.1.3 Three Phase Grounded Wye ……4-4
4.1.4 Three Phase UnGrounded Wye ……4-5
4.1.5 Three Phase Delta ……4-6
4.1.6 Three Phase Open Delta System …4-7
4.1.7 Single Phase ……4-7
4.1.8 120/240V Service ……4-8
4.2 System Configuration ……4-8
4.3 Site Information ……4-10
4.4 Preferences ……4-11
4.5 Communication ……4-12
4.6 Calibration ……4-12
5 Phasor Diagram
5.1 Phasor Diagram Overview ……5-1
5.2 Phasor Diagram Configuration ……5-1
5.3 Phasor Diagram Application ……5-2
5.3.1 Phasing ……5-2
5.3.2 Total vs. Displacement Power Factor
……5-4
5.3.3 Harmonics Tabulation ……5-4
5.3.4 Demand Tabulation ……5-5
ii
PowerVista/312 User’s Manual
6 Detailed Harmonics
6.1 Detailed Harmonics Overview ….. 6-1
6.2 Detailed Harmonics Configuration
……6-1
6.3 Detailed Harmonics Application ….. 6-3
6.3.1 Average Harmonics ….. 6-3
6.3.2 Non-Integer Frequencies ….. 6-3
6.3.3 Maximized Spectra ….. 6-4
6.3.4 IEEE 519 ….. 6-4
6.3.5 Harmonics Tabulation …..6-5
7 Spectrum Analyzer
7.1 Spectrum Analyzer Overview …… 7-1
7.2 Spectrum Analyzer Configuration 7-1
7.3 Spectrum Analyzer Application …… 7-2
7.3.1 Hamming Window …… 7-2
7.3.2 The Fast Fourier Transform …… 7-4
8 Cycle-by-Cycle Capture
8.1 Cycle-by-Cycle Overview …… 8-1
8.2 Cycle-by-Cycle Configuration …… 8-1
8.3 Cycle-by-Cycle Application …… 8-2
8.3.1 Scrolling Data and Auto Snap to
Database …… 8-2
8.3.2 Power Grid Dynamic Response …… 8-3
8.3.3 Static Var Compensator Response ……
…… 8-3
8.3.4 Flicker …… 8-4
8.3.5 Exciter, Generator and Governor
Response Tests …… 8-4
9 Event Capture
9.1 Event Capture Overview ….. 9-1
9.2 Event Capture Configuration ….. 9-1
9.3 Event Capture Application ….. 9-4
9.3.1 Trigger Table and Event Extremes …..
…… 9-4
9.3.2 Demand Log and Event Links ….. 9-4
9.3.3 Demand Log Data Recovery ….. 9-6
9.4 Demand Viewing Configuration … 9-6
10 Frequency Following
10.1 Frequency Following Overview
…… 10-1
10.2 Frequency Following Application
…… 10-1
10.2.1 Frequency Following Process Time
…… 10-2
10.2.2 Behavior Without Frequency Following
…… 10-2
10.2.3 Frequency Following Limitations ……
…… 10-2
11 Glossary
PowerVista/312 User’s Manual
iii
iv
PowerVista/312 User’s Manual
1 Introduction and Hardware Setup
1.1 What is PowerVista/312 ?
PowerVista/312 is a power measurement and analysis system that consists primarily of a data acquisition device,
laptop PC, and EasyPower
a user-friendly Windows environment while having immediate access to collected data via an integrated
database. Note that EasyPower Measure is a departure from hardware based measurement systems where
processor speed and data capture features are fixed or have minimal upgrade capability. With the ever
increasing speed and scope of microprocessors, it is a natural step in the evolution of instrumentation to make
this ever increasing resource available to power system measurement engineers and technicians.
Measure software. Users of PowerVista/312 can perform power measurements in
1.1.1 What Makes Up the Hardware ?
PowerVista/312’s rugged case includes a signal connection panel, AC inlet connection, and cooling fan. A
laptop PC is located on a cover plate, while the data acquisition device is located beneath the plate. An
uninterruptable power supply option is available for the acquisition device. Section 1.2, Understanding the
Hardware, provides more detail.
Figure 1-1. PowerVista/312
PowerVista/312 User’s Manual Introduction and Hardware Setup 1-1
1.1.2 What Is EasyPower Measure ?
EasyPower Measure is a single software application that uses C++ object oriented programming to
accomplish the most critical needs of power system measurement. Each measurement feature represents a piece
of specialty hardware, and in most cases exceeds the scope of that hardware. All features are integrated into a
single fast access database so that any measurement can be retrieved with simple click and drag functionality.
1.1 Understanding the Hardware
Figure 1-1 (previous page) shows the basic hardware arrangement of PowerVista/312. Figure 1-2 provides more
information regarding hardware aspects of the PowerVista/312. Main points from the figure are as follows:
The left side of the case supports the signal connection panel. This panel is where voltage and current signal
inputs are made, as well as a safety ground connection. Various types of connections are illustrated and
discussed in Chapter 4.
The cover plate covers the data acquisition device and the uninterruptable power supply option (if part of your
unit). The laptop’s power adapter can also be mounted beneath the cover plate. A slot at the rear of the plate
permits cable passage. The left side of the cover plate contains circulation vents for forced-air cooling.
The communication cable (or optional WBK20 enhanced parallel port PC-card) links the acquisition device to
the PC via parallel (or enhanced parallel) port.
The 110 VAC outlet (on the cover plate) can be used to supply power to Laptop’s power adapter.
The power switch and LED (on the cover plate). The power switch turns power on or off for the UPS option
and the PowerVista/312 acquisition device. The LED lights when the switch is closed and power is available to
the unit. Note that power to the laptop is not related to the switch or LED.
Dual-lock tabs can be used to secure the Laptop and its power adapter to the cover plate. The dual-lock tabs are
similar to Velcro
A thru-hole (located on the case portion of the latch, just right of the case handle) can be used to attach a seal,
small padlock, or tag, or small chain.
110 VAC power-inlet (on the right side of the unit’s case) connects to a 110 VAC supply via a power cord.
Power through this inlet supplies the data acquisition device, optional uninterruptable power supply (UPS), and
unit receptacles, including the cover plate receptacle (for powering the Laptop).
Fan. The right side of the unit contains a fan for forced-air cooling.
Acquisition Device [Not Shown] – The data acquisition portion of the PowerVista/312 is located beneath the
cover plate and consists of a modified WaveBook. Separate documentation is provided for this portion of the
PowerVista/312.
Uninterruptable Power Supply option (UPS) [Not Shown]. This optional power supply (if ordered) is located
beneath the cover plate. The UPS option provides power to the acquisition device in instances of faltering or no
AC; and can be used as a battery to supply power for up to three hours. Note that the UPS is intended for use by
the acquisition device only. It is not connected to the receptacles that supply power to the laptop PC.
TM
.
1-2 Introduction and Hardware Setup PowerVista/312 User’s Manual
Figure 1-2. PowerVista/312, Hardware Identification
PowerVista/312 User’s Manual Introduction and Hardware Setup 1-3
1.1.3 Frequently Asked Questions
Can I Operate PowerVista/312 with the Unit Closed ?
Yes. As long as your unit is configured for your acquisition, has the signal connections correctly made, and has
been properly powered-up, you can close the unit, lock it, and allow the acquisition to take place automatically.
Note: It is important to keep PowerVista/312’s openings free of obstruction to ensure adequate airflow. Also
see the following question, How Do I Keep the System Cool?
How Do I Keep the System Cool ?
The unit is self-cooled by its own fan, providing the flow-holes for air circulation are not obstructed. The fan
draws air into the right-side of the lower casing. Air flows beneath the cover plate, then up through holes in the
right-side of the plate. When the case cover is closed, air then flows across the laptop and back out through the
flow-holes in right side of the upper casing.
Note: It is important that you keep PowerVista/312’s openings free of obstruction to ensure adequate airflow.
Also keep the fan intake away from dirt and dust to avoid the intake of foreign material.
What Does the UPS Option Do?
The UPS (uninterruptable power supply) is a system option. The UPS is a power distributor and a rechargeable
power source. When fully charged, the UPS option ensures the PowerVista/312 acquisition device will receive
power for up to three hours when there is no AC available, or when there are periods of bad AC. In the first
case the UPS device is functioning simply as a battery.
Note: PowerVista/312’s UPS option is intended only for use with the acquisition device. It is not intended
for use with the laptop and the system receptacles do not have UPS protection.
Where Should I Plug In the Laptop’s Adapter ?
PowerVista/312 contains two 110 VAC outlets that are intended for use by your laptop’s power adapter. If the
power adapter is mounted on the cover plate, you can use the cover plate’s outlet. If you mount the adapter
beneath the cover plate, you can use the internal outlet that is clearly visible near the right side of the device,
once the cover plate is removed.
Note that the system’s 110 VAC power outlets will have power available as long as the PowerVista/312 is
plugged into a live power source. The cover plate switch and LED do not pertain to PowerVista/312’s AC
outlets.
1-4 Introduction and Hardware Setup PowerVista/312 User’s Manual
1.1.4 Mounting the Laptop
Figure 1-3. Attaching a Laptop to the Cover Plate
It is a simple task to mount the Laptop to PowerVista/312’s cover plate. When mounting the laptop, remember
to allow room for your laptop’s power adapter; unless you plan to locate the adapter beneath the cover plate as
discussed in section 1.2.3, Connecting the PC). Also, be sure that the laptop will not cover the circulation vents
on the left side of the cover plate.
Mount the laptop as follows:
1. Verify that PowerVista/312’s cover plate and bottom surface of the laptop are clean. This will provide for
optimum adhesion of the dual-lock tabs.
2. Attach a dual-lock tab (with its mating tab still attached) near each corner of the laptop’s bottom surface.
Note that there are two sets of dual-lock tabs. The smaller tabs are for use with the PC’s power adapter.
3. Expose the adhesive of the lower tabs.
4. Carefully place the laptop into position and press firmly.
Note: Use the smaller dual-lock tabs and similar method if you desire to mount the PC’s power adapter to the
cover plate.
PowerVista/312 User’s Manual Introduction and Hardware Setup 1-5
1.1.5 Connecting the PC
This section involves connecting your laptop to the acquisition device via parallel communications cable, and
connecting your laptop to power.
Note: To run the EasyPower Measure program, the following notebook PC requirements are essential:
• Pentium 150 MHz or better.
• At least 32 Mbytes of memory.
• Windows 95 operating system.
• At least a 1 Gigabyte hard drive (data storage).
• 256 kByte or greater disk cache.
• 800x600 display minimum.
• PCMCIA card slot (optional)*
*The PCMCIA card slot is needed if the optional WBK20 PC card will be used for your system. The WBK20
provides enhanced parallel port communications. Refer to WBK20 documentation if applicable to your
application. To connect your laptop computer:
1. Connect your laptop to the data acquisition device using the parallel port connector or the optional WBK20
PC-card. If using the WBK20 option, please refer to the WBK20 documentation received with your card.
2. If you want to locate your PC power adapter beneath the cover plate, complete this step. If not, proceed
with step 3. Remove the cover plate screws and the cover plate. Position the adapter in the normally
hidden compartment and secure with zip ties (tie wraps). Plug the adapter’s AC cord into the lower
compartment 110 VAC receptacle. Position the PC-end of the adapter cord through the cover plate’s cord
grove and remount the cover plate.
3. If you want to locate your PC power adapter on the cover plate, position the adapter on the plate and plug
the AC end of the cord into the plate’s receptacle.
4. Plug the small end of the adapter cable into your laptop’s adapter jack.
Note: For the cover plate receptacle to have power you must first supply power through PowerVista/312’s
110 VAC power in connector (located on the right side of the unit).
1-6 Introduction and Hardware Setup PowerVista/312 User’s Manual
2 Install Software and Change PC Settings
2.1 Introduction to EasyPower Measure Viewer
EasyPower Measure includes two versions of software with its installation. The main version is em.exe and is
the full-featured version of EasyPower Measure. This version is supplied to you under the legal software
licensing agreement, and cannot be supplied to any other third party. A second version, emview.exe, is a
viewer only version that has all measurement functions disabled. The viewer version is also a "read only"
version of EasyPower Measure. Thus, it can be included on CD ROM as a browser for a well organized archive
backup of collected data. The viewer version may be freely distributed to any third party along with any
EasyPower Measure database files. Make sure that all files in the viewer directory are included with any
archive or transmittal of data, or the viewer will not function.
With the use of EasyPower Measure software, PowerVista/312 measurement capabilities include:
• Phasor Diagram.
• Detailed Harmonics.
• Spectrum Analyzer.
• Cycle-by-Cycle Capture.
• Event Capture with Demand Recording.
Each of these features has a complete section dedicated to their use and proper application.
2.2 Install EasyPower Measure
Complete the following steps to install EasyPower Measure onto your laptop PC. At the time of installation, all
files necessary to run the program will be installed.
Once the software has been installed, several modifications must be made to the PC to allow real-time capturing
and recording of data. These setting modifications are absolutely necessary, and without these you can expect
significant interruptions during data collection. The required changes, such as disabling power management, are
sections 2.3 through 2.7.
Note: Early in the installation process you will need to enter your product’s serial. The serial number consists
of eight digits preceded by the letters EPM.
1. Power up your laptop.
2. Insert Disk1 and follow the Installation Wizard on-screen prompts.
3. Make required changes to PC settings as described in sections 2.3 through 2.7.
2.3 Disable Power Management
The power management features of notebook PCs are the culprits for the majority of their lost performance.
Unfortunately, turning off the feature is most often a two step operation. All power management features of the
notebook PC must be disabled. This will keep vital equipment from timing out (hard drive, PC card, display)
and will allow the processor to run at rated speed.
• System BIOS: The first location to turn off power management features is within the system BIOS. To
modify the settings there, during boot up of the machine, press the function key noted in the display to access
BIOS settings (typically F1 or F2). Find the power management section and disable all of the power
management features.
• Control Panel: The second location to turn off power management is within Windows 95 itself. To modify
settings within Win95, access the system Control Panel, and start up the Power icon.
PowerVista/312 User’s Manual Install Software and Change PC Settings 2-1
Figure 2-1. The Control Panel Power Management ICON.
Once activated, go through each of the tabbed folders and disable all power management features. In most cases
this includes: Power, Disk Drives, and PC-Cards. Make sure that none of these have power management options
checked and operational. You will have to re-boot your machine to make these changes take effect.
2.4 Disable CD ROM Auto Insert Notification
One of the unseen and often overlooked process time stealers is the Auto Insert Notification for CD ROMS.
This feature auto starts a CD ROM software installation as soon as a CD ROM is inserted in the drive. In the
Control Panel, under System icon, then Device Manager tab, the CD ROM device is located among a list of all
equipment presently allocated for the PC. The Auto Insert Notification selection is located under the CDROM
device, then installed model, then device Settings Tab. This selection should be unchecked to keep Win95 from
taking process time by auto-polling the CD ROM to see if an installation disk has been loaded.
Figure 2-2. CD ROM Auto Insert Notification.
2.5 Disable Win95 Screen Savers and Energy Management Functions
Screen savers and energy management functions are additional process time stealers. These functions also need
to be completely disabled to be able to run EasyPower Measure as a real time un-interrupted application. The
energy management functions are also the most customized setup configuration for the PC, where vendors apply
all types of specialty functions as well as non-standard Win95 interfaces. With such variations, suffice it to say,
any energy management function or screen saver utility (Win95 or other installed program) must be disabled.
2-2 Install Software and Change PC Settings PowerVista/312 User’s Manual
Figure 2-6. Default Screen Saver and Energy Management in Win95.
2.6 Disable Virtual Memory Management [if necessary]
The virtual memory settings within Win95 are almost always defaulted such that Windows is managing your
virtual memory. There really is no real problem with this, and there are added benefits such as an increased
virtual disk cache (using PC memory). This increases performance when writing events to disk so that there is
(for burst type events) no waiting on the hard drive to write events. Event throughput thus in this mode is not
limited by the write speed of the drive. In most systems, there is adequate drive throughput to continuously
capture events with no loss of data for 50 and 60 Hz systems.
If your particular system however is running into the Windows background processing dilemma, there is a
solution. On occasion, Windows will decide to clean up its virtual memory on disk and unload a few dynamic
link libraries. When this happens, process time is taken away from the application.
This has not seemed to be an issue with Version 1.0 of EasyPower Measure, but if it is a problem there is
clearly one simple solution. Disable virtual memory management. This will require the PC to have at least
32 M of system RAM so that the operating system and EasyPower Measure can reside together. This has been
used successfully to run the application within such a dedicated environment for real-time data acquisition.
When the user desires to review measurements and also use other Windows applications, it is recommended that
virtual memory management be re-instated. For any changes in virtual memory management, the system will
have to be re-booted.
PowerVista/312 User’s Manual Install Software and Change PC Settings 2-3
Figure 2-4. Virtual Memory Management.
2.7 Disable Additional Process Time Stealers [if necessary]
A few other process time stealers that may have to be disabled include:
• Auto EMail Answer.
• Any background Network Communication.
• Sounds (with this enabled, Windows will load and play a wave file for system responses).
• Auto Answer Modems.
2-4 Install Software and Change PC Settings PowerVista/312 User’s Manual
3 Software Framework
3.1 Overview
EasyPower Measure is a Windows multiple document interface (MDI) application. The software uses the same
style of interface seen in typical Windows applications such as Microsoft Word or Excel. The application runs
within an MDI frame window that has a menu bar and tool bar attached to the top. Upon initiating EasyPower
Measure, it automatically maximizes itself so that it fills the entire screen of your PC. You are free to resize the
Application Window, but will find that on 800x600 displays, a maximized screen is best to capture and view
data.
Within the Application Window are Acquisition Windows. Each of the Acquisition Windows contains several
Result Windows that display measurement results, and an integrated Database View in the lower pane. A
splitter bar (moved to view more or less of the database shot list) separates the Result Windows from the
Database View. A sample EasyPower Measure interface screen is shown in Figure 3-1.
Figure 3-1. EasyPower Measure MDI Interface.
When you start EasyPower Measure for the first time, there will be only one Acquisition Window, and its Result
Windows will be set for Phasor Diagram measurements.
PowerVista/312 User’s Manual Software Framework 3-1
3.2 File Access
File access for EasyPower Measure follows standard Windows convention for a multiple document interface
(MDI) application with only one significant exception. Since data collection is considered mission critical, and
loss of data is to be avoided at all costs, once a database has been saved with a supplied name using File Save
As, no additional saving is necessary.
With this method, if collected data appears in the shot list, then it has already been written to the database file on
disk. This is true even if additional data captures have been snapped into the database. When terminating the
application or an acquisition window under this condition, the user will not be prompted to save a database file.
Thus, if the database file is in tact and not corrupted, then data has been archived successfully.
3.2.1 File New
File New opens a new Acquisition Window with an associated EasyPower Measure database file assuming
default parameters for all configuration settings. The user can now collect data into this temporary database. To
save collected data permanently on the hard drive, the user must save the database using File Save As. It is
recommended that as soon as a new database is created with File New that the database be saved. If Win95
were to crash with a temporary file in use, the data collected in that temporary file will be lost. If the database
has already been saved and named, then collected data will always be written directly to the database file on
disk. No additional saving is necessary, and the user is not prompted to save when terminating the application
or an Acquisition Window.
3.2.2 File Open
File Open opens an existing database file and associates it with an Acquisition Window. Collected shots will be
displayed in the Database View. All data collected from this point will be appended to the opened file.
3.2.3 File Save As
File Save As is used to supply a registered disk file name to the database associated with the presently selected
Acquisition Window. When using File New, File Save As should be executed next. Without this action,
captured data is snapped and stored into temporary files. Upon exiting the application or Acquisition Window,
the user will be prompted to supply a registered disk file name through the File Save As dialog window.
Figure 3-2. File pull down menu.
3-2 Software Framework PowerVista/312 User’s Manual
3.2.4 File Close
File Close terminates the presently selected Acquisition Widow. This is similar to a left mouse click on in
the upper right corner of the Acquisition Window. If shots have been saved in a temporary database file, the
user will be prompted automatically to save the captured data with a registered file name.
3.2.5 File Clear
File Clear deletes all shots from the presently viewed database. The user is prompted with:
Delete all entries in database?
before the database is cleared. Clicking on OK will destroy all captured shots and is non-recoverable. Care
should be taken before clearing all shots from a database.
3.2.6 Write ASCII
Write ASCII outputs ASCII text files of collected digitized data, the shot list, and the system setup. The data
output is determined by which measurement feature is presently selected (has focus). The user is prompted for
an output filename. EasyPower Measure will automatically choose filename extensions for the data being
saved. For some Result Windows, more than one text file could be written to disk. Table 2 lists the filename
extensions used with each measurement feature.
Measurement Feature Extensions Comment
Phasor Diagram .phs All data in one file.
Detailed Harmonics .hrm .hra .hrw Magnitudes, angles, waveshapes respectively
Spectrum Analyzer .spm .spw Magnitudes and waveshapes respectively
Cycle-by-Cycle Capture .cyc All data in one file
Event Capture .evt All data in one file
Demand Logging .dm1 to .dm8 In order of demand shots in database.
Harmonics Logging .dh1 to .dh9 In order of demand harmonic shots in database.
System Setup .stp All critical configuration information.
Shot List .sht All items listed in shot list.
Table 2. ASCII filename extensions.
3.2.7 File Exit
File Exit terminates the application. If any Acquisition Windows need to be saved, the user will be prompted.
The default configuration file is also updated. This is similar to a left mouse click on
corner of the Application Window.
3.3 User Configuration
The complete configuration of each Acquisition Window in the application workspace can be saved as a user
configuration to disk. This configuration file allows the user to set up a customized data collection work space
and save it for later use. With simple file loading, each previously saved user configuration can be loaded to
minimize instrumentation setup time and create a consistent measurement procedure. In addition to the user
configuration, EasyPower Measure will always remember the configuration setup when the application was last
terminated. Configuration files store the complete application configuration including:
• All configuration parameters for each Application Window as seen in the configuration dialogs.
• All Acquisition Window sizes and positions.
• Up to eight (8) acquisition windows.
•
Result Window size and position.
A directory of typical user configurations has been supplied with this program. Table 3 below lists the
configuration file names and notes particular applications.
in the upper right
PowerVista/312 User’s Manual Software Framework 3-3
Table 3. Supplied User Configuration Files.
Configuration File Comment
120VdemY.cfg 120 V, Wye connected PTs, gains set for maximum demand accuracy.
120VevtY.cfg 120 V, Wye connected PTs, gains set for event capture.
208VdemD.cfg 208 V, Delta connected PTs, gains set for maximum demand accuracy.
208VevtD.cfg 208 V, Delta connected PTs, gains set for event capture.
277VdemY.cfg 277 V, Wye connected PTs, gains set for maximum demand accuracy.
277VevtY.cfg 277 V, Wye connected PTs, gains set for event capture.
480VdemD.cfg 480 V, Delta connected PTs, gains set for maximum demand accuracy.
480VevtD.cfg 480 V, Delta connected PTs, gains set for event capture.
3.3.1 Load User Config
Load User Config allows the user to load previously stored configuration files. This command prompts the user
to: “Close all acquisition windows?” since it will close all presently opened Acquisition Windows and load a
completely new setup. If OK is selected and if there were any Acquisition Windows using temp files to save
shots, the user will be prompted to save each previously unsaved database.
Note: A loaded User Configuration does not reload any associated databases. The User Configuration is a
template of the entire configuration without collected data. Once the User Configuration is loaded, the
File Save As command should be used to save any collected shots as well as to make that database able
to permanently archive automatically.
3.3.2 Save User Config
Save User Config saves the user configuration to disk in a selected or entered filename and directory location.
Note: A saved User Configuration will not contain the filenames for any associated databases presently
displayed in the application. The User Configuration saves a template of the entire configuration
without collected data. Once the User Configuration is reloaded, the File Save As command should be
used to save any collected shots as well as to make that database able to archive permanently
automatically.
3.3.3 Update Default Config
The default configuration is saved to the disk file default.cfg during the closing procedure of the application.
However, if the user wishes to update the default configuration file at any time, this command may be invoked to
do so. The default configuration file is stored in the EasyPower Measure installation directory.
Program Failure: If EasyPower Measure does not load properly, or if it appears to have extreme erratic
behavior, there is the possibility that the default configuration file has been corrupted. This file can be deleted at
any time and it will not harm operation of the program. Any settings previously saved in the file will of course
be lost, and the user will have to redefine the system configuration. User Configurations however can be loaded,
assuming they have integrity and have not been corrupted.
3.4 Printing
Printing of result windows for each acquisition measurement feature can be accomplished through Windows
standard file printing. Printing is performed in two possible ways, which is governed by the Print Summary
Pages setting in the Configuration / Preferences dialog. If this setting is checked, summary printouts for result
windows are accumulated into one or more condensed reports. If this setting is not checked, then a single
graphic is printed for the presently selected result window.
3-4 Software Framework PowerVista/312 User’s Manual
3.4.1 Print
Print either a result summary or a single result window to the output device selected in Print Setup. The result
summary option is selected in the Configuration / Preferences dialog.
Note: This command operates on the Result Window with focus.
3.4.2 Print Preview
Perform a Print Preview to screen of either a Result Summary or a single Result Window as it would appear on
the output device selected in Print Setup. The Result Summary option is selected in the
Configuration/Preferences dialog. If no printer has been installed via Win95 standard print device selection,
then Print Preview will not function. To run Print Preview, a printer must be installed even if printing will never
be performed from the measurement PC.
Note: This command operates on the Result Window with focus if Result Summaries are not selected.
3.4.3 Print Setup
Print Setup selects the printer for Print and Print Preview, and specifies Windows standard parameters for
printing on an output device.
3.5 Copy - Paste Shots
The copy and paste shots feature built into EasyPower Measure makes the application a flexible data gathering
and organizing tool. Copy Shots and Paste Shots is supplied to copy shots from one database to another, thus
allowing the user to construct databases with only desired measurements.
The EasyPower Measure database has been designed for speed, and thus contains two files for each database.
The first file with extension .dem is the main data holding file. The second file is the pointer file with a .kem
extension. The pointer file contains pointers for fast random access reads of the main data file, and the
description seen in the database view for each shot. The size of the .dem file will always be much larger than its
companion file since it holds the actual snapped data.
Note: Both the .dem and .kem files are essential to define a database. If either one of the pair is deleted,
renamed or modified, then access to the database is impossible.
The database has been designed for speed writing during event capture. For this reason, the database files
cannot have individual shots deleted from within the database. The entire contents of the file can be removed
(see File / Clear) however this is no help in saving only a small portion of data out of a large file. To solve this
problem, shot copy and paste between Acquisition Windows (and thus respective databases) was integrated into
the application.
3.5.1 Copy Shots
Contrary to its command name, Copy Shots does not actually copy data, but retains a list of desired shots that
the user wants to transfer to an alternate database.
The user utilizes the Database View multiple selection list box feature (similar to the file lists in Win95
Explorer) to select shots in an Acquisition Window. Once the shots are selected (highlighted), the user should
issue the Copy Shots command. This command copies the selected list of shots and the source of the shots to
memory for future access.
After selecting (gaining focus by a left click on title bar) the paste acquisition window for the copied shots, the
Paste Shots command should be issued.
Note: There is a 5000 shot maximum limit on the number of shots that can be copied at one time.
PowerVista/312 User’s Manual Software Framework 3-5
3.5.2 Paste Shots
The Paste Shots command accesses the list of shots to copy stored in memory (put in memory by Copy Shots).
This list also contains the desired source database. Paste Shots performs all of the read and write commands
necessary to transfer a copy of the shots to the newly selected Acquisition Window. As each shot is read into
memory, the source Acquisition Window can be seen drawing each shot. This is an update monitor as well a
visual verification of the shots copied.
Note: There is a 5000 shot maximum limit on the number of shots that can be copied at one time.
3.5.3 Change Shot Titles
The Change Shot Titles command allows the user to edit and modify the site description and shot description
titles. Once data has been collected in the field, invariably, documentation changes and adjustments will be
necessary to properly describe the collected data. These are the only modifications that can be made to
previously collected data. To maintain the integrity of the data, and the parameters under which it was collected,
no other items in the Critical Configuration can be modified for an archived shot. Title changes have been
allowed here to facilitate proper documentation and editorial enhancements.
3.6 Copy to Clipboard
The copy to clipboard features within EasyPower Measure give the user graphical, text and delimited text
access to all results reported within any Result Window. Graphics are copied as Windows metafiles and
bitmaps, text is copied as straight non-proportional font column oriented results, and delimited data is copied
with tab delimiters for direct porting into spreadsheets. The delimited data feature gives users click and paste
access to all digitized data captured within the application for post processing.
3.6.1 Copy Graphics or Text
Copy Graphics or Text is used to copy report quality output onto the system clipboard. Graphics are copied in
both a Windows metafile format as well as a bitmap format. Text is copied as non-proportional spaced, column
oriented report. Both graphics and text reports will match the data presented identically in the result view
copied.
Note: This command operates on the Result Window with focus.
The text report may have to be slightly modified once pasted into the document that is presently being edited.
Typically, users will be creating a document with a proportional spaced font. Proportional spaced fonts cannot
be used to align space oriented columns (the technique used in the EasyPower Measure reports). It is suggested
that the pasted report text be modified to incorporate the Courier or Courier New font. Both are nonproportionally spaced fonts.
Once a graphic metafile has been pasted into a document, it may be scaled (click and drag on corners) to fit the
page according to the users taste. The metafile may also be edited. Editing of a metafile in a word processor
should be tested, as these editors have been known to effect permanent undesired modifications to the graphic
content without any user modifications.
3.6.2 Copy Delimited Data
Copy Delimited Data allows the user to have full access to actual digitized and calculated values. This function
copies the internally held data to the system clipboard for paste within any Windows application that offers
clipboard paste functionality. In most cases, this data will be imported into a spreadsheet for post processing.
Delimited data copying is supplied for both the graphic result windows as well as the tabulated text result
windows.
Note: This command operates on the Result Window with focus.
3-6 Software Framework PowerVista/312 User’s Manual
3.7 Tools
Several tools have been supplied to make accessing results simple and convenient. With a single click of these
toolbar buttons the user can access all recorded data quickly with several view formats so that measurements can
be assessed and verified before continuing additional collection.
3.7.1 Engineering vs. Percent Toggle
Engineering vs. Percent toggles harmonic results from percent on fundamental base to physical units, i.e. volts
and amps. This will apply to the Phasor Diagram and the Detailed Harmonics in both their tabulated and
graphical results. These two acquisition features have separate selections in their configuration for toggling this
option, but the toolbar will modify the setting appropriate to the measurement feature in view.
3.7.2 Cycle Graph Forward
Cycle Graph Forward causes the graphical and tabulated text results to be scrolled to the next view choice. In
each acquisition configuration dialog there are display choices for what collected data item is to be displayed
(via drop down lists). This method of displaying data has been adopted since:
•
it is impossible to display all of the data collected for a given acquisition.
• there is a need to see the acquired data.
• collected data falls within an acquisition type.
There are three methods for moving to a particular data display,
1. Access the acquisition configuration dialog (for example, Configuration / Phasor Diagram), and
select a display choice.
2. Press the
Cycle Graph Forward
button to select the next data item(s) to display as ordered in the drop
down list choices in each acquisition configuration dialog.
3. Press the Cycle Graph Backward button to select the previous data item(s) to display as ordered in the
drop down list choices in each acquisition configuration dialog.
When Cycle Graph Forward has reached the end of the display list, it cycles to the top of the list in a circular
fashion. Likewise, when Cycle Graph Backward has reached the beginning of the display list, it cycles to the
bottom of the list in a circular fashion. Thus, all data views can be displayed very quickly using repeated clicks
on the Cycle Graph Forward and Cycle Graph Backward buttons. Table 4 lists the acquisition views and how
they are affected by Cycle Graph Forward and Cycle Graph Backward.
Table 4. Cycle Graph Forward and Backward Effects.
Acquisition Type Effect
Phasor Diagram Cycles Phasor Graphics and Phasor Demand result windows.
Detailed Harmonics Cycles all result windows.
Spectrum Analyzer Toggles from dB to Linear.
Cycle by Cycle Cycles all result widows.
Event Capture Cycles all result windows.
Demand Logging Not cycled.
Demand Harmonic Logging Not cycled.
PowerVista/312 User’s Manual Software Framework 3-7
3.7.3 Cycle Graph Backward
Cycle Graph Backward causes the graphical and tabulated text results to be scrolled to the previous view choice.
In each acquisition configuration dialog there are display choices for what collected data item is to be displayed
(via drop down lists). This method of displaying data has been adopted since:
•
it is impossible to display all of the data collected for a given acquisition.
• there is a need to see the acquired data.
• collected data falls within an acquisition type.
There are three methods for moving to a particular data display,
1. Access the acquisition configuration dialog (for example, Configuration / Phasor Diagram), and
select a display choice.
2. Press the Cycle Graph Forward button to select the next data item(s) to display as ordered in the drop
down list choices in each acquisition configuration dialog.
3. Press the
drop down list choices in each acquisition configuration dialog.
When Cycle Graph Forward has reached the end of the display list, it cycles to the top of the list in a circular
fashion. Likewise, when Cycle Graph Backward has reached the beginning of the display list, it cycles to the
bottom of the list in a circular fashion. Thus, all data views can be displayed very quickly using repeated clicks
on the Cycle Graph Forward and Cycle Graph Backward buttons.
Table 4 (see Cycle Graph Forward) lists the acquisition views and how they are affected by Cycle Graph
Forward and Cycle Graph Backward.
Cycle Graph Backward
3.7.4 Cycle Harmonics Forward
Cycle Harmonics Forward causes the harmonics tabulation in the Phasor Diagram to be scrolled to the next view
choice. The harmonics tabulated data view can also be selected through the Configuration / Phasor Diagram
dialog, Harmonics View list box. When Cycle Harmonics Forward has reached the end of the display list, it
cycles to the top of the list in a circular fashion.
3.7.5 Cycle Harmonics Backward
Cycle Harmonics Backward causes the harmonics tabulation in the Phasor Diagram to be scrolled to the next
previous choice. The harmonics tabulated data view can also be selected through the Configuration / Phasor
Diagram dialog, Harmonics View list box. When Cycle Harmonics Backward has reached the top of the display
list, it cycles to the end of the list in a circular fashion.
button to select the previous data item(s) to display as ordered in the
3.7.6 Take Snapshot
Take Snapshot will copy the acquisition data presently in view to the integrated database, appending it to the
end. If the database file was opened from a previous session using File Open, or if after File New it has already
been saved using File Save As, then data will be saved directly to the file on the hard disk and archived
permanently. If the present acquisition is a new window and has not been previously saved, results are stored in
a temporary hard disk file (transparent from the user) until saved via the File Save As command.
Take Snapshot will take database shots for all but one acquisition feature and two database entry types. Table 5
lists each shot type with its four letter pneumonic as seen in the Database View.
3-8 Software Framework PowerVista/312 User’s Manual
Table 5. Shot Four Letter Pneumonics for Database View.
Shot Type Shot Type Pneumonic
Phasor Diagram Phas
Detailed Harmonics Harm
Spectrum Analyzer Spec
Cycle-by-Cycle Cycl
Event Capture Evnt - Not Snapped
Demand Logging Demd - Not Snapped
Demand Harmonics
Logging
Demd - Not Snapped
3.8 Window Management
EasyPower Measure is a multiple document interface (MDI) application. This means that movement and
resizing of any windows follows standard Windows graphical user interface conventions. EasyPower Measure
has been developed under the Microsoft C++ SDK and uses C++ object oriented coding for all window
management.
3.8.1 Determining Focus
As with any MDI application, Focus determines what window is selected so that the application can respond
appropriately to a users commands. The title bar for each Result Window will highlight in the system focus
color (which can be configured via Display under the Win 95 Control Panel) when any part of the window is
selected.
Also, the Database View can achieve focus by clicking within its top column label area. Database View focus
will not activate a highlighted title bar (there is no title bar to conserve space), but will display the
binoculars within its top column label area.
focusing
Once a window has focus, commands like
Copy Graphics or Text
will perform their action on the window that has focus.
Clicking on the title and border of any window will give that window focus. But in addition to giving focus, the
same mouse actions can be used to:
• Move the window: The title bar of each window can be grabbed (left mouse click and hold) while
repositioning it to another location within its parent window.
• Resize the window: Moving the mouse over the borders of any window will change the mouse cursor
to a symbol for resizing the window from top, bottom, sides, or corners. With the mouse cursor in its
modified state, left mouse click and hold to resize the window within the parent window.
The Parent-Child relationship of windows within EasyPower Measure is as follows:
Parent Child
Win95 EasyPower Measure Application Window
Application Window Acquisition Windows
Acquisition Window Result W indows, Database View
PowerVista/312 User’s Manual Software Framework 3-9
Loading...