Script Menu

The commands in this menu can be added to a Script window to automate the execution of these and other ME'scope commands.

Display | Cursor

Displays and positions the cursor in the Data Block window.

Parameters

1. (Line, Band, Peak, None)

2. Position

   • Percentage (1 to 100) of the Block Size The number of samples of data in each M# of a Data Block or Acquisition window. The current Block Size can be viewed and edited in the File | Data Block Properties dialog box. Increasing the Block Size appends zero valued samples to each M#. Decreasing the Block Size removes samples from the higher frequency or time values of each M#.

   • Sample (1 to the Block Size)

   • Horizontal Axis Units (Hz, RPM, CPM, Sec, Milli-sec, micro-sec)

3. Bandwidth

   • (Percentage, Sample, Horizontal Axis Units)

Display | Zoom

Zooms the display in the Data Block.

Parameters

1. Zoom start

   • Percentage (1 to 100 of the Block Size)

   • Sample (1 to the Block Size)

   • X-Axis Units (Hz, RPM, CPM, Sec, milli-sec, micro-sec)

2. Zoom end

3. Percent, Samples, X-Axis Units)

Display | Sine Dwell Cycles per Shape

Sets the number of Sine Dwell Sine Dwell in one of the three types of shape animation in a Structure window. During Sine Dwell animation, the displayed shape is animated by multiplying it by sine wave values as a unit circle is tranversed in equal increments from 0 to 360 degrees. . Cycles per Shape during Sweep Animation Sweep Animation is one of the three types of shape animation in a Structure window. During Sweep animation from a Data Block or Acquisition window, the cursor is moved through the graph from left to right, and the data at each cursor position is displayed as a shape on the model. During Sweep animation from a Shape Table, each shape is displayed in succession using Dwell Animation and the number of dwell cycles from the Animation tab in the File | Shape Table Options box. from a Data Block.

• During Sweep animation from a Data Block, the specified number of Dwell Cycles per shape is carried out before displaying the next sample of shape data.

Parameter

1. Number of Cycles

M#s | Select an M#

Selects (or un-selects) a single M# in the M#s spreadsheet.

Parameters

1. M# (can also be a Macro Variable)

2. Select (yes or no).

3. Un-select All First (yes or no)

M#s | Select

Selects (or un-selects) a range of M# M# is an abbreviation for Measurement Number. Each measurement function in a Data Block or Acquisition window has a unique M#. Also, each shape component in a Shape Table window has a unique M#. Each M# in the connected Animation Source must be Assigned to a DOF of the structure model in order to display shapes from the Source in animation. Each un-measured DOF on the model is animated by creating an M# Interpolation using nearby Measured and Fixed DOFs.s in the M# spreadsheet.

Parameters

1. M#s (1,2,3,,,; 1-3; all)

2. Select (yes or no).

3. Un-select All First (yes or no)

M#s | Color

Changes the color of all (or selected) M#s in the Data Block.

Parameter

1. Color (from color pallet)

M#s | Label

Changes the label of all (or selected) M#s in the Data Block.

Parameter

1. Label (text)

M#s | DOFs

Changes the DOFs of all (or selected) M#s in the Data Block.

Parameter

1. DOFs (1X , 1Y, 1Z ,...)

M#s | Units

Changes the units of all (or selected) M#s in the Data Block.

Parameters

1. Units (g, N, lbs,...)

2. Re-scale M#s (yes or no)

M#s | Measurement Type

Changes the Measurement Type of all (or selected) M#s in the Data Block.

Parameter

1. Type (FRF An FRF (Frequency Response Function) is a cross-channel frequency domain function that defines the dynamic properties of a structure between an excitation Force and the Response caused by that force. An FRF is defined as the ratio (Response DFT / Force DFT). The FRF is a special case of a Transfer Function, where the response is the numerator (Output) and the force is the denominator (Input)., Auto spectrum An Auto Spectrum is calculated by multiplying the Fourier spectrum of a signal by its complex conjugate. The Auto spectrum has magnitude only. Its phase is zero. An Auto spectrum can have either Linear (RMS) units or Power (MS) units. Linear or Power engineering units are chosen in the Linear Power column in the Traces spreadsheet.,...)

M#s | Input Output

Changes the Input Output of all (or selected) M#s in the Data Block.

Parameter

1. Input Output (Input, Output, Both, Cross)

M#s | Visibility

Makes all (or selected) M#s visible (or invisible) in the Data Block.

Parameter

1. Visible (yes or no).

M#s | Linear/Power

Changes the Linear/Power property of all (or selected) M#s in the Data Block.

Parameter

1. Linear or Power.

M#s | Group

Gives a Group name to all (or selected) M#s in the Data Block.

Parameter

1. Group text name.

M#s | dB Reference

Gives a dB reference value to all (or selected) M#s in the Data Block.

Parameter

1. dB Reference value.

M#s | Copy M# parameters to Clipboard

Copies parameters from the M#s spreadsheet to the Windows Clipboard.

Parameters

1. Top Left Row.

2. Top Left Column.

3. Bottom Right Row.

4. Bottom Right Column.

M#s | Paste Clipboard data to M# parameters

Pastes data from the Windows Clipboard into the M#s spreadsheet.

Parameters

1. Top Left Row.

2. Top Left Column.

3. Bottom Right Row.

4. Bottom Right Column.

M#s | Copy M# parameter to Variable

Copies a parameter from the M#s spreadsheet to a Global Variable.

Parameters

1. Row.

2. Column.

3. Variable Name.

M#s | Paste Variable to M# parameter

Pastes a Global Variable value into an M# parameter in the M#s spreadsheet.

Parameters

1. Row.

2. Column.

3. Variable Name.

Tools | Tachometer Peak Finder

Returns the X-Axis value of a peak when the Y-Axis value exceeds a threshold level in the first (or selected) M#.

Parameters

1. X-Axis

   • Percentage (1 to 100 of the Block Size)

   • Sample (1 to the Block Size)

   • X-Axis Units (Hz, RPM, CPM, Sec, milli-sec, micro-sec)

2. Start of X-axis search range

3. End of X-axis search range

4. Minimum peak value (in the Y-axis units)

5. Threshold (percentage of peak value in the search range)

6. Global variable name (used when part of a Script window command)

Tools | Damping Decay Constant

Calculates the damping decay constant for each M# in a time domain Data Block.

The damping decay constant is the coefficient of the exponential decay envelope on a decaying sinusoidal response.  The Logarithmic Decrement method is used to calculate the damping decay constant.  A straight line is curve fit to the Log Magnitude of each measurement, and its slope is damping decay constant.  For a single resonance, the damping decay constant is the same as the modal damping in Hz obtained by curve fitting FRFs using one of the Modal Analysis options.

Parameters

1. Destination Data Block

2. Save method (Add To, Replace)

Tools | Save Cursor as M#s

Saves the cursor values (for the Line, Band, or Peak cursor) for all or selected M#s into a Data Block as a constant value for all samples.