EDM Waveform Editor

Manual
8/17/2012

Information in this document is subject to change without notice. No part of this

document may be reproduced or transmitted in any form, for any purpose, without
the written permission of Crystal Instruments Corporation (Crystal Instruments).
By installing, copying or using the Software, the user agrees to be bound by the
terms of the Crystal Instruments End User License Agreement which is a legally
binding agreement between the user (the Licensee) and Crystal Instruments for
the Crystal Instruments software, which includes software components and tools,
and written documentation (Software).
Crystal Instruments makes no warranties on the Software, whether express or
implied, nor implied warranties of merchantability or fitness for a particular purpose.
Crystal Instruments does not warrant your data, that the software will meet your
requirements, or that the operation will be reliable or error free. The Licensee of the
Software assumes the entire risk of use of the Software and the results obtained
from use of the software. Crystal Instruments shall not be liable for any incidental or
consequential damages, including loss of data, lost profits, cost of cover, or other
special or indirect damages.
Copyright 2012 Crystal Instruments Corporation, all rights reserved.
All trademarks and registered trademarks used herein are the property of their
respective holders.

Crystal Instruments

EDM Waveform Editor Manual

Contents
INTRODUCTION
OPERATION AND LAYOUT

4
5

User Interface Layout ................................................................................................................................ 5

Parameter Configuration Window .......................................................................................................... 11
General Options .................................................................................................................................. 12
Displacement Compensation .............................................................................................................. 12
Shaker Settings ................................................................................................................................... 14
Splice Options ..................................................................................................................................... 15
Graphical Editing Operations .................................................................................................................. 17
Signal Display ...................................................................................................................................... 18
Importing and Exporting Signals ......................................................................................................... 19

Crystal Instruments

EDM Waveform Editor Manual

Introduction
The Waveform Editor is used to directly modify time waveforms. It can splice, crop,
filter, and apply compensation to acceleration, velocity, and displacement
waveforms. It is different than the Post Analysis application in that it does not do
FFTs or any other form of higher analysis.

Crystal Instruments

EDM Waveform Editor Manual

Operation and Layout

User Interface Layout
When the application is first opened, the main user interface is as shown below.

Use the New Project toolbar button, or in the Project menu, to create a new
project. By default, a random spectrum signal will be generated. Without creating a
new project, a recently opened project can be opened by clicking on Recent Project
List. Another option is to open a WFE project file from the disk.

Crystal Instruments

EDM Waveform Editor Manual

The menu bar contains the following items:

Project menu:

New Project:

Create a new project

Open Project:

Open an existing project

Save Project:

Save the current project

Save Project As:

Save the current project in a new location

Crystal Instruments

EDM Waveform Editor Manual

Operations menu:

Undo:

Cancel the previous action

Import Signal:

Import a profile signal

Create From Model:

Create a profile from a model

Cut Point:

Delete the data between two cursors

Copy Points:

Copy the signal data from selected area to the clipboard

Paste Left:

Paste the signal data to the left profile

Paste Right:

Paste the signal data to the right profile

Apply Compensation: Apply the compensation template to the profile signal

Decimation:

Decimate, or downsample, the samples in the selection

Rescale:

Rescale the profile

Global Settings:

Change global settings

The View menu opens to select Profile, Velocity, Displacement, PSD, or Histogram
windows.
The Layout window adjusts the display window layout.
7

Crystal Instruments

EDM Waveform Editor Manual

The Report menu is used for generating MS Word reports.

The toolbar contains shortcut buttons of common operations.

The Folder Explorer shows the local file system. It allows files anywhere on the local
disk to be accessed and displayed. When a folder is selected, the signal files and
WFE project files in it will be displayed on the right panel.
Double-click a WFE file to open the project; double-click a signal file to open the
signal data.

Clicking on an ATFX file will preview the attributes as shown below.

Crystal Instruments

EDM Waveform Editor Manual

The Work Tree displays the profile and computed signals. Double-click any of these
to open a signal display window. Right-click on them to export to file or MS Excel.

