Package fi.iki.jmtilli.javafastcomplex

Class ComplexBufferArray

java.lang.Object
fi.iki.jmtilli.javafastcomplex.ComplexBufferArray
All Implemented Interfaces:
ComplexNumberArray, java.io.Serializable
public class ComplexBufferArray
extends java.lang.Object
implements ComplexNumberArray, java.io.Serializable
A mutable complex number array. An instance of this class refers to a complex number the value of which can be changed. This allows higher performance, as if the value of the number can be changed, not that many small objects need to be created.
See Also:
Serialized Form

  • Constructor Details

    • ComplexBufferArray

      public ComplexBufferArray​(int size)
      Create a complex buffer array
      Parameters:
      size - The size of the array

  • Method Details

    • size

      public int size()
      Returns the size of the array.
      Specified by:
      size in interface ComplexNumberArray
      Returns:
      The size

    • set

      public ComplexBufferArray set​(int i, double re)
      Modify the real part of this complex buffer and set imaginary part to zero.
      Parameters:
      i - The array index
      re - The new real part
      Returns:
      this

    • set

      public ComplexBufferArray set​(int i, double re, double im)
      Modify the real and imaginary parts of this complex buffer
      Parameters:
      i - The array index
      re - The new real part
      im - The new imaginary part
      Returns:
      this

    • getReal

      public double getReal​(int i)
      Returns the real part of the complex number.
      Specified by:
      getReal in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      The real part

    • getImag

      public double getImag​(int i)
      Returns the imaginary part of the complex number.
      Specified by:
      getImag in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      The imaginary part

    • set

      public ComplexBufferArray set​(int i, ComplexNumber num)
      Modify the value of this complex buffer
      Parameters:
      i - The array index
      num - The new value
      Returns:
      this

    • set

      public ComplexBufferArray set​(int i, ComplexNumberArray num, int j)
      Modify the value of this complex buffer
      Parameters:
      i - The array index
      num - The new value array
      j - The array index to the other array
      Returns:
      this

    • get

      public Complex get​(int i)
      Get the value of this complex buffer as an immutable object
      Parameters:
      i - The array index
      Returns:
      A new immutable complex number that has the same value as this buffer

    • addInPlace

      public ComplexBufferArray addInPlace​(int i, ComplexNumber c)
      Add another complex number to this buffer and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number
      Returns:
      this

    • addInPlace

      public ComplexBufferArray addInPlace​(int i, ComplexNumberArray c, int j)
      Add another complex number to this buffer and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number array
      j - The array index to the other array
      Returns:
      this

    • addInPlace

      public ComplexBufferArray addInPlace​(int i, double d)
      Add a real number to this buffer and store the result in this buffer
      Parameters:
      i - The array index
      d - The real number
      Returns:
      this

    • subtractInPlace

      public ComplexBufferArray subtractInPlace​(int i, ComplexNumber c)
      Subtract another complex number from this buffer and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number
      Returns:
      this

    • subtractInPlace

      public ComplexBufferArray subtractInPlace​(int i, ComplexNumberArray c, int j)
      Subtract another complex number from this buffer and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number array
      j - The array index to the other array
      Returns:
      this

    • subtractInPlace

      public ComplexBufferArray subtractInPlace​(int i, double d)
      Subtract a real number from this buffer and store the result in this buffer
      Parameters:
      i - The array index
      d - The real number
      Returns:
      this

    • subtractReversedInPlace

      public ComplexBufferArray subtractReversedInPlace​(int i, ComplexNumber c)
      Subtract the value of this buffer from another complex number and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number
      Returns:
      this

    • subtractReversedInPlace

      public ComplexBufferArray subtractReversedInPlace​(int i, ComplexNumberArray c, int j)
      Subtract the value of this buffer from another complex number and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number array
      j - The array index to the other array
      Returns:
      this

    • subtractReversedInPlace

      public ComplexBufferArray subtractReversedInPlace​(int i, double d)
      Subtract the value of this buffer from a real number and store the result in this buffer
      Parameters:
      i - The array index
      d - The real number
      Returns:
      this

    • negateInPlace

      public ComplexBufferArray negateInPlace​(int i)
      Negate the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • conjugateInPlace

      public ComplexBufferArray conjugateInPlace​(int i)
      Calculate the conjugate of the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • invertInPlace

      public ComplexBufferArray invertInPlace​(int i)
      Calculate the inverse of the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • sqrtInPlace

      public ComplexBufferArray sqrtInPlace​(int i)
      Calculate the square root of the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • expInPlace

      public ComplexBufferArray expInPlace​(int i)
      Calculate the exponential of the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • logInPlace

      public ComplexBufferArray logInPlace​(int i)
      Calculate the logarithm of the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • log1pInPlace

      public ComplexBufferArray log1pInPlace​(int i)
      Calculate the logarithm of 1 added to the value of this buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • expm1InPlace

      public ComplexBufferArray expm1InPlace​(int i)
      Calculate exp(this)-1 and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • acoshInPlace

      public ComplexBufferArray acoshInPlace​(int i)
      Calculate the inverse hyperbolic cosine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • asinhInPlace

      public ComplexBufferArray asinhInPlace​(int i)
      Calculate the inverse hyperbolic sine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • atanhInPlace

      public ComplexBufferArray atanhInPlace​(int i)
      Calculate the inverse hyperbolic tangent of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • acosInPlace

      public ComplexBufferArray acosInPlace​(int i)
      Calculate the inverse cosine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • asinInPlace

      public ComplexBufferArray asinInPlace​(int i)
      Calculate the inverse sine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • atanInPlace

      public ComplexBufferArray atanInPlace​(int i)
      Calculate the inverse tangent of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • cosInPlace

      public ComplexBufferArray cosInPlace​(int i)
      Calculate the cosine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • sinInPlace

      public ComplexBufferArray sinInPlace​(int i)
      Calculate the sine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • tanInPlace

      public ComplexBufferArray tanInPlace​(int i)
      Calculate the tangent of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • coshInPlace

      public ComplexBufferArray coshInPlace​(int i)
      Calculate the hyperbolic cosine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • sinhInPlace

      public ComplexBufferArray sinhInPlace​(int i)
      Calculate the hyperbolic sine of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • tanhInPlace

      public ComplexBufferArray tanhInPlace​(int i)
      Calculate the hyperbolic tangent of the value of the buffer and store the result in this buffer
      Parameters:
      i - The array index
      Returns:
      this

    • powInPlace

      public ComplexBufferArray powInPlace​(int i, double b)
      Raise this complex number to a real power and store the result in this buffer
      Parameters:
      i - The array index
      b - The real power
      Returns:
      this

    • powInPlace

      public ComplexBufferArray powInPlace​(int i, ComplexNumber b)
      Raise this complex number to a complex power and store the result in this buffer
      Parameters:
      i - The array index
      b - The complex power
      Returns:
      this

    • powInPlace

      public ComplexBufferArray powInPlace​(int i, ComplexNumberArray b, int j)
      Raise this complex number to a complex power and store the result in this buffer
      Parameters:
      i - The array index
      b - The complex power array
      j - The array index to the other array
      Returns:
      this

    • multiplyInPlace

      public ComplexBufferArray multiplyInPlace​(int i, ComplexNumber c)
      Multiply the value of this complex buffer by another complex number and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number
      Returns:
      this

    • multiplyInPlace

      public ComplexBufferArray multiplyInPlace​(int i, ComplexNumberArray c, int j)
      Multiply the value of this complex buffer by another complex number and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number array
      j - The array index to the other array
      Returns:
      this

    • multiplyInPlace

      public ComplexBufferArray multiplyInPlace​(int i, double d)
      Multiply the value of this complex buffer by a real number and store the result in this buffer
      Parameters:
      i - The array index
      d - The real number
      Returns:
      this

    • multiplyInPlace

      public ComplexBufferArray multiplyInPlace​(int i, int x)
      Multiply the value of this complex buffer by an integer and store the result in this buffer
      Parameters:
      i - The array index
      x - The integer
      Returns:
      this

    • divideInPlace

      public ComplexBufferArray divideInPlace​(int i, ComplexNumber c)
      Divide the value of this complex buffer by another complex number and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number
      Returns:
      this

    • divideInPlace

      public ComplexBufferArray divideInPlace​(int i, ComplexNumberArray c, int j)
      Divide the value of this complex buffer by another complex number and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number array
      j - The array index to the other array
      Returns:
      this

    • divideInPlace

      public ComplexBufferArray divideInPlace​(int i, double d)
      Divide the value of this complex buffer by a real number and store the result in this buffer
      Parameters:
      i - The array index
      d - The real number
      Returns:
      this

    • divideReversedInPlace

      public ComplexBufferArray divideReversedInPlace​(int i, ComplexNumber c)
      Divide another complex number by the value of this complex buffer and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number
      Returns:
      this

    • divideReversedInPlace

      public ComplexBufferArray divideReversedInPlace​(int i, ComplexNumberArray c, int j)
      Divide another complex number by the value of this complex buffer and store the result in this buffer
      Parameters:
      i - The array index
      c - The other complex number array
      j - The array index to the other array
      Returns:
      this

    • divideReversedInPlace

      public ComplexBufferArray divideReversedInPlace​(int i, double d)
      Divide a real number by the value of this complex buffer and store the result in this buffer
      Parameters:
      i - The array index
      d - The real number
      Returns:
      this

    • abs

      public double abs​(int i)
      Calculate the absolute value of the complex number in this complex buffer.
      Specified by:
      abs in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      x≥0 The absolute value

    • arg

      public double arg​(int i)
      Calculate the argument of the complex number in this complex buffer. The argument is the angle between the positive real axis and the point that represents this number in the complex plane.
      Specified by:
      arg in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      -pi≤x≤pi The argument

    • isNaN

      public boolean isNaN​(int i)
      Check whether the complex number in this buffer is NaN (not-a-numer). A complex number is considered NaN if either the real or the imaginary part is NaN.
      Specified by:
      isNaN in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      Whether the complex number in this buffer is NaN

    • isInfinite

      public boolean isInfinite​(int i)
      Check whether the complex number in this buffer is infinite. A complex number is considered infinite if either the real or the imaginary part is infinite. If either the real of imaginary part is NaN, the number is not considered infinite, so isNaN() and isInfinite() cannot be true at the same time.
      Specified by:
      isInfinite in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      Whether the complex number in this buffer is infinite

    • toString

      public java.lang.String toString​(int i)
      Returns a String representation of the complex number in this complex buffer.
      Specified by:
      toString in interface ComplexNumberArray
      Parameters:
      i - The array index
      Returns:
      "NaN" if NaN
      re if purely real
      im + "i" if purely imaginary
      re " + " + im + "i" if imaginary part positive
      re " - " + (-im) + "i" if imaginary part negative