Range Functions

The following table shows the Functions according to their Categories. The most commonly used range categories are Math and Radiation. Other functions could be used if needed. Use the category links to navigate to tables with definitions of functions.

Category	Functions
Math	max, min, pk2pk, rms, sum, mean, variance, stddev, integabs, avgabs, rmsAC, ripple, pkavg, XatYMin, XatYMax, YAtXMin, YAtXMax, XAtYVal, YAtXVal, XWidthAtYVal
PulseWidth	pulsemin, pulsemax, pulsemintime, pulsemaxtime, pulsefall9010, pulsefront1090, pulsefront3090, pulsetail50, pulsewidth5050, pw_plus, pw_minus, pw_plus_avg, pw_minus_avg, pw_plus_max, pw_minus_max, pw_plus_min, pw_minus_min, pw_plus_rms, pw_minus_rms
Overshoot, Undershoot	overshoot, undershoot.
TR & DC	crestfactor, formfactor, distortion, fundamentalmag, delaytime, risetime, deadtime, settlingtime
Error	iae, ise, itae, itse
Period	per, pmax, pmin, prms
AC	gainmargin, phasemargin, gaincrossover, phasecrossover, lowercutoff, uppercutoff, bandwidth, peakgain, peakgainfreq.
Radiation	xdb10bandwidth, xdb20bandwidth, lSidelobeX, lSidelobeY, rSidelobeX, rSidelobeY
Eye Measurements	EyeLevelZero, EyeLevelOne, EyeAmplitude, EyeHeight, EyeSignalToNoise, EyeOpeningFactor, EyeWidth, EyeJitterP2P, EyeJitterRMS, EyeRiseTime, EyeFallTime, MinEyeWidth, MinEyeHeight Note: Refer to the SI Wave or Nexxim help for more information. The Purpose field offers brief descriptions of each.

Math Functions
*avg	Returns the average of the values of the selected quantity. avg = (Area between the curve and the X-axis) / ( X length of the curve)
avgabs	Returns the mean of the absolute value of the selected quantity.
integabs	Absolute value of integral.
max	Returns maximum value of the simulation quantity.
mean	Returns the average in the set of quantities selected. mean = sum( all y-value) / (number of y-values)
min	Returns the minimum value of the simulation quantity.
rms	Returns the root mean square value of the selected quantity.
rmsAC	Returns the AC RMS for the selected quantity.
ripple	Returns the ripple factor (AC RMS/Mean) for the selected quantity.
pkavg	Returns the ratio of the peak to peak-to-average for the selected quantity.
pkp2pk	Peak to peak. Difference between max and min of the first parameter over the second parameter. Returns the peak-to-peak value for the selected simulation quantity.
sum	Returns the sum of the given values.
stddev	Returns the standard deviation of given values.
variance	Calculates the variance of the given values.
XAtYMax	Threshold crossing time: report first time (x value) at which an output quantity crosses YMax.
XAtYMin	Threshold crossing time: report first time (x value) at which an output quantity crosses a user definable threshold.
XAtYVal	Returns the X value at the first occurrence of Y value.
XWidthAtYVal	Returns the X width between the first 2 occurrences of Y value.
YAtXMax	Returns the X value at maximum value of Y.
YAtXMin	Returns the Y value at minimum value of X.
YAtXVal	Returns the Y value at the first occurrence of X value.

Radiation Functions
lsidelobeX	The 'x' value for the left side lobe: the next highest value to the left of the max value.
lsidelobeY	The 'y' value for the left side lobe: the next highest value to the left of the max value.
rSidelobeX	Returns the X value of right side-lobe occurrence.
rSidelobeY	Returns the Y value of right side-lobe occurrence.
xdb10beamdwidth	Width between left and right occurrences of values 'x' db10 from max. Takes 'x' as argument (3.0 default). To use this function, you need to open the Add Trace Characteristics dialog and select the Radiation category.
xdb20beamwidth	Width between left and right occurrences of values 'x' db20 from max. Takes 'x' as argument (3.0 default) To use this function, you need to open the Add Trace Characteristics dialog and select the Radiation category.