Crystal Instruments

EDM Waveform Editor Manual

In the signal display area, two vertical cursors are used to define the range of data
operations such as Copy, Paste, and Delete. The right-click menu includes the chart
control operation.

10

Crystal Instruments

EDM Waveform Editor Manual

The Control Panel contains operation buttons, parameter display, and cursor data
display.

Parameter Configuration Window

Click the Config button to enter the parameter configuration window.

11

Crystal Instruments

EDM Waveform Editor Manual

General Options
Line number for spectral analysis sets the number of spectral lines. More lines
increase the resolution of frequency data.
Bin Number sets the resolution of histogram data.
Profile Quantity sets the quantity as acceleration, velocity, displacement, or
voltage.
Undo Max. Step sets the number of cached operations for the Undo command
Start Average Frame sets the starting frame of the average.
Compensation
Compensation involves modifying the time stream so it meets certain constraints in
velocity, displacement, or acceleration. Compensation operations include
Acceleration DC Removal, Velocity DC Removal, and High/Low/Band Pass Filter.
After the proper compensation template setup, one button can execute multiple
operations.
Acc. DC (Vel. Slope) Remove subtracts the DC component in the acceleration
waveform. This removes a slope trend from the velocity waveform. It is needed
when the raw data has an offset measurement error.

12

Crystal Instruments

EDM Waveform Editor Manual

Vel. DC (Disp. Slope) Remove subtracts the DC component in the velocity

waveform. This removes a slope trend from the displacement waveform. It is useful
when acceleration discontinuities are present. An acceleration discontinuity (a
sharp spike in acceleration) will generate an offset in the velocity profile which then
results in a slope in the displacement.
High Pass Filter suppresses low-frequency signals below the specified cutoff
frequency. This method is effective in reducing displacement but may also remove
desirable low frequency energy. The cutoff frequency should be set as low as
possible while still maintaining the displacement requirement.
Low Pass Filter suppresses high-frequency signals above the specified cutoff
frequency. This does not have a major impact on the displacement or velocity
profile. It is useful in that it will help remove high-frequency components that are
undesirable in the acceleration waveform.
Band Pass Filter combines a Low-Pass and High-Pass filter.

13

Crystal Instruments

EDM Waveform Editor Manual

Shaker Settings
The Shaker Settings define the limits of the shaker that will be used to output the
waveform.

14

Crystal Instruments

EDM Waveform Editor Manual

Splice Options

The Splice operation is used to minimize boundary discontinuities when two pieces
of data are put together. Once enabled, the chosen Data Window will be applied to
the data array at both ends for the following cases:

A piece of data is appended to the previous segment during the file import
process.

A piece of data is inserted or pasted into an existing segment.

In the Splice Settings dialog you will be able to define the following: Data Window,
Overlapping, and Number of Windowing Points.

15

Crystal Instruments

EDM Waveform Editor Manual

Data Window
The user can choose different Data Window types to be used in the Splice
operation.

None Disables the Splice function

Hanning Uses a Hanning window during the Splice operation.
Triangle Uses a Triangular window during the Splice operation
Half Sine Uses Half Sine window during the Splice operation
Overlapping

With Overlapping Two pieces of data will be put together with Data Window
overlapping. Note that the total length of the profile will be reduced after splicing.
No Overlapping Data Windows are not overlapped. The length of the profile will
not be altered.
Number of Windowing Points

The Number of Windowing Points allows you to define the length of the Data
Window by number of points. Typically, the Number of Windowing Points is more
than 128.

16

Crystal Instruments

EDM Waveform Editor Manual

Graphical Editing Operations

