Package com.apple.foundationdb.linear

Class HalfRealVector

java.lang.Object
com.apple.foundationdb.linear.AbstractRealVector
com.apple.foundationdb.linear.HalfRealVector
All Implemented Interfaces:
RealVector
public class HalfRealVector extends AbstractRealVector
A vector class encoding a vector over half components. Conversion to DoubleRealVector is supported and memoized.

  • Constructor Details

    • HalfRealVector

      public HalfRealVector(@Nonnull Half[] halfData)

    • HalfRealVector

      public HalfRealVector(@Nonnull double[] data)

    • HalfRealVector

      public HalfRealVector(@Nonnull int[] intData)

    • HalfRealVector

      public HalfRealVector(@Nonnull long[] longData)

  • Method Details

    • toHalfRealVector

      @Nonnull public HalfRealVector toHalfRealVector()
      Description copied from interface: RealVector
      Converts this object into a RealVector of Half precision floating-point numbers.

      As this is an abstract method, implementing classes are responsible for defining the specific conversion logic from their internal representation to a RealVector using Half objects to serialize and deserialize the vector. If this object already is a HalfRealVector this method should return this.

      Returns:
      a non-null HalfRealVector containing the Half precision floating-point representation of this object.

    • toFloatRealVector

      @Nonnull public FloatRealVector toFloatRealVector()
      Description copied from interface: RealVector
      Converts this object into a RealVector of single precision floating-point numbers.

      As this is an abstract method, implementing classes are responsible for defining the specific conversion logic from their internal representation to a RealVector using floating point numbers to serialize and deserialize the vector. If this object already is a FloatRealVector this method should return this.

      Returns:
      a non-null FloatRealVector containing the single precision floating-point representation of this object.

    • toDoubleRealVector

      @Nonnull public DoubleRealVector toDoubleRealVector()
      Description copied from interface: RealVector
      Converts this vector into a DoubleRealVector.

      This method provides a way to obtain a double-precision floating-point representation of the vector. If the vector is already an instance of DoubleRealVector, this method may return the instance itself. Otherwise, it will create a new DoubleRealVector containing the same elements, which may involve a conversion of the underlying data type.

      Returns:
      a non-null DoubleRealVector representation of this vector.

    • withData

      @Nonnull public RealVector withData(@Nonnull double[] data)

    • computeRawData

      @Nonnull protected byte[] computeRawData()
      Converts this RealVector of Half precision floating-point numbers into a byte array.

      This method iterates through the input vector, converting each Half element into its 16-bit short representation. It then serializes this short into two bytes, placing them sequentially into the resulting byte array. The final array's length will be 2 * vector.size().

      Specified by:
      computeRawData in class AbstractRealVector
      Returns:
      a new byte array representing the serialized vector data. This array is never null.

    • fromBytes

      @Nonnull public static HalfRealVector fromBytes(@Nonnull byte[] vectorBytes)
      Creates a HalfRealVector from a byte array.

      This method interprets the input byte array as a sequence of 16-bit half-precision floating-point numbers. Each consecutive pair of bytes is converted into a Half value, which then becomes a component of the resulting vector.

      Parameters:
      vectorBytes - the non-null byte array to convert
      Returns:
      a new HalfRealVector instance created from the byte array