Operate class

Returns

Curve object or NULL

Return type

Curve

Example

To convert curve m to absolute values and store as curve p

p = Operate.Abs(m);

Acos(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Arc Cosine

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Arc Cosine() of curve m and store as curve p

p = Operate.Acos(m);

Acu(Input Curve[Curve], Offset[real], Time Period[real], Output Curve (optional)[Curve]) [static]

Description

Evaluates the integratal of a curve over a user defined period

Returns

Curve object or NULL

Return type

Curve

Example

Integrate c curve over 0.07 seconds with a 0.1 offset.

p = Operate.Acu(m,0.1,0.007);

Ad(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Convert acceleration spectrum to a displacment spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and store as curve p

p = Operate.Ad(m);

Add(Input Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Add Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

To add curves m and n together and store as curve p

p = Operate.Add(m,n);

To add 20.0 to the values in curve m and store as curve p

p = Operate.Add(m,20.0);

Adx(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Add X axis values

Returns

Curve object or NULL

Return type

Curve

Example

To add X axis values for curves m and n together and store as curve p

p = Operate.Adx(m,n);

To add 20.0 to the X axis values in curve m and store as curve p

p = Operate.Adx(m,20.0);

Asi(X Acceleration[Curve], Y Acceleration[Curve], Z Acceleration[Curve], Acceleration conversion factor[real], X Acceleration Limit[real], Y Acceleration Limit[real], Z Acceleration Limit[real], Calculation method[string], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

Acceleration Severity Index. This value is used to assess the performance of road side crash barriers. The calculation method can be set to 2010 (BS EN 1317-1:2010) or 1998 (BS EN 1317-1:1998).

Returns

Curve object or NULL

Return type

Curve

Example

Calculate ASI using the 2010 method with input curves x,y and z, factors 12,9,10 and a conversioon factor of 9810. Regularise the input curves using an interval of 0.0001 first.

p = Operate.Asi(x,y,z,9810.0,12.0,9.0,10.0,"2010",0.0001);

Asin(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Arc Sine

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Arc Sine() of curve m and store as curve p

p = Operate.Asin(m);

Atan(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Arc Tangent

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Arc Tangent() of curve m and store as curve p

p = Operate.Atan(m);

Atan2(First Input Curve[Curve], Second Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Arc Tangent using atan2(y, x)

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Arc Tangent() of curve m / curve n and store as curve p

p = Operate.Atan2(m, n);

Av(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Convert acceleration spectrum to a velocity spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and store as curve p

p = Operate.Av(m);

Ave(Curves[Array of Curve objects], Output Curve (optional)[Curve]) [static]

Description

Average a group of curves

Returns

Curve object or NULL

Return type

Curve

Example

Average the array of curves stored in curve array x and store as curve p

p = Operate.Ave(x);

Bes(Input Curve[Curve], Frequency[real], Order[integer], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

Bessel Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m using a cut-off of 400Hz and order 2 and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.Bes(m,400.0,2,0.0001);

Blc(Input Curve[Curve]) [static]

Description

Carry out a baseline correction on an accleration time history

Returns

Array of Curve objects.
1st curve : Corrected curve
2nd curve : Integrated Velocity
3rd curve : Integrated Displacement

Return type

Array

Example

Calculate baseline correction on curve m, .

c_array = Operate.Blc(m);
corrected_curve = c_array[0];
vel_curve = c_array[1];
disp_curve = c_array[2];

But(Input Curve[Curve], Frequency[real], Order[integer], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

Butterworth Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m using a cut-off of 400Hz and order 2 and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.But(m,400.0,2,0.0001);

C1000(Input Curve[Curve], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

SAE Class 1000 Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.C1000(m,0.0001);

C180(Input Curve[Curve], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

SAE Class 180 Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.C180(m,0.0001);

C60(Input Curve[Curve], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

SAE Class 60 Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.C60(m,0.0001);

C600(Input Curve[Curve], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

SAE Class 600 Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.C600(m,0.0001);

Cat(First Curve[Curve], Second Curve[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Concatenate 2 curves together

Returns

Curve object or NULL

Return type

Curve

Example

To concatenate the values for curve n to those in curve m and store as curve p

p = Operate.Cat(m,n);

Clip(Input Curve[Curve], X min[real], X max[real], Y min[real], Y max[real], Output Curve (optional)[Curve]) [static]

Description

Clip a curve

Returns

Curve object or NULL

Return type

Curve

Example

Clip a curve m to within 0.1<x<0.3, 0.0<y<100.0 and store as curve p

p = Operate.Clip(m,0.1,0.3,0.0,100.0);

Com(First Curve[Curve], Second Curve[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Combine Y axis values from 2 curves together

Returns

Curve object or NULL

Return type

Curve

Example

To combine the Y axis values for curve n to those in curve m and store as curve p

p = Operate.Com(m,n);

Cor(First Curve[Curve], Second Curve[Curve], Correlation type[string]) [static]

Description

Curve Correlation function. This Correlation function provides a measure of the degree to which two curves match. When comparing curves by eye, the quality of correlation may be judged on the basis of how well matched are the patterns of peaks, the overall shapes of the curves, etc, and can allow for differences of timing as well as magnitude. Thus a simple function based on the difference of Y-values (such as T/HIS ERR function) does not measure correlation in the same way as the human eye. The T/HIS correlation function attempts to include and quantify the more subtle ways in which the correlation of two curves may be judged.
The correlation can be calculated using either a strict or loose set of input parameters.
The degree of correlation is rated between 0 and 100.

Returns

Correlation value

Return type

real

Example

Calculate the correlation between curves m and n using the strict input parameters.

val = Operate.Cor(m,n,"strict");

Cor3(First Curve[Curve], Second Curve[Curve], X axis factor (optional)[real], Y axis factor (optional)[real]) [static]

Description

Curve Correlation function. This function first normalises the curves using two factors either specified by the user or defaults calculated by the program (the maximum absolute X and Y values of both graphs). For each point on the first normalised curve, the shortest distance to the second normalised curve is calculated. The root mean square value of all these distances is subtracted from 1 and then multiplied by 100 to get an index between 0 and 100. The process is repeated along the second curve and the two indices are averaged to get a final index. The higher the index the closer the correlation between the two curves.
Note that the choice of normalising factors is important. Incorrect factors may lead to a correlation index outside the range of 0 to 100

Returns

Correlation value

Return type

real

Example

Calculate the correlation between curves m and n using the default normalising factors.

val = Operate.Cor3(m,n);

Calculate the correlation between curves m and n using 0.1 and 1000.0 as the X and Y normalising factors.

val = Operate.Cor3(m,n,0.1,1000);

Cos(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Cosine

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Cosine() of curve m and store as curve p

p = Operate.Cos(m);

Da(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Convert displacment spectrum to an acceleration spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and store as curve p

p = Operate.Da(m);

Dif(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Differentiate a curve

Returns

Curve object or NULL

Return type

Curve

Example

To differentiate curve m and store as curve p

p = Operate.Dif(m);

Div(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Divide Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

To divide the Y axis values for curve n by curve m and store as curve p

p = Operate.Div(m,n);

To devide the Y axis values in curve m by 20.0 and store as curve p

p = Operate.Div(m,20.0);

Dix(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Divide X axis values

Returns

Curve object or NULL

Return type

Curve

Example

To divide the X axis values for curve n by curve m and store as curve p

p = Operate.Dix(m,n);

To devide the X axis values in curve m by 20.0 and store as curve p

p = Operate.Dix(m,20.0);

Dmg(Head Rotation Velocity X[Curve], Head Rotation Velocity Y[Curve], Head Rotation Velocity Z[Curve], Calculation method[string], X axis interval (optional)[real], Filter Class (optional)[string]) [static]

Description

Damage Criterion DAMAGE Criterion is a brain injury metric which is based on deformation output from a second-order system of equation. DMG requires three input curves: Head Rotation Velocity X, Head Rotation Velocity Y, v. The function returns an array containing 4 curve objects. 1st Curve: Damage Resultant 2nd Curve: Damage X Component 3rd Curve: Damage Y Component 4th Curve: Damage Z Component

Returns

Array of Curve objects. 1st Curve: Damage Resultant 2nd Curve: Damage X Component 3rd Curve: Damage Y Component 4th Curve: Damage Z Component

Return type

Array

Example

Calculate DMG curves p using input head rotataional velocity curves m, n, o using rk4 method

p = Operate.Dmg(m,n,o, 'rk4');

Calculate DMG curves p1 with additional arguments for 0.001 X axis interval and C60 Filter.

p1 = Operate.Dmg(m,n,o,'rk4',0.0001,'C60')

Ds(Input Curve[Curve], Broadening Factor[real], Redefine Frequencies[string], Output Curve (optional)[Curve]) [static]

Description

Generate a design spectrum from a reponse spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and let T-HIS determine the new frequencies, store as curve p

p = Operate.Ds(m,"yes");

Dv(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Convert displacment spectrum to a velocity spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and store as curve p

p = Operate.Dv(m);

Env(Curves[Array of Curve objects], Output Curve (optional)[Curve]) [static]

Description

Generate an Envelope that bounds the min and max values of a group of curves

Returns

Curve object or NULL

Return type

Curve

Example

Envelope of curves stored in curve array x and store as curve p

p = Operate.Env(x);

Err(First Curve[Curve], Second Curve[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Calculate the degree of correlation between 2 curves

Returns

Curve object or NULL

Return type

Curve

Example

To calculate the correlation between curves n and m and store as curve p

p = Operate.Err(m,n);

Exc(Input Curve[Curve], Output option[string], Output Curve (optional)[Curve]) [static]

Description

Calculate and displays an EXCeedence plot. This is a plot of force (Y axis) versus cumulative time (X axis) for which the force level has been exceeded. By default the Automatic option will create an exceedence plot using either the +ve OR the -ve values depending on which the input curve contains most of.
The Positive option will calculate the exceedence plot using only the points with +ve y values.
The Negative option will calculate the exceedence plot using only the points with -ve y values.

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Exceedence plot for curve m, using the positive option and store as curve p

p = Operate.Exc(m,"positive");

Exp(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate E to the power of Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

Calculate E to the power of Y axis values for curve m and store as curve p

p = Operate.Exp(m);

Fft(Input Curve[Curve], Output option[string], X axis interval (optional)[real], Scaling option (optional)[string]) [static]

Description

Fast Fourier Transform

Returns

Curve object/array or NULL

Return type

Curve

Example

Generate magnitude and phase curves and return a curve array. Regularise the input curve using an interval of 0.0001 first and scale using option two.

c_array = Operate.Fft(m,"phase",0.0001,"one");
mag_curve = c_array[0];
phase_curve = c_array[1];

Fir(Input Curve[Curve], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

FIR Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m and output as curve p . Regularise the input curve using an interval of 0.0001 first.

p = Operate.Fir(m,0.0001);

Hic(Input Curve[Curve], Window[real], Acceleration factor[real]) [static]

Description

HIC Calculation. After calculating the HIC value for a curve the value can also be obtained from the curve using the Curve.hic property. In addition to the HIC value the start and end time for the time window can also be obtained using the Curve.hic_tmin and Curve.hic_tmax properties.

Returns

HIC value

Return type

real

Example

Calculate HIC for curve m, using a window of 0.036s and a factor of 9810.

val = Operate.Hic(m,0.036,9810.0);

Hicd(Input Curve[Curve], Window[real], Acceleration factor[real]) [static]

Description

Modified HIC(d) Calculation for free motion headform. After calculating the HIC value for a curve the value can also be obtained from the curve using the Curve.hicd property. In addition to the HIC(d) value the start and end time for the time window can also be obtained using the Curve.hicd_tmin and Curve.hicd_tmax properties.

Returns

HIC(d) value

Return type

real

Example

Calculate HIC(d) for curve m, using a window of 0.036s and a factor of 9810.

val = Operate.Hicd(m,0.036,9810.0);

Ifft(First Curve[Curve], Second Curve[Curve], Input type[string]) [static]

Description

Inverse Fast Fourier Transform

Returns

Curve object or NULL

Return type

Curve

Example

Generate curve from magnitude (m) and phase (p) data and return as curve q.

q = Operate.Ifft(m,p,"magnitude");

Int(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Integrate a curve

Returns

Curve object or NULL

Return type

Curve

Example

To integrate curve m and store as curve p

p = Operate.Int(m);

Log(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Natural Log of Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Natural Log of Y axis values for curve m and store as curve p

p = Operate.Log(m);

Log10(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Log (base 10) of Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Log (base 10) of Y axis values for curve m and store as curve p

p = Operate.Log10(m);

Log10x(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Log (base 10) of X axis values

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Log (base 10) of X axis values for curve m and store as curve p

p = Operate.Log10x(m);

Logx(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Natural Log of X axis values

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Natural Log of X axis values for curve m and store as curve p

p = Operate.Logx(m);

Lsq(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Least Squares Fit for a curve

Returns

Curve object or NULL

Return type

Curve

Example

To calculate Least Squares Fit for curve m and store as curve p

p = Operate.Lsq(m);

Map(First Curve[Curve], Second Curve[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Map Y axis values from one curve onto another curve

Returns

Curve object or NULL

Return type

Curve

Example

To map curve n onto curve m and store as curve p

p = Operate.Map(m,n);

Max(Curves[Array of Curve objects], Output Curve (optional)[Curve]) [static]

Description

Maximum of a group of curves

Returns

Curve object or NULL

Return type

Curve

Example

Maximum of curves stored in curve array x

p = Operate.Max(x);

Min(Curves[Array of Curve objects], Output Curve (optional)[Curve]) [static]

Description

Minimum of a group of curves

Returns

Curve object or NULL

Return type

Curve

Example

Minimum of curves stored in curve array x

p = Operate.Min(x);

Mon(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Sort a curve into monotonically increasing X axis values.

Returns

Curve object or NULL

Return type

Curve

Example

To sort curve m and store as curve p

p = Operate.Mon(m);

Mul(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Multiply Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

To multiply the Y axis values for curve n from m and store as curve p

p = Operate.Mul(m,n);

To multiply the Y axis values in curve m by 20.0 and store as curve p

p = Operate.Mul(m,20.0);

Mux(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Multiply X axis values

Returns

Curve object or NULL

Return type

Curve

Example

To multiply the X axis values for curve n from m and store as curve p

p = Operate.Mux(m,n);

To multiply the X axis values in curve m by 20.0 and store as curve p

p = Operate.Mux(m,20.0);

Ncp(First Curve[Curve], Second Curve[Curve]) [static]

Description

Calculate a platic rotation curve for a beam from a moment/time and rotation/time

Returns

Curve object or NULL

Return type

Curve

Example

Calculate plastic rotation curve p using curves m and r.

q = Operate.Ncp(m,r);

Nij(Shear Force[Curve], Axial Force[Curve], Moment[Curve], Fzc_t[real], Fzc_c[real], Myc_f[real], Myc_e[real], E[real]) [static]

Description

Biomechanical neck injury predictor. Used as a measure of injury due to the load transferred through the occipital condyles.
This function returns an array containing 4 curve objects.
Curve 1 - "Nte" is the tension-extension condition
Curve 2 - "Ntf" is the tension-flexion condition
Curve 3 - "Nce" is the compression-extension condition
Curve 4 - "Ncf" is the compression-flexion condition.

Returns

Array of Curve objects.
1st curve : Nte curve
2nd curve : Ntf curve
3rd curve : Nce curve
4th curve : Ncf curve

Return type

Array

Example

Calculate NIJ curves using input curves x,y,z, and constants Fzc=1.0 (tension) / 2.0 (compression), Myc=3.0 (flexion) / 4.0 (extenstion) and E=0.0.

c_array = Operate.Nij(x,y,z,1.0,2.0,3.0,4.0,0.0);

Nor(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Normalise Y axis values between [-1,1]

Returns

Curve object or NULL

Return type

Curve

Example

Normalise Y axis values of curve m and store as curve p

p = Operate.Nor(m);

Nor2(Input Curve[Curve], Y Min Value[real], Y Max Value[real], Lock to Axis Y Min[integer], Lock to Axis Y Max[integer], Output Curve (optional)[Curve]) [static]

Description

Normalise Y axis values with manual settings. The operation takes the absolute value of the user-specified Y Min and Y Max. It then finds the maximum of these two numbers and divides all Y data by this number. There are two locks which probe or "lock on to" the Y Max and Y Min axis values which offers quick axis-normalizing.

Returns

Curve object or NULL

Return type

Curve

Example

Normalise the Y axis values of curve m taking the absolute maximum between the two values -200 and 100 (which for this example will equate to 200) with the Y Min Lock active and the Y Max Lock Inactive. This is then stored as curve p.

p = Operate.Nor2(m, -200, 100, 1, 0);

Nox(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Normalise X axis values between [-1,1]

Returns

Curve object or NULL

Return type

Curve

Example

Normalise X axis values of curve m and store as curve p

p = Operate.Nox(m);

Nox2(Input Curve[Curve], X Min Value[real], X Max Value[real], Lock to Axis X Min[integer], Lock to Axis X Max[integer], Output Curve (optional)[Curve]) [static]

Description

Normalise X axis values with manual settings. The operation takes the absolute value of the user-specified X Min and X Max. It then finds the maximum of these two numbers and divides all X data by this number. There are two locks which probe or "lock on to" the X Max and X Min axis values which offers quick axis-normalizing.

Returns

Curve object or NULL

Return type

Curve

Example

Normalise the X axis values of curve m taking the absolute maximum between the two values -200 and 100 (which for this example will equate to 200) with the X Min Lock active and the X Max Lock Inactive. This is then stored as curve p.

p = Operate.Nox2(m, -200, 100, 1, 0);

Octave(Input Curve[Curve], Band type to convert to[String], Output Type[String], Input Type[String], Output Curve (optional)[Curve]) [static]

Description

Coverts a narrow band curve to either Octave or 1/Third Octave bands

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m that contains Linear values to 1/3 Octave bands and output RMS in curve p

p = Operate.Octave(m,"third","rms","linear");

Olc(Input Curve[Curve], Second Curve or constant[Curve or real], X axis interval (optional)[real], Filter Class (optional)[string]) [static]

Description

Occupant load Criterion. Used as a parameter to evaluate Euro NCAP MPDB assessment as specified in Technical Bulletin TB 027 v1.1.1, which is intended to be used with the Adult Occupant Protection. The function returns an array containing 5 curve objects. Curve 1 - Velocity of Virtual Occupant Curve 2 - Velocity of the Barrier Model Curve 3 - Displacement of the Barrier Model Curve 4 - Displacement of the Virtual Occupant Curve 5 - Relative Displacement between the two models

Returns

Array of Curve objects. 1st Curve: Velocity of Virtual Occupant 2nd Curve: Velocity of the Barrier Model 3rd Curve: Displacement of the Barrier Model 4th Curve: Displacement of the Virtual Occupant 5th Curve: Relative Displacement between the two models

Return type

Array

Example

Calculate OLC curves p using input acceleration curve m and velocity curve n

p = Operate.Olc(m,n);

Calculate OLC curves p using input acceleration m curve and Initial Velocity Value 13888.0

p = Operate.Olc(m,13888.0);

Calculate OLC curves p1 and p2 with additional arguments for 0.001 X axis interval and C60 Filter.

p1 = Operate.Olc(m,n,0.0001,'C60')

p2 = Operate.Olc(m,13888.0,0.0001,'C60')

Order(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Reverse the order of points in a curve

Returns

Curve object or NULL

Return type

Curve

Example

Reverse the order of points in curve m and store as curve p

p = Operate.Order(m);

Pbut(Input Curve[Curve], Frequency[real], Order[integer], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

Pure Butterworth Filter

Returns

Curve object or NULL

Return type

Curve

Example

Filter curve m using a cut-off of 400Hz and order 2 and output as curve p. Regularise the input curve using an interval of 0.0001 first.

p = Operate.Pbut(m,400.0,2,0.0001);

Power(Input Curve[Curve], Power[real], Output Curve (optional)[Curve]) [static]

Description

Raise to the power

Returns

Curve object or NULL

Return type

Curve

Example

Raise the Y axis values for curve m to the power 2.5 and store as curve p

p = Operate.Power(m,2.5);

Rave(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate rolling average of a curve

Returns

Curve object or NULL

Return type

Curve

Example

Calculate rolling average of curve m and store as curve p

p = Operate.Rave(m);

Rec(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate reciprocal

Returns

Curve object or NULL

Return type

Curve

Example

Calculate receprocal of curve m and store as curve p

p = Operate.Rec(m);

Reg(Input Curve[Curve], X axis interval[real], Output Curve (optional)[Curve]) [static]

Description

Regularise X axis intervals for a curve.

Returns

Curve object or NULL

Return type

Curve

Example

Regularise curve m using a new X axis intreval of 0.0001.

p = Operate.Reg(m,0.0001);

Res(Curves[Array of Curve objects], Output Curve (optional)[Curve]) [static]

Description

Resultant of a group of curves

Returns

Curve object or NULL

Return type

Curve

Example

Resultant of curves stored in curve array x

p = Operate.Res(x);

Rev(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Reverse X and Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

Reverse X and Y axis values of curve m and store as curve p

p = Operate.Rev(m);

Rs(Input Curve[Curve], Damping Factor[real], Sampling Points[int], X axis interval (optional)[real], Output Curve (optional)[Curve]) [static]

Description

Generate a reponse spectrum from input accelerations

Returns

Array of Curve objects
1st curve : Relative displacement
2nd curve : Relative velocity
3th curve : Pseudo relative velocity
4th curve : Absolute acceleration
5th curve : Pseudo absolute acceleration

Return type

Array

Example

Generate a response spectrum using a factor of 0.05 and 70 sampling points. Regularise the input curve using an interval of 0.0001 first.

p = Operate.Rs(m,0.05,70,0.0001);

Sin(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Sine

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Sine() of curve m and store as curve p

p = Operate.Sin(m);

Smooth(Input Curve[Curve], Smoothing Factor[integer], Output Curve (optional)[Curve]) [static]

Description

Apply a smoothing factor to a curve

Returns

Curve object or NULL

Return type

Curve

Example

Smooth curve m using 7 points and store as curve p

p = Operate.Smooth(m,7);

Sqr(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Square root of a curve

Returns

Curve object or NULL

Return type

Curve

Example

Square root curve m and store as curve p

p = Operate.Sqr(m);

Stress(Input Curve[Curve], Convert to[string], Output Curve (optional)[Curve]) [static]

Description

Convert between true and engineering stress

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m from engineering to true strees and store as curve p

p = Operate.Stress(m,"True");

Sub(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Subtract Y axis values

Returns

Curve object or NULL

Return type

Curve

Example

To subtract the Y axis values for curve n from m and store as curve p

p = Operate.Sub(m,n);

To subtract 20.0 from the Y axis values in curve m and store as curve p

p = Operate.Sub(m,20.0);

Sum(Curves[Array of Curve objects], Output Curve (optional)[Curve]) [static]

Description

Sum of a group of curves

Returns

Curve object or NULL

Return type

Curve

Example

Sum of curves stored in curve array x

p = Operate.Sum(x);

Sux(First Curve[Curve], Second Curve or constant[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Subtract X axis values

Returns

Curve object or NULL

Return type

Curve

Example

To subtract the X axis values for curve n from m and store as curve p

p = Operate.Sux(m,n);

To subtract 20.0 from the X axis values in curve m and store as curve p

p = Operate.Sux(m,20.0);

Tan(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Calculate Tangent

Returns

Curve object or NULL

Return type

Curve

Example

Calculate Tangent() of curve m and store as curve p

p = Operate.Tan(m);

Thiv(X Acceleration[Curve], Y Acceleration[Curve], Yaw Rate[Curve], Dx[real], Dy[real], X0[real]) [static]

Description

Theoretical Head Impact Velocity and the Post Impact Head Deceleration. These values are used to assess the performance of road side crash barriers.
This function returns an array containing 2 curve objects. The 1st curve is the THIV curve and the 2nd is the PHD curve. The peak values of these curves are the corresponding THIV and PHD values and can be obtained using the Curve.ymax property.

Returns

Array of Curve objects.
1st curve : THIV curve
2nd curve : PHD curve

Return type

Array

Example

Calculate THIV and PHD curves x,y,z and distances Dx=0.6, Dy=0.3, X0=0.0.

c_array = Operate.Thiv(x,y,z,0.6,0.3,0.0);
thiv = c_array[0].ymax;
phd = c_array[1].ymax;

Ti(Axial Force[Curve], X Moment[Curve], Y Moment[Curve], Fzc[real], Mrc[real], X axis interval (optional)[real], Filter Class (optional)[string], Output Curve (optional)[Curve]) [static]

Description

Tibia Index is an injury criterion for the lower leg area used to predict leg injuries.

Returns

Curve object or NULL

Return type

Curve

Example

Calculate TI Curve t using input curves x,y,z and constants Fzc=35.9 and Mrc=225.0

t = Operate.Ti(x,y,z,35.9,225.0);

Calculate TI curve t with additional arguments 0.0001 for X axis interval and C600 for Filter Class.

t = Operate.Ti(x,y,z,,35.9,225.0,0.0001,'C600')

Tms(Input Curve[Curve], Period[real]) [static]

Description

3ms Clip Calculation. After calculating the 3ms clip value for a curve the value can also be obtained from the curve using the Curve.tms property. In addition to the 3ms clip value the start and end time for the time window can also be obtained using the Curve.tms_tmin and Curve.tms_tmax properties.

Returns

3ms clip value

Return type

real

Example

Calculate 3ms clip for curve m, using a clip period of 0.003s.

val = Operate.Tms(m,0.003);

Translate(Input Curve[Curve], X value[real], Y value[real], Output Curve (optional)[Curve]) [static]

Description

Translate a curve

Returns

Curve object or NULL

Return type

Curve

Example

Translate curve m by x=0.2, y=0.3 and store as curve p

p = Operate.Translate(m,0.2,0.3);

Tti(Upper Rib Acceleration[Curve], Lower Rib Acceleration[Curve], T12 Acceleration[Curve]) [static]

Description

Thorax Trauma Index.

Returns

TTI value

Return type

real

Example

Calculate TTI using curves x,y and z as inputs.

val = Operate.TTi(x,y,z);

Va(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Convert velocity spectrum to an acceleration spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and store as curve p

p = Operate.Va(m);

Vc(Input Curve[Curve], A[real], B[real], Calculation method[string], Output Curve (optional)[Curve]) [static]

Description

Viscous Criteria calculate. The VC calculation can be done using 2 different calculation methods ECER95 and IIHS.

Returns

Curve object or NULL

Return type

Curve

Example

Calculate VC for curve m, using A=1.3, B=0.229 and the ECER95 method

p = Operate.Vc(m,1.3,0.229,"ECER95");

Vd(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Convert velocity spectrum to a displacment spectrum

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m and store as curve p

p = Operate.Vd(m);

Vec(First Curve[Curve], Second Curve[Curve or real], Third Curve[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Vector magnitude of 3 curves

Returns

Curve object or NULL

Return type

Curve

Example

Calculate vector magnitude of curves m,n,o and store as curve p

p = Operate.Vec(m,n,o);

Vec2d(First Curve[Curve], Second Curve[Curve or real], Output Curve (optional)[Curve]) [static]

Description

Vector magnitude of 2 curves

Returns

Curve object or NULL

Return type

Curve

Example

Calculate vector magnitude of curves m and n and store as curve p

p = Operate.Vec2d(m,n);

Wif(First Curve[Curve], Second Curve[Curve]) [static]

Description

Weigthed Integrated Factor (WIFAC) Correlation function.

Returns

Correlation value

Return type

real

Example

Calculate the correlation between curves m and n.

val = Operate.Wif(m,n);

Window(Input Curve[Curve], Window Type[string], percentage lead in (optional)[real], Output Curve (optional)[Curve]) [static]

Description

Apply a smoothing window to a curve

Returns

Curve object or NULL

Return type

Curve

Example

Apply a hanning window to curve m and store as curve p

p = Operate.Window(m,"Hanning");

Zero(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Translate curve to 0,0

Returns

Curve object or NULL

Return type

Curve

Example

Translate curve m to (0,0) and store as curve p

p = Operate.Zero(m);

ZeroX(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Translate curve to X=0.0

Returns

Curve object or NULL

Return type

Curve

Example

Translate curve m to X=0 and store as curve p

p = Operate.ZeroX(m);

ZeroY(Input Curve[Curve], Output Curve (optional)[Curve]) [static]

Description

Translate curve to Y=0.0

Returns

Curve object or NULL

Return type

Curve

Example

Translate curve m to Y=0 and store as curve p

p = Operate.ZeroY(m);

dB(Input Curve[Curve], Reference Value[real], Output Curve (optional)[Curve]) [static]

Description

Converts a curve to dB (y = 20.0*log(y/yref))

Returns

Curve object or NULL

Return type

Curve

Example

Convert curve m to dB's using a reference value of 10.0 and store as curve p

p = Operate.dB(m,10.0);

dBA(Input Curve[Curve], Weighting Type[String], Output Curve (optional)[Curve]) [static]

Description

Applies A-weighting to a curve (convert from dB to dBA)

Returns

Curve object or NULL

Return type

Curve

Example

Apply narrow band A-weighting to convert curve m from dB to dBA and store as curve p

p = Operate.dBA(m,"narrow");