All Implemented Interfaces:

JxnCloneableAlgebra
```
public class JxnRealArrayAlgebra
extends Object
implements JxnCloneableAlgebra
```
Implementation of an algebra based on an internal array double[] value. Most of the methods perform element-wise operations on the array elements. Supports mixed operations with double and JxnComplexAlgebra.

Call one of the plot methods to visualize the array values as a curve in a PlotFrame.

Use class JxnRealArrayTextFileDataSource to read data values from text files.

Field Summary

Fields
Modifier and Type	Field	Description
`protected static double`	`equalityTolerance`	Tolerance for `equals` method.
`protected static boolean`	`ignoreSurplus`	See `setIgnoreSurplus(boolean)`.
`double[]`	`value`	Internal storage.

Constructor Summary

Constructors
Modifier	Constructor	Description
`protected`	`JxnRealArrayAlgebra()`
	`JxnRealArrayAlgebra(double[] value)`	Creates a `JxnRealArrayAlgebra` instance from the array `value`.
	`JxnRealArrayAlgebra(double[] value, boolean copyInput)`	Creates a `JxnRealArrayAlgebra` instance from the array `double [] value`.
	`JxnRealArrayAlgebra(double start, double end, double step)`	Creates an instance from the given parameters.
	`JxnRealArrayAlgebra(double start, double step, int length)`	Creates an instance from the given parameters.
	`JxnRealArrayAlgebra(double uvmin, double uvStep, int nuvSteps, int nvuSteps, int ni)`	Deprecated. replaced by class `JxnUVGrid`.