Pulse Width Functions Note: In this table, the functions with the asterisk (*) do not appear on the Range Function drop-down menu. They can still be used via text entry.
pulsefall9010	Returns the pulse fall time of the selected quantity according to the 90%-10% estimate.
pulsefront1090	Returns the pulse front time of the selected quantity according to the 10%-90% estimate.
pulsefront3090	Returns the pulse front time of the selected quantity according to the 30%-90% estimate.
pulsemax	Returns the pulse maximum from the front and tail estimates for the selected quantity.
pulsemaxtime	Returns the time at which the maximum pulse value of the selected quantity is reached.
pulsemin	Returns the pulse minimum from the front and tail estimates for the selected quantity.
pulsemintime	Returns the time at which the minimum pulse value of the selected quantity is reached.
pulsetail50	Returns the pulse tail time of the selected quantity from the virtual peak to 50%.
pulsewidth5050	Returns the pulse width of the selected quantity as measured from the 50% points on the pulse front and pulse tail.
*pwl	Piecewise Linear.
*pwl_periodic	Piecewise Linear for periodic extrapolation on x.
*pwlx	Piecewise Linear x with linear extrapolation on x.
pw_minus	Pulse width of the first negative pulse.
pw_minus_avg	Returns the average of the negative pulse width input stream.
pw_minus_max	Returns the maximum pulse width of the negative pulse of input stream.
pw_minus_min	Returns the minimum pulse width of the negative pulse of input stream.
pw_minus_rms	Returns the rms of the negative pulse width input stream.
pw_plus	Returns the pulse width of the first postive pulse.
pw_plus_avg	Returns the average of the positive pulse width input stream.
pw_plus_max	Returns the maximum pulse width of the positive pulse of input stream.
pw_plus_min	Returns the minimum pulse width of the positive pulse of input stream.
pw_plus_rms	Returns the rms of the positive pulse width input stream.

Overshoot/Undershoot
Overshoot	Calculates peak overshoot given a threshold value and number of evenly spaced points over entire time range.
Undershoot	Calculates peak undershoot given a threshold value and number of evenly spaced points over entire time range.

TR & DC Functions
crestfactor	Returns the crest factor (peak/RMS) for the selected simulation quantity.
formfactor	Returns the form factor (RMS/Mean Absolute Value) for the selected quantity.
distortion	Returns the total distortion for the selected simulation quantity and an additional argument frequency, which is the frequency in Hz at which to calculate the fundamental RMS of the simulation quantity.
fundamentalmag	Returns the RMS value of the fundamental frequency for the selected quantity, and an additional argument, Frequency, which specifies the fundamental frequency.
delaytime	Obtains the time from zero to 50% of the target point.
risetime	Obtains the time taken to go from 10% to 90% of target point.
deadtime	Obtains the latest time when the qtyl is within a tolerance of zero.
settlingtime	Returns the latest time at which the value of the selected simulation quantity fell outside its tolerance band. The target value of the quantity and the +/- bandwidth of the tolerance band are the additional arguments.

Error Functions
iae	Returns the integral of the absolute deviation of the selected quantity from a target value that is entered via the additional argument.
ise	Returns the integral of the squared deviation of the selected quantity from a target value that is entered via an additional argument.
itae	Returns the time-weighted squared deviation of the selected quantity from a target value that is entered via an additional argument.
itse	Returns the time-weighted squared deviation of the selected quantity from a target value that is entered via an additional argument. To use this function, you need to open the Add Trace Characteristics dialog and select the Error category.

Periodic Functions
per	Returns the period of a simulation quantity.
pmax	Max period of the selected simulation quantity.
pmin	Minimum period of the selected simulation quantity.
prms	Period Root Mean Square.

AC Functions
gainmargin	Returns the gain margin in dB at the phase crossover frequency of the selected simulation quantity. It also requires a reference simulation quantity to which the measured quantity is compared and the AC magnitude and phase angle of the reference quantity. These are entered as the arguments Reference Channel, Base Source Magnitude, and Base Source Angle.
gaincrossover	Returns the gain crossover frequency (where the gain is 0 dB) of the selected simulation quantity in Hz.
phasecrossover	Returns the phase crossover frequency, at which the phase is -180 degrees, in Hz for the selected simulation quantity.
phasemargin	Returns the phase angle in degrees at the gain crossover frequency of the selected simulation quantity.
lowercutoff	Returns the lower 3dB frequency of the selected simulation channel in Hz..
uppercutoff	Returns the upper 3dB frequency of the selected simulation channel in Hz.
bandwidth	Returns the 3dB bandwidth of the selected simulation quantity. For bandwidth, the calculation is based on 3dB below the maximum peak.
peakgain	Returns the peak value of gain of the selected simulation quantity in dB.
peakgainfreq	Returns the frequency in Hz at which the peak gain of the selected simulation quantity occurs.

Related Topics:

Selecting a Function

Range Functions

Eye Measurement Range Function Parameters