There are a number of editing options for on-screen manipulation of imported
waveforms. These operations allow cleaning up of the waveform by deleting
unwanted data segments or changing the sequence of events in a waveform.
Copy and Delete Selection
After you have selected an interval from the waveform using two cursors, the Copy
and Delete functions become available to you from the Edit menu, by right mouse
clicking on the selected interval, or by using the toolbar buttons. These functions
allow you to copy the selected interval to the clipboard for pasting or simply to
delete the selection from the overall waveform. Note that Copy and Delete
functions apply only to the Profile Window.
Paste Selection
The Paste function allows you to paste a waveform interval that was previously
copied into the clipboard to a new location on the waveform. Once a waveform
interval has been copied to the clipboard, the Paste to Left and Paste to Right
functions become available to you from the Operating menu, by right mouse
clicking on the selected interval, or by using their respective icons, or by using the
buttons in the Control Panel. Note that Paste functions apply only to the Profile
Window.
Use a single cursor and scroll to point on the waveform where the clipboard
contents will be pasted.

Paste to Left pastes the selected waveform interval in the clipboard to the left side
of the cursor.
Paste to Right pastes the selected waveform interval in the clipboard to the right
side of the cursor.
Undo goes back one step and undoes the last action performed.
Decimation
This operation keeps the signal time length the same and removes every other
sample to reduce the sampling rate by half.

17

Crystal Instruments

EDM Waveform Editor Manual

Rescale
This operation sets the scaling factor to increase or decrease the signal amplitude.

Signal Display
The Waveform Editor provides displays for simultaneous viewing of profile, velocity,
displacement and Histogram waveforms and Power Spectral Density of the
waveforms. The original, uncompensated, and compensated waveforms may be
overlaid. Also the shaker tolerances may be included to verify the acceptability of
the profile for use on a shaker system. Note that velocity and displacement
waveforms apply only to a profile given in acceleration.

18

Crystal Instruments

EDM Waveform Editor Manual

Importing and Exporting Signals

To import a time history waveform as the profile, click on Import Profile in the File
menu. This action will invoke the following dialog box:

19

Crystal Instruments

EDM Waveform Editor Manual

Use the File Name field, or the Browse button, to enter the file name for the data
to be imported. Once the Open command is given, the Waveform Editor will
automatically identify the data format and then import the data from the disk file.
The following data formats can be imported: ATFX, ASCII (CSV, TXT), UFF ASCII, UFF,
Binary, and TDM.

Once the data file has been selected, a few data parameters need to be defined.
Delta T (ms) specifies the sampling rate used for the imported data.

20

Crystal Instruments

EDM Waveform Editor Manual

Value Unit defines the engineering units used for the imported data.
Digital Re-sampling allows you to set sampling rate different than the original
sampling rate. If Auto mode is set, the program will determine the best sampling
rate to use. If the waveform sampling rate exactly matches an available sampling
rate of the Crystal Instruments Vibration Control system, digital re-sampling is not
required. However, if the imported data has a different sampling rate, digital resampling is required to prevent distortion of the waveform shape during output.
Generally you should select Auto for the Sampling Freq (Hz) field.
Digital re-sampling is done internally by a 5th order filter. This high-order filter
ensures against the loss of signal information in the sampling bandwidth during resampling. Be aware that if you choose to digitally re-sample the data at lower rate
than that used to acquire the data, signal aliasing may occur. A better method is to
use the digital low-pass filter and decimate options under Profile Compensation.
Import Method controls how the imported waveform is combined with the existing
profile waveform. Replace initializes the waveform buffer and loads the new
waveform. Add sums the new waveform with the existing profile. From/At position
specifies the data point in the profile buffer to begin insertion of the new waveform
segment.
Create From Model
This button will create a profile from a mathematical model.

21

Crystal Instruments

EDM Waveform Editor Manual

Waveform Type includes Band-Limited Random, White Noise, Chirp, Sine, 24

Triangle Bursts, 48 Triangle Bursts, and Triangle.

Data Points is the total number of points in current profile.

Sampling Rate is the sampling rate in current profile.
RMS is the RMS value in current profile.
Left/Right Cutoff Frequency is the cutoff frequency on left/right band in current
profile.
Check the box to apply ramping window on both ends.
Save Signal/Spectrum
Signals can be saved as the profile signal can be exported to many different file
types as shown below.

22

Crystal Instruments

EDM Waveform Editor Manual