`protected`	`JxnRealArrayAlgebra(int length)`
	`JxnRealArrayAlgebra(int[] value)`	Creates a `JxnRealArrayAlgebra` instance from the array `int[] value`.
	`JxnRealArrayAlgebra(JxnRealArrayAlgebra ra)`	Creates a copy of `ra`.
	`JxnRealArrayAlgebra(JxnRealArrayAlgebra ra, boolean transfer)`	Creates a copy of `ra`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`static JxnRealArrayAlgebra`	`abs(JxnRealArrayAlgebra ra)`	Calls `Math.abs(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`abs(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `Math.hypot(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`static JxnRealArrayAlgebra`	`acos(JxnRealArrayAlgebra ra)`	Calls `Math.acos(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`acosD(JxnRealArrayAlgebra ra)`	Calls `Math.acos(double)` and converts the result from radians to degrees for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`acosh(JxnRealArrayAlgebra ra)`	Calls `JxnUtilities.acosh(double)` for each element of the internal array of `ra`.
`JxnRealArrayAlgebra`	`add(double d)`	Adds `d` to this.
`static JxnRealArrayAlgebra`	`add(double d, JxnRealArrayAlgebra ra)`	Returns `d + ra`.
`JxnComplexArrayAlgebra`	`add(JxnComplexAlgebra cx)`	Adds `cx` to this.
`JxnRealArrayAlgebra`	`add(JxnRealArrayAlgebra ra)`	Adds `ra` to this.
`static JxnRealArrayAlgebra`	`asin(JxnRealArrayAlgebra ra)`	Calls `Math.asin(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`asinD(JxnRealArrayAlgebra ra)`	Calls `Math.asin(double)` and converts the result from radians to degrees for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`asinh(JxnRealArrayAlgebra ra)`	Calls `JxnUtilities.asinh(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`atan(JxnRealArrayAlgebra ra)`	Calls `Math.atan(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`atan2(JxnRealArrayAlgebra y, JxnRealArrayAlgebra x)`	Calls `Math.atan2(y`_i`,x`_i`)` for each pair of elements of the internal arrays of `y` and `x`.
`static JxnRealArrayAlgebra`	`atan2D(JxnRealArrayAlgebra y, JxnRealArrayAlgebra x)`	Calls `Math.atan2(y`_i`,x`_i`)` and converts the result from radians to degrees for each pair of elements of the internal arrays of `y` and `x`.
`static JxnRealArrayAlgebra`	`atanD(JxnRealArrayAlgebra ra)`	Calls `Math.atan(double)` and converts the result from radians to degrees for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`atanh(JxnRealArrayAlgebra ra)`	Calls `JxnUtilities.atanh(double)` for each element of the internal array of `ra`.
`JxnRealArrayAlgebra`	`by(int[] index)`	Same as `byIndex(int[])`.
`JxnRealArrayAlgebra`	`byIndex(int[] index)`	Returns a new `JxnRealArrayAlgebra` containing the values of this instance at the positions given in `index`.
`static JxnRealArrayAlgebra`	`cbrt(JxnRealArrayAlgebra ra)`	Calls `Math.cbrt(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`ceil(JxnRealArrayAlgebra ra)`	Calls `Math.ceil(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`clip(JxnRealArrayAlgebra ra, double lower, double upper)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` limitted to `lower` and `upper`.
`static JxnRealArrayAlgebra`	`clip(JxnRealArrayAlgebra ra, int[] iClip)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` with elements with indices given in `iClip` replaced by `Double.NaN` (to clip single values by index `i` use `ra.set( i, Double.NaN )` or `raNew =` `set( raOld, i, Double.NaN )` ).
`static JxnRealArrayAlgebra`	`clip(JxnRealArrayAlgebra ra1, JxnRealArrayAlgebra ra2)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra1` with elements replaced by `Double.NaN` if the respective element in `ra2` is invalid (NaN or Infinity).
`static JxnRealArrayAlgebra`	`clipGE(JxnRealArrayAlgebra ra, double maxValue)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` with elements `value[i] >= maxValue` replaced by `Double.NaN`.
`static JxnRealArrayAlgebra`	`clipGT(JxnRealArrayAlgebra ra, double maxValue)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` with elements `value[i] > maxValue` replaced by `Double.NaN`.
`static JxnRealArrayAlgebra`	`clipLE(JxnRealArrayAlgebra ra, double minValue)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` with elements `value[i] <= minValue` replaced by `Double.NaN`.
`static JxnRealArrayAlgebra`	`clipLT(JxnRealArrayAlgebra ra, double minValue)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` with elements `value[i] < minValue` replaced by `Double.NaN`.
`JxnCloneableAlgebra`	`cloneThis()`	Called internally.
`static JxnRealArrayAlgebra`	`concat(JxnRealArrayAlgebra ra1, JxnRealArrayAlgebra ra2)`	Returns a new `JxnRealArrayAlgebra` which is the concatenation of the elements of `ra1` followed by `ra2`.
`static JxnRealArrayAlgebra`	`convolution(JxnRealArrayAlgebra ra, JxnRealArrayAlgebra filter)`	Returns `convolution( ra, filter, 1 )`.
`static JxnRealArrayAlgebra`	`convolution(JxnRealArrayAlgebra ra, JxnRealArrayAlgebra filter, int mode)`	Returns the convolution of `ra` with `filter`.
`static JxnRealArrayAlgebra`	`copySign(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `Math.copySign(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`static double`	`corXY(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry)`	Returns the correlation coefficient of `rx` and `ry`.
`static JxnRealArrayAlgebra`	`cos(JxnRealArrayAlgebra ra)`	Calls `Math.cos(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`cosD(JxnRealArrayAlgebra ra)`	Calls `Math.cos(double)` for each element of the internal array of `ra` after converting the argument from degrees to radians.
`static JxnRealArrayAlgebra`	`cosh(JxnRealArrayAlgebra ra)`	Calls `Math.cosh(double)` for each element of the internal array of `ra`.
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra ry, Color color)`	Returns a curve representation of `ry` ( x_i = i, y_i = ry.value[i] ).
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra ry, Color color, int lineType)`	See `curve`.
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color)`	Returns a curve representation of `rx` and `ry` ( x_i = rx.value[i], y_i = ry.value[i] ).
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, int lineType)`	See `curve`.
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, JxnRealArrayAlgebra rz, IKmg3DProjection p3d)`	Deprecated. Use `plot( p3d ).add( rx, ry, rz )`.
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, JxnRealArrayAlgebra rz, IKmg3DProjection p3d, Color color)`	Deprecated. Use `plot( p3d ).add( rx, ry, rz, color )`.
`static JxnRealArrayCurve`	`curve(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, JxnRealArrayAlgebra rz, IKmg3DProjection p3d, Color color, int lineType)`	Only used for anaglyph stereo.
`static int[]`	`cut(JxnRealArrayAlgebra ra)`	Returns an int array of the indices `i` of values of `ra` with: `value[i] > 0.`.
`static int[]`	`cut(JxnRealArrayAlgebra ra, double min, double max)`	Returns an int array of the indices `i` of values of `ra` with: `min <= value[i] <= max`.
`static int[]`	`cut(JxnRealArrayAlgebra ra, int[] index)`	Analyzes the values of `ra` only with indices given in array `index` and returns an int array of the indices `i` of values with: `value[i] > 0.`.
`static JxnRealArrayAlgebra`	`derivative(JxnRealArrayAlgebra y)`	Returns `derivative( y, 1. )`.
`static JxnRealArrayAlgebra`	`derivative(JxnRealArrayAlgebra y, double dt)`	Returns the derivative `dy/dt` for equidistant step size `dt`.
`static JxnRealArrayAlgebra`	`derivative(JxnRealArrayAlgebra y, JxnRealArrayAlgebra t)`	Returns the derivative `dy/dt` for the elements of the internal arrays of `y` and `t`.
`JxnRealArrayAlgebra`	`div(double d)`	Divides this by `d`.
`static JxnRealArrayAlgebra`	`div(double d, JxnRealArrayAlgebra ra)`	Returns `d / ra`.
`JxnComplexArrayAlgebra`	`div(JxnComplexAlgebra cx)`	Divides this by `cx`.
`JxnRealArrayAlgebra`	`div(JxnRealArrayAlgebra ra)`	Divides this by `ra`.
`static JxnRealArrayAlgebra`	`energy(JxnRealArrayAlgebra p, double h)`	Returns the integral of a power curve (with e.g.
`boolean`	`equals(Object other)`	`JxnRealArrayAlgebra` objects are equal, if all corresponding array elements are equal.
`static JxnRealArrayAlgebra`	`exp(JxnRealArrayAlgebra ra)`	Calls `Math.exp(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`expm1(JxnRealArrayAlgebra ra)`	Calls `Math.expm1(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`faltung(JxnRealArrayAlgebra ra, JxnRealArrayAlgebra filter)`	Deprecated. replaced by `convolution(JxnRealArrayAlgebra, JxnRealArrayAlgebra)`.
`static JxnRealArrayAlgebra`	`faltung(JxnRealArrayAlgebra ra, JxnRealArrayAlgebra filter, int iRand)`	Deprecated. replaced by `convolution(JxnRealArrayAlgebra, JxnRealArrayAlgebra, int)`.
`double[]`	`findValue(double value)`	Finds `value` in the internal array.
`static double[]`	`findValue(JxnRealArrayAlgebra ra, double value)`	Same as `ra.findValue(double value)`.
`static JxnRealArrayAlgebra`	`floor(JxnRealArrayAlgebra ra)`	Calls `Math.floor(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`gaussFilter(JxnRealArrayAlgebra t, double bandWidth)`	Returns `gaussFilter( t, bandWidth, 3. )`.
`static JxnRealArrayAlgebra`	`gaussFilter(JxnRealArrayAlgebra t, double bandWidth, double filterWidth)`	Creates a gaussFilter for `convolution`.
`double`	`get(double x)`	Returns a value for position `x` by linear interpolation between the adjacent elements of the internal array of this `JxnRealArrayAlgebra`.
`double[]`	`get(double[] da)`	Returns an array of values at the positions given in `da` by linear interpolation between the adjacent elements of the internal array of this `JxnRealArrayAlgebra` using `get(double x)`.
`double`	`get(int i)`	Returns the value of the `i`-th element of the internal array of this `JxnRealArrayAlgebra`.
`double[]`	`get(int[] ia)`	Returns an array of the values of the elements of the internal array of this `JxnRealArrayAlgebra` defined by the indices given in `ia`.
`JxnRealArrayAlgebra`	`get(JxnRealArrayAlgebra ra)`	Returns a `JxnRealArrayAlgebra` of values at the positions given in `ra` by linear interpolation between the adjacent elements of the internal array of this `JxnRealArrayAlgebra` using `get(double[])`.
`static JxnRealArrayAlgebra`	`getCalendarField(JxnRealArrayAlgebra ra, int field)`	Returns the result of `gc.get( field )` with `gc = new` `GregorianCalendar()` for the values of the internal array of `ra` interpreted as decimal seconds since 01-Jan-1970 00:00:00 UTC.
`static int`	`getCntInvalid(JxnRealArrayAlgebra ra)`	Returns the number of invalid (`NaN` or `Infinitive`) values in `ra`.
`static int`	`getCntNaN(JxnRealArrayAlgebra ra)`	Returns the number of `NaN` values in `ra`.
`static int`	`getCntValid(JxnRealArrayAlgebra ra)`	Returns the number of valid (neither `NaN` nor `Infinitive`) values in `ra`.
`static JxnRealArrayAlgebra`	`getDayOfWeek(JxnRealArrayAlgebra ra)`	Returns the day of week ( Mo: 1, ...
`static double`	`getEqualityTolerance()`	Returns the tolerance used for the `equals` method.
`static boolean`	`getIgnoreSurplus()`	Returns `ignoreSurplus`.
`double[]`	`getValue()`	Returns a reference to the internal array of this `JxnRealArrayAlgebra`.
`double`	`getValue(double x)`	Returns `get(x)`.
`double[]`	`getValue(double[] da)`	Returns `get(da)`.
`double`	`getValue(int i)`	Deprecated. Use `get(i)`.
`static double`	`getValue(JxnRealArrayAlgebra ra, double x)`	Returns `ra.get(x)`.
`static double[]`	`getValue(JxnRealArrayAlgebra ra, double[] da)`	Returns `ra.get(da)`.
`static double`	`getValue(JxnRealArrayAlgebra ra, int i)`	Returns the value of the `i`-th element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`hypot(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `Math.hypot(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`static JxnRealArrayAlgebra`	`IEEEremainder(double d, JxnRealArrayAlgebra y)`	Calls `Math.IEEEremainder(d,y`_i`)` for each element of the internal array of `y`.
`static JxnRealArrayAlgebra`	`IEEEremainder(JxnRealArrayAlgebra x, double d)`	Calls `Math.IEEEremainder(x`_i`,d)` for each element of the internal array of `x`.
`static JxnRealArrayAlgebra`	`IEEEremainder(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `Math.IEEEremainder(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`static JxnRealArrayAlgebra`	`integral(JxnRealArrayAlgebra y)`	Returns `integral( y, 1. )`.
`static JxnRealArrayAlgebra`	`integral(JxnRealArrayAlgebra y, double dt)`	Returns the integral ∫ `y dt` for equidistant step size `dt`.
`static JxnRealArrayAlgebra`	`integral(JxnRealArrayAlgebra y, JxnRealArrayAlgebra t)`	Returns the integral ∫ `y dt` for the elements of the internal arrays of `y` and `t`.
`JxnRealArrayAlgebra`	`inv()`	Replaces this by its reciprocal.
`static int[]`	`invalid(JxnRealArrayAlgebra ra)`	Returns an int array of the indices of values of `ra` with invalid (`NaN` or `Infinitive`) values.
`static double`	`korXY(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry)`	Returns `corXY( rx, ry )`.
`static int`	`length(JxnRealArrayAlgebra ra)`	Returns the length of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`limit(JxnRealArrayAlgebra ra, double lower, double upper)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` limitted to `lower` and `upper`.
`static JxnRealArrayAlgebra`	`log(double b, JxnRealArrayAlgebra ra)`	Determines the base `b` logarithm of each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`log(JxnRealArrayAlgebra ra)`	Calls `Math.log(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`log10(JxnRealArrayAlgebra ra)`	Calls `Math.log10(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`log1p(JxnRealArrayAlgebra ra)`	Calls `Math.log1p(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`max(double d, JxnRealArrayAlgebra y)`	Deprecated. Use `max( y, d )`.
`static JxnRealArrayAlgebra`	`max(JxnRealArrayAlgebra x, double d)`	Calls `Math.max(x`_i`,d)` for each element of the internal array of `x`.
`static JxnRealArrayAlgebra`	`max(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `Math.max(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`static int`	`maxIndex(JxnRealArrayAlgebra ra)`	Returns the index of the (first) maximum value (including +Infinity) of the internal array of `ra`.
`static double`	`maxValid(JxnRealArrayAlgebra ra)`	Returns the minimum value excluding +Infinity of the internal array of `ra`.
`static double`	`maxValue(JxnRealArrayAlgebra ra)`	Returns the maximum value (including +Infinity) of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`min(double d, JxnRealArrayAlgebra y)`	Deprecated. Use `min( y, d )`.
`static JxnRealArrayAlgebra`	`min(JxnRealArrayAlgebra x, double d)`	Calls `Math.min(x`_i`,d)` for each element of the internal array of `x`.
`static JxnRealArrayAlgebra`	`min(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `Math.min(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`static int`	`minIndex(JxnRealArrayAlgebra ra)`	Returns the index of the (first) minimum value (including -Infinity) of the internal array of `ra`.
`static double`	`minValid(JxnRealArrayAlgebra ra)`	Returns the minimum value excluding -Infinity of the internal array of `ra`.
`static double`	`minValue(JxnRealArrayAlgebra ra)`	Returns the minimum value (including -Infinity) of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`modulo(double d, JxnRealArrayAlgebra y)`	Calls `JxnUtilities.modulo(d,y`_i`)` for each element of the internal array of `y`.
`static JxnRealArrayAlgebra`	`modulo(JxnRealArrayAlgebra x, double d)`	Calls `JxnUtilities.modulo(x`_i`,d)` for each element of the internal array of `x`.
`static JxnRealArrayAlgebra`	`modulo(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)`	Calls `JxnUtilities.modulo(x`_i`,y`_i`)` for each pair of elements of the internal arrays of `x` and `y`.
`JxnRealArrayAlgebra`	`mul(boolean sw)`	Deprecated. ...
`static JxnRealArrayAlgebra`	`mul(boolean sw, JxnRealArrayAlgebra z)`	Deprecated. ...
`JxnRealArrayAlgebra`	`mul(double d)`	(Post)Multiplies this by `d`.
`static JxnRealArrayAlgebra`	`mul(double d, JxnRealArrayAlgebra ra)`	Returns `d * ra`.
`JxnComplexArrayAlgebra`	`mul(JxnComplexAlgebra cx)`	(Post)Multiplies this by `cx`.
`JxnRealArrayAlgebra`	`mul(JxnRealArrayAlgebra ra)`	(Post)Multiplies this by `ra`.
`JxnRealArrayAlgebra`	`mulL(double d)`	(Pre)Multiplies this by `d`.
`static JxnRealArrayAlgebra`	`noise(int n)`	Returns a new `JxnRealArrayAlgebra` with `n` random numbers from `rnd.nextGaussian()` with `rnd = new` `Random()`.
`static JxnRealArrayAlgebra`	`noise(int n, long seed)`	Returns a new `JxnRealArrayAlgebra` with `n` random numbers from `rnd.nextGaussian()` with `rnd = new` `Random(seed)`.
`static JxnRealArrayAlgebra`	`noise(JxnRealArrayAlgebra ra)`	Returns `noise(int n)` with `n = ra.size()`.
`static JxnRealArrayAlgebra`	`noise(JxnRealArrayAlgebra ra, long seed)`	Returns `noise(int n, long seed)` with `n = ra.size()`.
`static JxnRealArrayAlgebra`	`nonWindupStore(JxnRealArrayAlgebra p, double h, double initial, double lower, double upper)`	Returns the integral internally limited to `lower` and `upper` (non windup limiter) of a power curve.
`static JxnRealArrayAlgebra`	`peak(JxnRealArrayAlgebra p, double h)`	Determines the peak energy from a power curve `p`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra ry)`	Creates a new `JxnRealArrayPlotFrame` and visualizes the values of `ry` as a curve: x_i = i, y_i = ry.value[i], i = 0 ... y.length - 1.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra ry, double ymin, double ymax)`	Deprecated. Use `plot( ry ).setYBounds( ymin, ymax )`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra ry, Color color, int lineType)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry)`	Creates a new `JxnRealArrayPlotFrame` and visualizes the values of `rx` and `ry` as a curve: x_i = rx.value[i], y_i = ry.value[i], i = 0 ... min( length(rx), length(ry) ) - 1.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, double vyx)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, double ymin, double ymax)`	Deprecated. Use `plot( rx, ry ).setYBounds( ymin, ymax )`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, int logScales)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, float lineWidth)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, int lineType)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, int lineType, double vyx)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, int lineType, float lineWidth, double vyx)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, int lineType, float lineWidth, int logScales)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, int lineType, int logScales)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, Stroke stroke)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, Stroke stroke, double vyx)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, Color color, Stroke stroke, int logScales)`	See `plot`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry1, JxnRealArrayAlgebra ry2)`	`plot` 2 curves: `ry1`: red, `ry2`: blue.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry1, JxnRealArrayAlgebra ry2, double ymin, double ymax)`	Deprecated. Use `plot( rx, ry1, ry2 ).setYBounds( ymin, ymax )`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry, JxnRealArrayAlgebra rz, IKmg3DProjection p3d)`	Deprecated. Use `plot( p3d ).add( rx, ry, rz )`.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry1, JxnRealArrayAlgebra ry2, JxnRealArrayAlgebra ry3)`	`plot` 3 curves: `ry1`: red, `ry2`: blue, `ry3`: green.
`static JxnRealArrayPlotFrame`	`plot(JxnRealArrayAlgebra rx, JxnRealArrayAlgebra ry1, JxnRealArrayAlgebra ry2, JxnRealArrayAlgebra ry3, double ymin, double ymax)`	Deprecated. Use `plot( rx, ry1, ry2, ry3 ).setYBounds( ymin, ymax )`.
`JxnRealArrayAlgebra`	`pow(double exponent)`	Replaces this by its power of `exponent`.
`static JxnRealArrayAlgebra`	`pow(double d, JxnRealArrayAlgebra exponent)`	Returns `d` to the power of `exponent`.
`JxnRealArrayAlgebra`	`pow(JxnRealArrayAlgebra exponent)`	Replaces this by its power of `exponent`.
`static double`	`quadsum(JxnRealArrayAlgebra ra)`	Returns the sum of the squares of all elements of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`random(int n)`	Returns a new `JxnRealArrayAlgebra` with `n` random numbers from `Math.random()`.
`static JxnRealArrayAlgebra`	`random(int n, long seed)`	Returns a new `JxnRealArrayAlgebra` with `n` random numbers from `rnd.nextDouble()` with `rnd = new` `Random(seed)`.
`static JxnRealArrayAlgebra`	`random(JxnRealArrayAlgebra ra)`	Returns `random(int n)` with `n = ra.size()`.
`static JxnRealArrayAlgebra`	`random(JxnRealArrayAlgebra ra, long seed)`	Returns `random(int n, long seed)` with `n = ra.size()`.
`JxnRealArrayAlgebra`	`range()`	Calls `range(int, int)` reusing `iStart` and `iEnd` from the most recent call.
`JxnRealArrayAlgebra`	`range(double start)`	Calls `range(int)` with `start` rounded to int.
`JxnRealArrayAlgebra`	`range(double start, double end)`	Calls `range(int, int)` with `start` and `end` rounded to int.
`JxnRealArrayAlgebra`	`range(int iStart)`	Returns a new `JxnRealArrayAlgebra` containing `length(ra)-iStart` values starting from index `iStart`.
`JxnRealArrayAlgebra`	`range(int iStart, int iEnd)`	Returns a new `JxnRealArrayAlgebra` containing `iEnd-iStart` values starting from index `iStart` to index `iEnd` (excluding).
`JxnRealArrayAlgebra`	`range(String start)`	Returns a new `JxnRealArrayAlgebra` containing the values of this starting from `start` given as date time string.
`JxnRealArrayAlgebra`	`range(String start, String end)`	Returns a new `JxnRealArrayAlgebra` containing the values of this starting from `start` to `end` given as date time string.
`JxnRealArrayAlgebra`	`range(JxnRealArrayAlgebra ra)`	Deprecated. No more supported.
`JxnRealArrayAlgebra`	`remainder(double d)`	Replaces this by `this % d`.
`static JxnRealArrayAlgebra`	`remainder(double d, JxnRealArrayAlgebra ra)`	Returns `d % ra`.
`JxnRealArrayAlgebra`	`remainder(JxnRealArrayAlgebra ra)`	Replaces this by `this % ra`.
`static JxnRealArrayAlgebra`	`reverse(JxnRealArrayAlgebra ra)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` in reversed order.
`static JxnRealArrayAlgebra`	`rint(JxnRealArrayAlgebra ra)`	Calls `Math.rint(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`round(JxnRealArrayAlgebra ra)`	Commercial rounding of each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`scalb(JxnRealArrayAlgebra ra, int scaleFactor)`	Calls `Math.scalb(double, int)` for each element of the internal array of `ra`.
`JxnRealArrayAlgebra`	`set(int i, double vi)`	Replaces the `i`-th value of this `JxnRealArrayAlgebra` by `vi`.
`static JxnRealArrayAlgebra`	`set(JxnRealArrayAlgebra ra, int i, double vi)`	Returns a copy of `ra`, with the `i`-th value replaced by `vi`.
`JxnRealArrayAlgebra`	`setDateTimeValue(boolean isDateTime)`	Indicates that this instance represents date time values.
`static double`	`setEqualityTolerance(double eps)`	Sets tolerance for the `equals` method for all instances of this class.
`static boolean`	`setIgnoreSurplus(boolean ignore)`	Controls if to ignore surplus elements of the longer internal array for methods which expect two instances with equal length internal arrays.
`JxnRealArrayAlgebra`	`setName(String name)`	Sets a name for this instance (status experimental).
`static boolean`	`setNamedResultEnabled(boolean enabled)`	Enables the use of name for `JxnRealArrayAlgebra` instances (status experimental).
`JxnRealArrayAlgebra`	`setTimeFormat(boolean isDateTime)`	Deprecated. replaced by `setDateTimeValue(boolean)`.
`double`	`setValue(double vi, int i)`	Deprecated. replaced by `setValue( i, vi )`.
`double`	`setValue(int i, double vi)`	Replaces the `i`-th value of this `JxnRealArrayAlgebra` by `vi`.
`static JxnRealArrayAlgebra`	`setValue(JxnRealArrayAlgebra ra, double vi, int i)`	Deprecated. Use `set( ra, i, vi )`.
`JxnRealArrayAlgebra`	`shift(int k)`	Returns a new `JxnRealArrayAlgebra` containing the values of this circularly shifted by `k`.
`static JxnRealArrayAlgebra`	`shift(JxnRealArrayAlgebra ra, int k)`	Returns a new `JxnRealArrayAlgebra` containing the values of this shifted by `k` filling with `0.`.
`static JxnRealArrayAlgebra`	`shift(JxnRealArrayAlgebra ra, int k, double d)`	Returns a new `JxnRealArrayAlgebra` containing the values of this shifted by `k` filling with `d`.
`static JxnRealArrayAlgebra`	`sign(JxnRealArrayAlgebra ra)`	Returns a new `JxnRealArrayAlgebra` containing the sign of each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`signum(JxnRealArrayAlgebra ra)`	Calls `Math.signum(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`sin(JxnRealArrayAlgebra ra)`	Calls `Math.sin(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`sinD(JxnRealArrayAlgebra ra)`	Calls `Math.sin(double)` for each element of the internal array of `ra` after converting the argument from degrees to radians.
`static JxnRealArrayAlgebra`	`sinh(JxnRealArrayAlgebra ra)`	Calls `Math.sinh(double)` for each element of the internal array of `ra`.
`int`	`size()`	Returns the length of the internal array.
`static JxnRealArrayAlgebra`	`smoothExp(JxnRealArrayAlgebra x, double alpha)`	Returns the result `y` of an exponential smoothing of `x`.
`static JxnRealArrayAlgebra`	`sort(JxnRealArrayAlgebra ra)`	Returns a new `JxnRealArrayAlgebra` containing the elements of the internal array of `ra` sorted in ascending order.
`static int[]`	`sortIndex(JxnRealArrayAlgebra ra)`	Returns an array of the indices of the values of `ra` in ascending order.
`static JxnRealArrayAlgebra`	`sqrt(JxnRealArrayAlgebra ra)`	Calls `Math.sqrt(double)` for each element of the internal array of `ra`.
`JxnRealArrayAlgebra`	`sub(double d)`	Subtracts `d` from this.
`static JxnRealArrayAlgebra`	`sub(double d, JxnRealArrayAlgebra ra)`	Returns `d - ra`.
`JxnComplexArrayAlgebra`	`sub(JxnComplexAlgebra cx)`	Subtracts `cx` from this.
`JxnRealArrayAlgebra`	`sub(JxnRealArrayAlgebra ra)`	Subtracts `ra` from this.
`static double`	`summe(JxnRealArrayAlgebra ra)`	Returns `total( ra )`.
`static JxnRealArrayAlgebra`	`sw(JxnRealArrayAlgebra ra, double lower, double upper)`	Deprecated. replaced by `clip(JxnRealArrayAlgebra, double, double)`.
`static JxnRealArrayAlgebra`	`sw(JxnRealArrayAlgebra x, double lower, double upper, JxnRealArrayAlgebra yLower, JxnRealArrayAlgebra yInner, JxnRealArrayAlgebra yUpper)`	Returns values of `yLower`, `yInner` or `yUpper` depending on the value of `x`.
`static JxnRealArrayAlgebra`	`sw(JxnRealArrayAlgebra x, JxnRealArrayAlgebra yLT, JxnRealArrayAlgebra yGE)`	Returns values of `yLT` or `yGE` depending on the value of `x`.
`static JxnRealArrayAlgebra`	`sw(JxnRealArrayAlgebra x, JxnRealArrayAlgebra yLT, JxnRealArrayAlgebra yEQ, JxnRealArrayAlgebra yGT, double eps)`	Returns values of `yLT`, `yEQ` or `yGT` depending on the value of `x`.
`static JxnRealArrayAlgebra`	`tan(JxnRealArrayAlgebra ra)`	Calls `Math.tan(double)` for each element of the internal array of `ra`.
`static JxnRealArrayAlgebra`	`tanD(JxnRealArrayAlgebra ra)`	Calls `Math.tan(double)` for each element of the internal array of `ra` after converting the argument from degrees to radians.
`static JxnRealArrayAlgebra`	`tanh(JxnRealArrayAlgebra ra)`	Calls `Math.tanh(double)` for each element of the internal array of `ra`.
`double[]`	`toArray()`	Returns a copy of the internal array of this `JxnRealArrayAlgebra`.
`String`	`toString()`	Formats instance.
`static double`	`total(JxnRealArrayAlgebra ra)`	Returns the sum of all elements of the internal array of `ra`.
`static int[]`	`valid(JxnRealArrayAlgebra ra)`	Returns an int array of the indices of values of `ra` with valid (neither `NaN` nor `Infinitive`) values.
`double`	`valueAt(int i)`	Deprecated. Use `get(i)`.
`static double`	`valueAt(JxnRealArrayAlgebra ra, int i)`	Deprecated. Use `getValue( ra, i )`.

Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail
- value
```
public double[] value
```
  Internal storage.
- equalityTolerance
```
protected static double equalityTolerance
```
  Tolerance for equals method.
  
  See Also:
  
  setEqualityTolerance(double)
- ignoreSurplus
```
protected static boolean ignoreSurplus
```
  See setIgnoreSurplus(boolean).

Constructor Detail

JxnRealArrayAlgebra
```
protected JxnRealArrayAlgebra()
```

JxnRealArrayAlgebra

protected JxnRealArrayAlgebra(int length)

JxnRealArrayAlgebra
```
public JxnRealArrayAlgebra(double[] value)
```
Creates a JxnRealArrayAlgebra instance from the array value. Calls JxnRealArrayAlgebra( value, false ).

Note: This constructor exists for performance and memory reasons and stores a reference to value as the internal array representation. Consequently modifications of the array elements of value modify the JxnRealArrayAlgebra object and vice versa. To store an independent internal copy of the external array value use JxnRealArrayalgebra( value, true ).

See Also:

getValue()

JxnRealArrayAlgebra
```
public JxnRealArrayAlgebra(double[] value,
                           boolean copyInput)
```
Creates a JxnRealArrayAlgebra instance from the array double [] value.

Parameters:

copyInput - if true, stores a copy of the array value, otherwise stores a reference to the array value.

JxnRealArrayAlgebra
```
public JxnRealArrayAlgebra(int[] value)
```
Creates a JxnRealArrayAlgebra instance from the array int[] value.

JxnRealArrayAlgebra
```
public JxnRealArrayAlgebra(JxnRealArrayAlgebra ra)
```
Creates a copy of ra. Calls JxnRealArrayAlgebra( ra, true )

JxnRealArrayAlgebra
```
public JxnRealArrayAlgebra(JxnRealArrayAlgebra ra,
                           boolean transfer)
```
Creates a copy of ra.

Parameters:

transfer - if true includes copies of itsName and isDateTimeValue.

JxnRealArrayAlgebra

public JxnRealArrayAlgebra(double start,
                           double step,
                           int length)

Creates an instance from the given parameters.
value[i] = start + step * i for i = 0 ... length-1

JxnRealArrayAlgebra
```
public JxnRealArrayAlgebra(double start,
                           double end,
                           double step)
```
Creates an instance from the given parameters.
If start < end: value[i] = start + abs(step) * i
if start > end: value[i] = start - abs(step) * i
for i = 0 ... n with n = 1 + abs( round( ( end - start ) / step ) )

JxnRealArrayAlgebra

public JxnRealArrayAlgebra(double uvmin,
                           double uvStep,
                           int nuvSteps,
                           int nvuSteps,
                           int ni)

Deprecated.

replaced by class JxnUVGrid.

Darstellung von Funktionen x(u,v) und y(u,v) durch Abbildung eines Netzes in der uv-Ebene in die xy-Ebene.

Anwendung:

 u = @JxnRealArrayAlgebra( umin, uStep, nuSteps, nvSteps,  ni )
 v = @JxnRealArrayAlgebra( vmin, vStep, nvSteps, nuSteps, -ni )
 x = fx( u, v )
 y = fy( u, v )
 plot( x, y )

 mit uStep: Maschenweite in u-Richtung, nuSteps: Anzahl der Maschen
     vStep: Maschenweite in v-Richtung, nvSteps: Anzahl der Maschen
     ni:    Anzahl der Stuetzstellen je Masche
            (ni=1 Stuetzstellen nur in den Knotenpunkten)

 Beispiel: nuSteps = 3, nvSteps = 2, ni = 2 ( + : Stuetzstelle )

               +---+---+---+---+---+---+
               |       |       |       |
               +       +       +       +
               |       |       |       |
 vmin+vStep -> +---+---+---+---+---+---+
               |       |       |       |
               +       +       +       +
               |       |       |       |
          vmin +---+---+---+---+---+---+
              umin     |            u ->
                   umin+uStep

Method Detail

cloneThis
```
public JxnCloneableAlgebra cloneThis()
```
Description copied from interface: JxnCloneableAlgebra

Called internally. Required to avoid overwriting the left side operand opndLeft in opndLeft op opndRght, if op is implemented as opndLeft.op(opndRght) and the instance method op modifies the instance.

Specified by:

cloneThis in interface JxnCloneableAlgebra

Returns:

copy of this instance

size
```
public int size()
```
Returns the length of the internal array.

length

public static int length(JxnRealArrayAlgebra ra)

Returns the length of the internal array of ra.

setIgnoreSurplus
```
public static boolean setIgnoreSurplus(boolean ignore)
```
Controls if to ignore surplus elements of the longer internal array for methods which expect two instances with equal length internal arrays. By default the methods silently ignore surplus elements.

Parameters:

ignore - if set to false methods throw an Exception if the internal arrays differ in length.

getIgnoreSurplus

public static boolean getIgnoreSurplus()

Returns ignoreSurplus.

equals
```
public boolean equals(Object other)
```
JxnRealArrayAlgebra objects are equal, if all corresponding array elements are equal. Use setEqualityTolerance(double) to set a tolerance for the comparision of the array values.

Overrides:

equals in class Object

setEqualityTolerance
```
public static double setEqualityTolerance(double eps)
```
Sets tolerance for the equals method for all instances of this class.

Parameters:

eps - eps > 0. absolute difference, eps < 0. relative difference

Returns:

old tolerance

getEqualityTolerance
```
public static double getEqualityTolerance()
```
Returns the tolerance used for the equals method.

setName

public JxnRealArrayAlgebra setName(String name)

Sets a name for this instance (status experimental).

setNamedResultEnabled
```
public static boolean setNamedResultEnabled(boolean enabled)
```
Enables the use of name for JxnRealArrayAlgebra instances (status experimental).

setDateTimeValue
```
public JxnRealArrayAlgebra setDateTimeValue(boolean isDateTime)
```
Indicates that this instance represents date time values. The values of the internal array are interpreted as decimal seconds since 01-Jan-1970 00:00:00 UTC.

See Also:

KmgDateTimeConverter

setTimeFormat

public JxnRealArrayAlgebra setTimeFormat(boolean isDateTime)

Deprecated.

replaced by setDateTimeValue(boolean).

toString
```
public String toString()
```
Formats instance.

Overrides:

toString in class Object

add

public JxnRealArrayAlgebra add(JxnRealArrayAlgebra ra)

Adds ra to this.

sub

public JxnRealArrayAlgebra sub(JxnRealArrayAlgebra ra)

Subtracts ra from this.

mul

public JxnRealArrayAlgebra mul(JxnRealArrayAlgebra ra)

(Post)Multiplies this by ra.

div

public JxnRealArrayAlgebra div(JxnRealArrayAlgebra ra)

Divides this by ra.

inv
```
public JxnRealArrayAlgebra inv()
```
Replaces this by its reciprocal.

remainder

public JxnRealArrayAlgebra remainder(JxnRealArrayAlgebra ra)

Replaces this by this % ra.

pow

public JxnRealArrayAlgebra pow(JxnRealArrayAlgebra exponent)

Replaces this by its power of exponent.

add

public JxnRealArrayAlgebra add(double d)

Adds d to this.

sub

public JxnRealArrayAlgebra sub(double d)

Subtracts d from this.

mul

public JxnRealArrayAlgebra mul(double d)

(Post)Multiplies this by d.

mulL

public JxnRealArrayAlgebra mulL(double d)

(Pre)Multiplies this by d.

div

public JxnRealArrayAlgebra div(double d)

Divides this by d.

remainder

public JxnRealArrayAlgebra remainder(double d)

Replaces this by this % d.

pow

public JxnRealArrayAlgebra pow(double exponent)

Replaces this by its power of exponent.

add

public static JxnRealArrayAlgebra add(double d,
                                      JxnRealArrayAlgebra ra)

Returns d + ra.

sub

public static JxnRealArrayAlgebra sub(double d,
                                      JxnRealArrayAlgebra ra)

Returns d - ra.

mul

public static JxnRealArrayAlgebra mul(double d,
                                      JxnRealArrayAlgebra ra)

Returns d * ra.

div

public static JxnRealArrayAlgebra div(double d,
                                      JxnRealArrayAlgebra ra)

Returns d / ra.

remainder

public static JxnRealArrayAlgebra remainder(double d,
                                            JxnRealArrayAlgebra ra)

Returns d % ra.

pow

public static JxnRealArrayAlgebra pow(double d,
                                      JxnRealArrayAlgebra exponent)

Returns d to the power of exponent.

mul

public JxnRealArrayAlgebra mul(boolean sw)

Deprecated.

...

mul

public static JxnRealArrayAlgebra mul(boolean sw,
                                      JxnRealArrayAlgebra z)

Deprecated.

...

add

public JxnComplexArrayAlgebra add(JxnComplexAlgebra cx)

Adds cx to this.

sub

public JxnComplexArrayAlgebra sub(JxnComplexAlgebra cx)

Subtracts cx from this.

mul

public JxnComplexArrayAlgebra mul(JxnComplexAlgebra cx)

(Post)Multiplies this by cx.

div

public JxnComplexArrayAlgebra div(JxnComplexAlgebra cx)

Divides this by cx.

abs
```
public static JxnRealArrayAlgebra abs(JxnRealArrayAlgebra ra)
```
Calls Math.abs(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

abs

public static JxnRealArrayAlgebra abs(JxnRealArrayAlgebra x,
                                      JxnRealArrayAlgebra y)

Calls Math.hypot(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

hypot

public static JxnRealArrayAlgebra hypot(JxnRealArrayAlgebra x,
                                        JxnRealArrayAlgebra y)

Calls Math.hypot(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

floor
```
public static JxnRealArrayAlgebra floor(JxnRealArrayAlgebra ra)
```
Calls Math.floor(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

ceil
```
public static JxnRealArrayAlgebra ceil(JxnRealArrayAlgebra ra)
```
Calls Math.ceil(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

round
```
public static JxnRealArrayAlgebra round(JxnRealArrayAlgebra ra)
```
Commercial rounding of each element of the internal array of ra.
Note: The implementation differs from Math.round(double).

Returns:

the result in a new JxnRealArrayAlgebra instance.

See Also:

JxnUtilities.round_half_away_from_zero(double)

rint
```
public static JxnRealArrayAlgebra rint(JxnRealArrayAlgebra ra)
```
Calls Math.rint(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

modulo
```
public static JxnRealArrayAlgebra modulo(JxnRealArrayAlgebra x,
                                         JxnRealArrayAlgebra y)
```
Calls JxnUtilities.modulo(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:

the result in a new JxnRealArrayAlgebra instance.

See Also:

remainder(JxnRealArrayAlgebra), IEEEremainder(JxnRealArrayAlgebra x, JxnRealArrayAlgebra y)

modulo
```
public static JxnRealArrayAlgebra modulo(JxnRealArrayAlgebra x,
                                         double d)
```
Calls JxnUtilities.modulo(x_i,d) for each element of the internal array of x.

Returns:

the result in a new JxnRealArrayAlgebra instance.

See Also:

remainder(double d), IEEEremainder(JxnRealArrayAlgebra ra, double d)

modulo
```
public static JxnRealArrayAlgebra modulo(double d,
                                         JxnRealArrayAlgebra y)
```
Calls JxnUtilities.modulo(d,y_i) for each element of the internal array of y.

Returns:

the result in a new JxnRealArrayAlgebra instance.

See Also:

remainder(double d, JxnRealArrayAlgebra y), IEEEremainder(double d, JxnRealArrayAlgebra y)

IEEEremainder

public static JxnRealArrayAlgebra IEEEremainder(JxnRealArrayAlgebra x,
                                                JxnRealArrayAlgebra y)

Calls Math.IEEEremainder(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

IEEEremainder

public static JxnRealArrayAlgebra IEEEremainder(JxnRealArrayAlgebra x,
                                                double d)

Calls Math.IEEEremainder(x_i,d) for each element of the internal array of x.

Returns:: the result in a new JxnRealArrayAlgebra instance.

IEEEremainder

public static JxnRealArrayAlgebra IEEEremainder(double d,
                                                JxnRealArrayAlgebra y)

Calls Math.IEEEremainder(d,y_i) for each element of the internal array of y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

sign

public static JxnRealArrayAlgebra sign(JxnRealArrayAlgebra ra)

Returns a new JxnRealArrayAlgebra containing the sign of each element of the internal array of ra.

Returns:

new JxnRealArrayAlgebra with

             = +1                  > 0.
    value[i] =  0  if ra.value[i] == 0.
             = -1                  < 0.

signum
```
public static JxnRealArrayAlgebra signum(JxnRealArrayAlgebra ra)
```
Calls Math.signum(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

copySign

public static JxnRealArrayAlgebra copySign(JxnRealArrayAlgebra x,
                                           JxnRealArrayAlgebra y)

Calls Math.copySign(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

min

public static JxnRealArrayAlgebra min(JxnRealArrayAlgebra x,
                                      JxnRealArrayAlgebra y)

Calls Math.min(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

min

public static JxnRealArrayAlgebra min(JxnRealArrayAlgebra x,
                                      double d)

Calls Math.min(x_i,d) for each element of the internal array of x.

Returns:: the result in a new JxnRealArrayAlgebra instance.

min

public static JxnRealArrayAlgebra min(double d,
                                      JxnRealArrayAlgebra y)

Deprecated.

Use min( y, d ). Calls Math.min(d,y_i) for each element of the internal array of y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

max

public static JxnRealArrayAlgebra max(JxnRealArrayAlgebra x,
                                      JxnRealArrayAlgebra y)

Calls Math.max(x_i,y_i) for each pair of elements of the internal arrays of x and y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

max

public static JxnRealArrayAlgebra max(JxnRealArrayAlgebra x,
                                      double d)

Calls Math.max(x_i,d) for each element of the internal array of x.

Returns:: the result in a new JxnRealArrayAlgebra instance.

max

public static JxnRealArrayAlgebra max(double d,
                                      JxnRealArrayAlgebra y)

Deprecated.

Use max( y, d ). Calls Math.max(d,y_i) for each element of the internal array of y.

Returns:: the result in a new JxnRealArrayAlgebra instance.

limit

public static JxnRealArrayAlgebra limit(JxnRealArrayAlgebra ra,
                                        double lower,
                                        double upper)

Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra limitted to lower and upper.

Returns:

new JxnRealArrayAlgebra with

    value[i] = lower  if ra.value[i] < lower
             = upper  if ra.value[i] > upper
             = ra.value[i]  else

clip

public static JxnRealArrayAlgebra clip(JxnRealArrayAlgebra ra,
                                       double lower,
                                       double upper)

Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra limitted to lower and upper.
Clipped values of ra are replaced by Double.NaN.

NaN (Not-a-Number) is handled as follows:
- Arithmetic operations with NaN operands do not abort but give NaN as result.
- NaN values result in a gap in a JxnRealArrayCurve.

Returns:

new JxnRealArrayAlgebra with

    if( lower < upper )
       value[i] = ra.value[i]  if lower <= ra.value[i] <= upper
                = Double.NaN   else

    else if( lower > upper )
       value[i] = Double.NaN   if upper <  ra.value[i] <  lower
                = ra.value[i]  else

    else // lower == upper
       value[i] = Double.NaN   if lower == ra.value[i] == upper
                = ra.value[i]  else

clip

public static JxnRealArrayAlgebra clip(JxnRealArrayAlgebra ra1,
                                       JxnRealArrayAlgebra ra2)

Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra1 with elements replaced by Double.NaN if the respective element in ra2 is invalid (NaN or Infinity).

clip
```
public static JxnRealArrayAlgebra clip(JxnRealArrayAlgebra ra,
                                       int[] iClip)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra with elements with indices given in iClip replaced by Double.NaN (to clip single values by index i use ra.set( i, Double.NaN ) or raNew = set( raOld, i, Double.NaN ) ).

clipLE
```
public static JxnRealArrayAlgebra clipLE(JxnRealArrayAlgebra ra,
                                         double minValue)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra with elements value[i] <= minValue replaced by Double.NaN.

clipLT
```
public static JxnRealArrayAlgebra clipLT(JxnRealArrayAlgebra ra,
                                         double minValue)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra with elements value[i] < minValue replaced by Double.NaN.

clipGE
```
public static JxnRealArrayAlgebra clipGE(JxnRealArrayAlgebra ra,
                                         double maxValue)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra with elements value[i] >= maxValue replaced by Double.NaN.

clipGT
```
public static JxnRealArrayAlgebra clipGT(JxnRealArrayAlgebra ra,
                                         double maxValue)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra with elements value[i] > maxValue replaced by Double.NaN.

sw

public static JxnRealArrayAlgebra sw(JxnRealArrayAlgebra ra,
                                     double lower,
                                     double upper)

Deprecated.

replaced by clip(JxnRealArrayAlgebra, double, double).

sw

public static JxnRealArrayAlgebra sw(JxnRealArrayAlgebra x,
                                     JxnRealArrayAlgebra yLT,
                                     JxnRealArrayAlgebra yGE)

Returns values of yLT or yGE depending on the value of x.

Combined logical conditions:

 for x1 >= 0. AND  x2 >= 0. use sw( min( x1, x2 ), ... )
 for x1 >= 0. OR   x2 >= 0. use sw( max( x1, x2 ), ... )
 for x1 >= 0. EXOR x2 >= 0. use sw( x1 * x2, ... )

Returns:

new JxnRealArrayAlgebra with

    value[i] = yLT.value[i]  if x.value[i] < 0.
             = yGE.value[i]  else

sw

public static JxnRealArrayAlgebra sw(JxnRealArrayAlgebra x,
                                     JxnRealArrayAlgebra yLT,
                                     JxnRealArrayAlgebra yEQ,
                                     JxnRealArrayAlgebra yGT,
                                     double eps)

Returns values of yLT, yEQ or yGT depending on the value of x.

Returns:

new JxnRealArrayAlgebra with

    value[i] = yLT.value[i]  if x.value[i] < -eps
             = yGT.value[i]  if x.value[i] > +eps
             = yEQ.value[i]  else

sw

public static JxnRealArrayAlgebra sw(JxnRealArrayAlgebra x,
                                     double lower,
                                     double upper,
                                     JxnRealArrayAlgebra yLower,
                                     JxnRealArrayAlgebra yInner,
                                     JxnRealArrayAlgebra yUpper)

Returns values of yLower, yInner or yUpper depending on the value of x.

Returns:

new JxnRealArrayAlgebra with

    value[i] = yLower.value[i]  if x.value[i] < lower
             = yUpper.value[i]  if x.value[i] > upper
             = yInner.value[i]  else

sort
```
public static JxnRealArrayAlgebra sort(JxnRealArrayAlgebra ra)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra sorted in ascending order.

See Also:

sortIndex(JxnRealArrayAlgebra)

reverse
```
public static JxnRealArrayAlgebra reverse(JxnRealArrayAlgebra ra)
```
Returns a new JxnRealArrayAlgebra containing the elements of the internal array of ra in reversed order.

concat

public static JxnRealArrayAlgebra concat(JxnRealArrayAlgebra ra1,
                                         JxnRealArrayAlgebra ra2)

Returns a new JxnRealArrayAlgebra which is the concatenation of the elements of ra1 followed by ra2.

sqrt
```
public static JxnRealArrayAlgebra sqrt(JxnRealArrayAlgebra ra)
```
Calls Math.sqrt(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

cbrt
```
public static JxnRealArrayAlgebra cbrt(JxnRealArrayAlgebra ra)
```
Calls Math.cbrt(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

scalb

public static JxnRealArrayAlgebra scalb(JxnRealArrayAlgebra ra,
                                        int scaleFactor)

Calls Math.scalb(double, int) for each element of the internal array of ra.

Returns:: the result in a new JxnRealArrayAlgebra instance.

exp
```
public static JxnRealArrayAlgebra exp(JxnRealArrayAlgebra ra)
```
Calls Math.exp(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

expm1
```
public static JxnRealArrayAlgebra expm1(JxnRealArrayAlgebra ra)
```
Calls Math.expm1(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

log
```
public static JxnRealArrayAlgebra log(JxnRealArrayAlgebra ra)
```
Calls Math.log(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

log1p
```
public static JxnRealArrayAlgebra log1p(JxnRealArrayAlgebra ra)
```
Calls Math.log1p(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

log10
```
public static JxnRealArrayAlgebra log10(JxnRealArrayAlgebra ra)
```
Calls Math.log10(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

log

public static JxnRealArrayAlgebra log(double b,
                                      JxnRealArrayAlgebra ra)

Determines the base b logarithm of each element of the internal array of ra.

Returns:: the result in a new JxnRealArrayAlgebra instance.

sin
```
public static JxnRealArrayAlgebra sin(JxnRealArrayAlgebra ra)
```
Calls Math.sin(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

cos
```
public static JxnRealArrayAlgebra cos(JxnRealArrayAlgebra ra)
```
Calls Math.cos(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

tan
```
public static JxnRealArrayAlgebra tan(JxnRealArrayAlgebra ra)
```
Calls Math.tan(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

asin
```
public static JxnRealArrayAlgebra asin(JxnRealArrayAlgebra ra)
```
Calls Math.asin(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

acos
```
public static JxnRealArrayAlgebra acos(JxnRealArrayAlgebra ra)
```
Calls Math.acos(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

atan
```
public static JxnRealArrayAlgebra atan(JxnRealArrayAlgebra ra)
```
Calls Math.atan(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

atan2

public static JxnRealArrayAlgebra atan2(JxnRealArrayAlgebra y,
                                        JxnRealArrayAlgebra x)

Calls Math.atan2(y_i,x_i) for each pair of elements of the internal arrays of y and x.

Returns:: the result in a new JxnRealArrayAlgebra instance.

sinD
```
public static JxnRealArrayAlgebra sinD(JxnRealArrayAlgebra ra)
```
Calls Math.sin(double) for each element of the internal array of ra after converting the argument from degrees to radians.

Returns:

the result in a new JxnRealArrayAlgebra instance.

cosD
```
public static JxnRealArrayAlgebra cosD(JxnRealArrayAlgebra ra)
```
Calls Math.cos(double) for each element of the internal array of ra after converting the argument from degrees to radians.

Returns:

the result in a new JxnRealArrayAlgebra instance.

tanD
```
public static JxnRealArrayAlgebra tanD(JxnRealArrayAlgebra ra)
```
Calls Math.tan(double) for each element of the internal array of ra after converting the argument from degrees to radians.

Returns:

the result in a new JxnRealArrayAlgebra instance.

asinD
```
public static JxnRealArrayAlgebra asinD(JxnRealArrayAlgebra ra)
```
Calls Math.asin(double) and converts the result from radians to degrees for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

acosD
```
public static JxnRealArrayAlgebra acosD(JxnRealArrayAlgebra ra)
```
Calls Math.acos(double) and converts the result from radians to degrees for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

atanD
```
public static JxnRealArrayAlgebra atanD(JxnRealArrayAlgebra ra)
```
Calls Math.atan(double) and converts the result from radians to degrees for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

atan2D
```
public static JxnRealArrayAlgebra atan2D(JxnRealArrayAlgebra y,
                                         JxnRealArrayAlgebra x)
```
Calls Math.atan2(y_i,x_i) and converts the result from radians to degrees for each pair of elements of the internal arrays of y and x.

Returns:

the result in a new JxnRealArrayAlgebra instance.

sinh
```
public static JxnRealArrayAlgebra sinh(JxnRealArrayAlgebra ra)
```
Calls Math.sinh(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

cosh
```
public static JxnRealArrayAlgebra cosh(JxnRealArrayAlgebra ra)
```
Calls Math.cosh(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

tanh
```
public static JxnRealArrayAlgebra tanh(JxnRealArrayAlgebra ra)
```
Calls Math.tanh(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

asinh
```
public static JxnRealArrayAlgebra asinh(JxnRealArrayAlgebra ra)
```
Calls JxnUtilities.asinh(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

acosh
```
public static JxnRealArrayAlgebra acosh(JxnRealArrayAlgebra ra)
```
Calls JxnUtilities.acosh(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

atanh
```
public static JxnRealArrayAlgebra atanh(JxnRealArrayAlgebra ra)
```
Calls JxnUtilities.atanh(double) for each element of the internal array of ra.

Returns:

the result in a new JxnRealArrayAlgebra instance.

random
```
public static JxnRealArrayAlgebra random(int n)
```
Returns a new JxnRealArrayAlgebra with n random numbers from Math.random().

random

public static JxnRealArrayAlgebra random(int n,
                                         long seed)

Returns a new JxnRealArrayAlgebra with n random numbers from rnd.nextDouble() with rnd = new Random(seed).

random

public static JxnRealArrayAlgebra random(JxnRealArrayAlgebra ra)

Returns random(int n) with n = ra.size().

random

public static JxnRealArrayAlgebra random(JxnRealArrayAlgebra ra,
                                         long seed)

Returns random(int n, long seed) with n = ra.size().

noise
```
public static JxnRealArrayAlgebra noise(int n)
```
Returns a new JxnRealArrayAlgebra with n random numbers from rnd.nextGaussian() with rnd = new Random().

noise

public static JxnRealArrayAlgebra noise(int n,
                                        long seed)

Returns a new JxnRealArrayAlgebra with n random numbers from rnd.nextGaussian() with rnd = new Random(seed).

noise

public static JxnRealArrayAlgebra noise(JxnRealArrayAlgebra ra)

Returns noise(int n) with n = ra.size().

noise

public static JxnRealArrayAlgebra noise(JxnRealArrayAlgebra ra,
                                        long seed)

Returns noise(int n, long seed) with n = ra.size().

derivative

public static JxnRealArrayAlgebra derivative(JxnRealArrayAlgebra y)

Returns derivative( y, 1. ).

derivative
```
public static JxnRealArrayAlgebra derivative(JxnRealArrayAlgebra y,
                                             double dt)
```
Returns the derivative dy/dt for equidistant step size dt.
result[i] = 0.5 * ( y[i+1] - y[i-1] ) / dt (derivative from quadratic polynom through 3 adjacent points).

Returns:

the result in a new JxnRealArrayAlgebra instance.

derivative
```
public static JxnRealArrayAlgebra derivative(JxnRealArrayAlgebra y,
                                             JxnRealArrayAlgebra t)
```
Returns the derivative dy/dt for the elements of the internal arrays of y and t.
Determines the derivative at t_i from the quadratic polynom through the (not necessarily equidistant) points (t_i-1, y_i-1), (t_i, y_i) and (t_i+1, y_i+1).

Returns:

the result in a new JxnRealArrayAlgebra instance.

integral

public static JxnRealArrayAlgebra integral(JxnRealArrayAlgebra y)

Returns integral( y, 1. ).

integral
```
public static JxnRealArrayAlgebra integral(JxnRealArrayAlgebra y,
                                           double dt)
```
Returns the integral ∫ y dt for equidistant step size dt.
result[0] = 0.; result[i+1] = result[i] + 0.5 * ( y[i+1] + y[i] ) * dt (trapeziod rule: linear interpolation between data points)

Returns:

the result in a new JxnRealArrayAlgebra instance.

integral
```
public static JxnRealArrayAlgebra integral(JxnRealArrayAlgebra y,
                                           JxnRealArrayAlgebra t)
```
Returns the integral ∫ y dt for the elements of the internal arrays of y and t.
Determines the integral by the trapeziod rule (linear interpolation between (not necessarily equidistant) data points).
result[0] = 0.; result[i+1] = result[i] + 0.5 * ( y[i+1] + y[i] ) * ( t[i+1] - t[i] )

Returns:

the result in a new JxnRealArrayAlgebra instance.

energy
```
public static JxnRealArrayAlgebra energy(JxnRealArrayAlgebra p,
                                         double h)
```
Returns the integral of a power curve (with e.g. p[0] = average power of time interval: 0:00 - 0:15 (available and stored at 0:15) ).
result[0] = p[0]; result[i+1] = result[i] + h * p[i+1] ( with result[i] = accumulated meter value at time ( i + 1 ) * h ).

Parameters:

h - sample interval: If p is in kW and h is 0.25 h (= 15 min) the result is in kWh

Returns:

the result in a new JxnRealArrayAlgebra instance.

nonWindupStore

public static JxnRealArrayAlgebra nonWindupStore(JxnRealArrayAlgebra p,
                                                 double h,
                                                 double initial,
                                                 double lower,
                                                 double upper)

Returns the integral internally limited to lower and upper (non windup limiter) of a power curve.
Differs from limit( energy( p, h ), lower, upper ) which winds up.

Parameters:: initial - initial value of the store
Returns:: the result in a new JxnRealArrayAlgebra instance.
See Also:: energy(JxnRealArrayAlgebra, double), Wikipedia

peak
```
public static JxnRealArrayAlgebra peak(JxnRealArrayAlgebra p,
                                       double h)
```
Determines the peak energy from a power curve p. For ep = peak( p, h ) the value ep[i] contains the (peak) energy consumed above a power value of ps[i+1] of the sorted power curve ps = reverse( sort(p) ).

Parameters:

h - sample interval of p

gaussFilter

public static JxnRealArrayAlgebra gaussFilter(JxnRealArrayAlgebra t,
                                              double bandWidth)

Returns gaussFilter( t, bandWidth, 3. ).

gaussFilter

public static JxnRealArrayAlgebra gaussFilter(JxnRealArrayAlgebra t,
                                              double bandWidth,
                                              double filterWidth)

Creates a gaussFilter for convolution.

Parameters:: bandWidth - of the filter in terms of t.; filterWidth - width of the (finite) approximation of the infinite width gauss filter in terms of the bandWidth

convolution

public static JxnRealArrayAlgebra convolution(JxnRealArrayAlgebra ra,
                                              JxnRealArrayAlgebra filter)

Returns convolution( ra, filter, 1 ).

convolution
```
public static JxnRealArrayAlgebra convolution(JxnRealArrayAlgebra ra,
                                              JxnRealArrayAlgebra filter,
                                              int mode)
```
Returns the convolution of ra with filter. Together with gaussFilter this results in the smoothing of ra.
The filtering implements a generalized weighted moving average which removes high frequency signal components (noise).
Example:
```
    slider = @JxnSliderPanel($this)
    seed = slider.add( "seed", 0., 0., 1000. )
    an = slider.add( "noise amplitude",  0.5,  0.01,  2. )
    bw = slider.add( "filter bandwidth", 0.05, 0.001, 2. )
    mode = 1

    noise = JxnRealArrayAlgebra.noise( t, round seed )
    y0 = 2 + sin 4 PI t
    y1 = y0 + an noise
    gf = gaussFilter( t, bw )
    yf = convolution( y1, gf, mode )
    plot( t, y1, yf, y0 )
    total y1 + " " + total yf
 
```
Parameters:

filter - positive half of a symmetrical filter function e.g. from gaussFilter

mode - determines how to handle values which by the convolution are mapped to the intervals outside the left and right margins:
0 : discards values. As a concequence the total of the data is reduced.
1 : adjust the weight of the filter function applied near the margins to preserve the total of the data.
2 : cyclic mapping of data from the right to the left margin and vice versa (periodic extension).

See Also:

Wikipedia

faltung

public static JxnRealArrayAlgebra faltung(JxnRealArrayAlgebra ra,
                                          JxnRealArrayAlgebra filter)

Deprecated.

replaced by convolution(JxnRealArrayAlgebra, JxnRealArrayAlgebra).

faltung

public static JxnRealArrayAlgebra faltung(JxnRealArrayAlgebra ra,
                                          JxnRealArrayAlgebra filter,
                                          int iRand)

Deprecated.

replaced by convolution(JxnRealArrayAlgebra, JxnRealArrayAlgebra, int).

See Also:: Wikipedia

smoothExp
```
public static JxnRealArrayAlgebra smoothExp(JxnRealArrayAlgebra x,
                                            double alpha)
```
Returns the result y of an exponential smoothing of x.
y[i] = alpha * x[i] + ( 1 - alpha ) * y[i-1]

Returns:

the result in a new JxnRealArrayAlgebra instance.

getDayOfWeek
```
public static JxnRealArrayAlgebra getDayOfWeek(JxnRealArrayAlgebra ra)
```
Returns the day of week ( Mo: 1, ... Su: 7 ) for the values of the internal array of ra interpreted as decimal seconds since 01-Jan-1970 00:00:00 UTC. Returns negative values for German holidays (Bavaria).

Returns:

the result in a new JxnRealArrayAlgebra instance.

See Also:

Calendar, German holidays (Wikipedia), setDateTimeValue(boolean), KmgDateTimeConverter

getCalendarField
```
public static JxnRealArrayAlgebra getCalendarField(JxnRealArrayAlgebra ra,
                                                   int field)
```
Returns the result of gc.get( field ) with gc = new GregorianCalendar() for the values of the internal array of ra interpreted as decimal seconds since 01-Jan-1970 00:00:00 UTC.

Parameters:

field - constant from Calendar

Returns:

the result in a new JxnRealArrayAlgebra instance.

See Also:

setDateTimeValue(boolean), KmgDateTimeConverter

set

public static JxnRealArrayAlgebra set(JxnRealArrayAlgebra ra,
                                      int i,
                                      double vi)

Returns a copy of ra, with the i-th value replaced by vi.

set

public JxnRealArrayAlgebra set(int i,
                               double vi)

Replaces the i-th value of this JxnRealArrayAlgebra by vi.

Returns:: this

setValue
```
public double setValue(int i,
                       double vi)
```
Replaces the i-th value of this JxnRealArrayAlgebra by vi.

Returns:

the old value

setValue

public double setValue(double vi,
                       int i)

Deprecated.

replaced by setValue( i, vi ).

setValue

public static JxnRealArrayAlgebra setValue(JxnRealArrayAlgebra ra,
                                           double vi,
                                           int i)

Deprecated.

Use set( ra, i, vi ).

range
```
public JxnRealArrayAlgebra range(int iStart)
```
Returns a new JxnRealArrayAlgebra containing length(ra)-iStart values starting from index iStart. If iStart < 0 returns abs(iStart) values starting from index length(ra)-abs(iStart).

range
```
public JxnRealArrayAlgebra range(int iStart,
                                 int iEnd)
```
Returns a new JxnRealArrayAlgebra containing iEnd-iStart values starting from index iStart to index iEnd (excluding).

range
```
public JxnRealArrayAlgebra range()
```
Calls range(int, int) reusing iStart and iEnd from the most recent call.

range
```
public JxnRealArrayAlgebra range(JxnRealArrayAlgebra ra)
```
Deprecated.
No more supported. Calls range(int, int) reusing iStart and iEnd from ra.

range

public JxnRealArrayAlgebra range(double start)

Calls range(int) with start rounded to int.

range

public JxnRealArrayAlgebra range(double start,
                                 double end)

Calls range(int, int) with start and end rounded to int.

range
```
public JxnRealArrayAlgebra range(String start)
```
Returns a new JxnRealArrayAlgebra containing the values of this starting from start given as date time string.

See Also:

setDateTimeValue(boolean), KmgDateTimeConverter

range
```
public JxnRealArrayAlgebra range(String start,
                                 String end)
```
Returns a new JxnRealArrayAlgebra containing the values of this starting from start to end given as date time string.

See Also:

setDateTimeValue(boolean), KmgDateTimeConverter

shift
```
public JxnRealArrayAlgebra shift(int k)
```
Returns a new JxnRealArrayAlgebra containing the values of this circularly shifted by k.

shift

public static JxnRealArrayAlgebra shift(JxnRealArrayAlgebra ra,
                                        int k)

Returns a new JxnRealArrayAlgebra containing the values of this shifted by k filling with 0..

shift

public static JxnRealArrayAlgebra shift(JxnRealArrayAlgebra ra,
                                        int k,
                                        double d)

Returns a new JxnRealArrayAlgebra containing the values of this shifted by k filling with d.

byIndex
```
public JxnRealArrayAlgebra byIndex(int[] index)
```
Returns a new JxnRealArrayAlgebra containing the values of this instance at the positions given in index.

See Also:

get(int[])

by

public JxnRealArrayAlgebra by(int[] index)

Same as byIndex(int[]).

sortIndex
```
public static int[] sortIndex(JxnRealArrayAlgebra ra)
```
Returns an array of the indices of the values of ra in ascending order. ry.byIndex( sortIndex(ry) ) gives the same JxnRealArrayAlgebra as sort(ry), but sortIndex also allows to address other arrays according to the order of a given array ry.

See Also:

sort(JxnRealArrayAlgebra)

cut
```
public static int[] cut(JxnRealArrayAlgebra ra)
```
Returns an int array of the indices i of values of ra with: value[i] > 0..

See Also:

clipLE(JxnRealArrayAlgebra ra, double minValue)

cut
```
public static int[] cut(JxnRealArrayAlgebra ra,
                        int[] index)
```
Analyzes the values of ra only with indices given in array index and returns an int array of the indices i of values with: value[i] > 0..

cut
```
public static int[] cut(JxnRealArrayAlgebra ra,
                        double min,
                        double max)
```
Returns an int array of the indices i of values of ra with: min <= value[i] <= max.

See Also:

clip(JxnRealArrayAlgebra ra, double min, double max)

getCntValid
```
public static int getCntValid(JxnRealArrayAlgebra ra)
```
Returns the number of valid (neither NaN nor Infinitive) values in ra.

getCntNaN

public static int getCntNaN(JxnRealArrayAlgebra ra)

Returns the number of NaN values in ra.

getCntInvalid
```
public static int getCntInvalid(JxnRealArrayAlgebra ra)
```
Returns the number of invalid (NaN or Infinitive) values in ra.

valid
```
public static int[] valid(JxnRealArrayAlgebra ra)
```
Returns an int array of the indices of values of ra with valid (neither NaN nor Infinitive) values.

invalid
```
public static int[] invalid(JxnRealArrayAlgebra ra)
```
Returns an int array of the indices of values of ra with invalid (NaN or Infinitive) values.

valueAt
```
public double valueAt(int i)
```
Deprecated.
Use get(i).

valueAt

public static double valueAt(JxnRealArrayAlgebra ra,
                             int i)

Deprecated.

Use getValue( ra, i ).

get
```
public double get(int i)
```
Returns the value of the i-th element of the internal array of this JxnRealArrayAlgebra.

get
```
public double[] get(int[] ia)
```
Returns an array of the values of the elements of the internal array of this JxnRealArrayAlgebra defined by the indices given in ia.

See Also:

byIndex(int[])

get
```
public double get(double x)
```
Returns a value for position x by linear interpolation between the adjacent elements of the internal array of this JxnRealArrayAlgebra.
For: i <= x <= i+1 returns: value[i] + ( x - i ) * ( value[i+1] - value[i] )

get
```
public double[] get(double[] da)
```
Returns an array of values at the positions given in da by linear interpolation between the adjacent elements of the internal array of this JxnRealArrayAlgebra using get(double x).

get
```
public JxnRealArrayAlgebra get(JxnRealArrayAlgebra ra)
```
Returns a JxnRealArrayAlgebra of values at the positions given in ra by linear interpolation between the adjacent elements of the internal array of this JxnRealArrayAlgebra using get(double[]).

toArray
```
public double[] toArray()
```
Returns a copy of the internal array of this JxnRealArrayAlgebra.

getValue
```
public double[] getValue()
```
Returns a reference to the internal array of this JxnRealArrayAlgebra.

Note: This method exists for performance and memory reasons. The modification of an array value will modify the JxnRealArrayAlgebra object and vice versa. Use toArray() to get an independent copy of the internal array.

See Also:

JxnRealArrayAlgebra(double[])

getValue
```
public double getValue(int i)
```
Deprecated.
Use get(i).

getValue

public static double getValue(JxnRealArrayAlgebra ra,
                              int i)

Returns the value of the i-th element of the internal array of ra.

getValue
```
public double getValue(double x)
```
Returns get(x).

getValue

public static double getValue(JxnRealArrayAlgebra ra,
                              double x)

Returns ra.get(x).

getValue

public double[] getValue(double[] da)

Returns get(da).

getValue

public static double[] getValue(JxnRealArrayAlgebra ra,
                                double[] da)

Returns ra.get(da).

findValue

public double[] findValue(double value)

Finds value in the internal array.
Example:

    x = x / 2
     = {-5.0, -4.975, ... 5.0}[401] (JxnRealArrayAlgebra)
    y = sin x
     = {0.9589242746631385, 0.9657154423905294, ... -0.9589242746631385}[401] (JxnRealArrayAlgebra)
    p = y.findValue( 0. )
     = { 74.33630146888443, 200.0, 325.6636985311156 } (double[3])
    x[p]  ! shortcut of x.get( p )
     = { -3.141592463277889, 0.0, 3.14159246327789 } (double[3])
    x[p] / PI
     = { -0.9999999394218395, 0.0, 0.9999999394218397 } (double[3])
    y[p]
     = { -4.85722573273506E-17, 0.0, -6.002143226879753E-16 } (double[3])
    sin x[p]
     = { -1.903119041361038E-7, 0.0, 1.903119032479254E-7 } (double[3])

Note: Intervals containing value are detected only by looking for transitions of the values of the internal array from above value to below value without any magic to distinguish a pole from a zero crossing (try the example replacing sin by tan).

Returns:: position(s) (by linear interpolation) within all intervals of the internal array which include the given value.
See Also:: get(double)

findValue

public static double[] findValue(JxnRealArrayAlgebra ra,
                                 double value)

Same as ra.findValue(double value).

minValue
```
public static double minValue(JxnRealArrayAlgebra ra)
```
Returns the minimum value (including -Infinity) of the internal array of ra.

minValid
```
public static double minValid(JxnRealArrayAlgebra ra)
```
Returns the minimum value excluding -Infinity of the internal array of ra.

minIndex
```
public static int minIndex(JxnRealArrayAlgebra ra)
```
Returns the index of the (first) minimum value (including -Infinity) of the internal array of ra.

maxValue
```
public static double maxValue(JxnRealArrayAlgebra ra)
```
Returns the maximum value (including +Infinity) of the internal array of ra.

maxValid
```
public static double maxValid(JxnRealArrayAlgebra ra)
```
Returns the minimum value excluding +Infinity of the internal array of ra.

maxIndex
```
public static int maxIndex(JxnRealArrayAlgebra ra)
```
Returns the index of the (first) maximum value (including +Infinity) of the internal array of ra.

summe

public static double summe(JxnRealArrayAlgebra ra)

Returns total( ra ).

total
```
public static double total(JxnRealArrayAlgebra ra)
```
Returns the sum of all elements of the internal array of ra.

quadsum
```
public static double quadsum(JxnRealArrayAlgebra ra)
```
Returns the sum of the squares of all elements of the internal array of ra.

korXY

public static double korXY(JxnRealArrayAlgebra rx,
                           JxnRealArrayAlgebra ry)

Returns corXY( rx, ry ).

See Also:: Wikipedia

corXY

public static double corXY(JxnRealArrayAlgebra rx,
                           JxnRealArrayAlgebra ry)

Returns the correlation coefficient of rx and ry.

See Also:: Wikipedia

plot
```
public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra ry)
```
Creates a new JxnRealArrayPlotFrame and visualizes the values of ry as a curve:
x_i = i, y_i = ry.value[i], i = 0 ... y.length - 1.

Returns:

PlotFrame instance can be used to add further curves and phasors.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra ry,
                                         Color color,
                                         int lineType)

See plot.

Parameters:: lineType - see JxnRealArrayCurve

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra ry,
                                         double ymin,
                                         double ymax)

Deprecated.

Use plot( ry ).setYBounds( ymin, ymax ).

plot
```
public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry)
```
Creates a new JxnRealArrayPlotFrame and visualizes the values of rx and ry as a curve:
x_i = rx.value[i], y_i = ry.value[i], i = 0 ... min( length(rx), length(ry) ) - 1.

Returns:

PlotFrame instance can be used to add further curves and phasors.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         double ymin,
                                         double ymax)

Deprecated.

Use plot( rx, ry ).setYBounds( ymin, ymax ).

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry1,
                                         JxnRealArrayAlgebra ry2)

plot 2 curves: ry1: red, ry2: blue.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry1,
                                         JxnRealArrayAlgebra ry2,
                                         double ymin,
                                         double ymax)

Deprecated.

Use plot( rx, ry1, ry2 ).setYBounds( ymin, ymax ).

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry1,
                                         JxnRealArrayAlgebra ry2,
                                         JxnRealArrayAlgebra ry3)

plot 3 curves: ry1: red, ry2: blue, ry3: green.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry1,
                                         JxnRealArrayAlgebra ry2,
                                         JxnRealArrayAlgebra ry3,
                                         double ymin,
                                         double ymax)

Deprecated.

Use plot( rx, ry1, ry2, ry3 ).setYBounds( ymin, ymax ).

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         double vyx)

See plot.

Parameters:: vyx - fixed ratio of the scaling: 1.0 for equally scaled x- and y-axis.

plot
```
public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         int logScales)
```
See plot.
Note: logarithmic scaling requires that all values are positive. The scale switches to linear if rx or ry include any value(s) <= 0.

Parameters:

logScales - determines which axis should be scaled logarithmic

logScales x-axis y-axis

0 lin lin

1 lin log

2 log lin

3 log log

4 time lin

5 time log

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         int lineType)

See plot.

Parameters:: lineType - see JxnRealArrayCurve

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         float lineWidth)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         Stroke stroke)

See plot.

Parameters:: stroke - see java.awt.BasicStroke

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         int lineType,
                                         double vyx)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         int lineType,
                                         int logScales)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         int lineType,
                                         float lineWidth,
                                         double vyx)

See plot.

Parameters:: lineWidth - see java.awt.BasicStroke

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         int lineType,
                                         float lineWidth,
                                         int logScales)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         Stroke stroke,
                                         double vyx)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         Color color,
                                         Stroke stroke,
                                         int logScales)

See plot.

plot

public static JxnRealArrayPlotFrame plot(JxnRealArrayAlgebra rx,
                                         JxnRealArrayAlgebra ry,
                                         JxnRealArrayAlgebra rz,
                                         IKmg3DProjection p3d)

Deprecated.

Use plot( p3d ).add( rx, ry, rz ).

curve
```
public static JxnRealArrayCurve curve(JxnRealArrayAlgebra rx,
                                      JxnRealArrayAlgebra ry,
                                      Color color)
```
Returns a curve representation of rx and ry ( x_i = rx.value[i], y_i = ry.value[i] ). Call the add method on a PlotFrame instance to display the curve in the PlotFrame. Allows e.g. to show a curve in a JxnComplexPlotFrame.

Example: plot( 3 + j 4 ).add( curve( 5 cos 2 PI t, 5 sin 2 PI t, Color.BLUE ).setLineWidth(3) )

curve

public static JxnRealArrayCurve curve(JxnRealArrayAlgebra rx,
                                      JxnRealArrayAlgebra ry,
                                      Color color,
                                      int lineType)

See curve.

Parameters:: lineType - see JxnRealArrayCurve
See Also:: JxnAbstractPainter.setLineWidth(float), JxnAbstractPainter.setStroke(java.awt.Stroke)

curve

public static JxnRealArrayCurve curve(JxnRealArrayAlgebra ry,
                                      Color color)

Returns a curve representation of ry ( x_i = i, y_i = ry.value[i] ). Call the add method on a PlotFrame instance to display the curve in the PlotFrame.

curve

public static JxnRealArrayCurve curve(JxnRealArrayAlgebra ry,
                                      Color color,
                                      int lineType)

See curve.

Parameters:: lineType - see JxnRealArrayCurve

curve

public static JxnRealArrayCurve curve(JxnRealArrayAlgebra rx,
                                      JxnRealArrayAlgebra ry,
                                      JxnRealArrayAlgebra rz,
                                      IKmg3DProjection p3d)

Deprecated.

Use plot( p3d ).add( rx, ry, rz ).

curve

public static JxnRealArrayCurve curve(JxnRealArrayAlgebra rx,
                                      JxnRealArrayAlgebra ry,
                                      JxnRealArrayAlgebra rz,
                                      IKmg3DProjection p3d,
                                      Color color)

Deprecated.

Use plot( p3d ).add( rx, ry, rz, color ).

curve

public static JxnRealArrayCurve curve(JxnRealArrayAlgebra rx,
                                      JxnRealArrayAlgebra ry,
                                      JxnRealArrayAlgebra rz,
                                      IKmg3DProjection p3d,
                                      Color color,
                                      int lineType)

Only used for anaglyph stereo. Prefer plot( p3d ).add( rx, ry, rz, color, lineType ).

Parameters:: lineType - see JxnRealArrayCurve
See Also:: JXN gallery, → anaglyph stereo

logScales	x-axis	y-axis
0	lin	lin
1	lin	log
2	log	lin
3	log	log
4	time	lin
5	time	log

Class JxnRealArrayAlgebra

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

value

equalityTolerance

ignoreSurplus

Constructor Detail

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

JxnRealArrayAlgebra

Method Detail

cloneThis

size

length

setIgnoreSurplus

getIgnoreSurplus

equals

setEqualityTolerance

getEqualityTolerance

setName

setNamedResultEnabled

setDateTimeValue

setTimeFormat

toString

add

sub

mul

div

inv

remainder

pow

add

sub

mul

mulL

div

remainder

pow

add

sub

mul

div

remainder

pow

mul

mul

add

sub

mul

div

abs

abs

hypot

floor

ceil

round

rint

modulo

modulo

modulo

IEEEremainder

IEEEremainder

IEEEremainder

sign

signum

copySign

min

min

min

max