Package org.apache.sis.math

Class ArrayVector<E extends Number>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<Number>

org.apache.sis.math.Vector

org.apache.sis.math.ArrayVector<E>

Type Parameters:

E - the base type of elements in the vector.

All Implemented Interfaces:

Serializable, Iterable<Number>, Collection<Number>, List<Number>, RandomAccess, CheckedContainer<E>

Direct Known Subclasses:

ArrayVector.ASCII, ArrayVector.Bytes, ArrayVector.Doubles, ArrayVector.Floats, ArrayVector.Integers, ArrayVector.Longs, ArrayVector.Raw, ArrayVector.Shorts, PackedVector

abstract class ArrayVector<E extends Number>
extends Vector
implements CheckedContainer<E>, Serializable

A vector backed by an array of a primitive type. This class does not copy the array, so changes in the underlying array is reflected in this vector and vice-versa.

Since:

0.8

Version:

1.2

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	ArrayVector.ASCII	A vector backed by an array of type String[].
private static class	ArrayVector.Bytes	A vector backed by an array of type byte[].
(package private) static final class	ArrayVector.Decimal	A vector backed by an array of type float[] to be converted to double in a way that minimizes the errors when represented in base 10.
(package private) static final class	ArrayVector.Doubles	A vector backed by an array of type double[].
private static class	ArrayVector.Floats	A vector backed by an array of type float[].
private static class	ArrayVector.Integers	A vector backed by an array of type int[].
private static class	ArrayVector.Longs	A vector backed by an array of type long[].
private static final class	ArrayVector.Raw	A vector backed by an array of type Number[].
private static class	ArrayVector.Shorts	A vector backed by an array of type short[].
private static final class	ArrayVector.UnsignedBytes	A vector backed by an array of type byte[] to be interpreted as unsigned values.
private static final class	ArrayVector.UnsignedIntegers	A vector backed by an array of type int[] to be interpreted as unsigned values.
private static final class	ArrayVector.UnsignedLongs	A vector backed by an array of type long[] to be interpreted as unsigned values.
private static final class	ArrayVector.UnsignedShorts	A vector backed by an array of type short[] to be interpreted as unsigned values.

Field Summary

Fields

Modifier and Type	Field	Description
private static final long	serialVersionUID	For cross-version compatibility.

Fields inherited from class org.apache.sis.math.Vector

PRIME

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
ArrayVector()	For sub-classes constructor.

Method Summary

Modifier and Type	Method	Description
(package private) static Vector	compress(Vector source, double tolerance)	Returns a vector with the same data than the given vector but encoded in a more compact way, or null if this method cannot do better than the given Vector instance.
(package private) static Vector	compress(Vector source, long min, long max)	Returns a vector with the same data than the given vector but encoded in a more compact way, or null if this method cannot do better than the given Vector instance.
boolean	isNaN(int index)	Default implementation for the convenience of wrapper of integer types.
(package private) static Vector	newInstance(Object array, boolean isUnsigned)	Creates a new instance.
(package private) void	verifyType(Number value, byte expected)	Verifies that the given value can be casted to the expected type.

Methods inherited from class org.apache.sis.math.Vector

backingVector, buffer, byteValue, compress, concatenate, copy, create, create, createConcatenate, createForDecimal, createSequence, createSequence, createSubSampling, createTransform, doubleValue, doubleValues, equals, equals, fill, floatValue, floatValues, get, getElementType, hashCode, increment, indexOf, intValue, isEmptyOrNaN, isInteger, isSinglePrecision, isUnsigned, longValue, pick, range, range, repeat, repetitions, reverse, set, shortValue, size, stringValue, subList, subSampling, subtract, toBacking, toString, transform, warning

Methods inherited from class java.util.AbstractList

add, add, addAll, clear, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, removeRange

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.sis.util.collection.CheckedContainer

getElementType

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, remove, removeAll, replaceAll, retainAll, sort, spliterator, toArray, toArray

Field Details

serialVersionUID

private static final long serialVersionUID

For cross-version compatibility.

See Also:

• Constant Field Values

Constructor Details

ArrayVector

ArrayVector()

For sub-classes constructor.

Method Details

newInstance

static Vector newInstance(Object array,
 boolean isUnsigned)
                   throws IllegalArgumentException

Creates a new instance.

Throws:

IllegalArgumentException - if the type of the given object is not recognized by the method.

compress

static Vector compress(Vector source,
 long min,
 long max)

Returns a vector with the same data than the given vector but encoded in a more compact way, or null if this method cannot do better than the given Vector instance. This method shall be invoked only for vector of integer values (this is not verified).

compress

static Vector compress(Vector source,
 double tolerance)

Returns a vector with the same data than the given vector but encoded in a more compact way, or null if this method cannot do better than the given Vector instance. This method shall be invoked only for vector of floating point values (this is not verified).

isNaN

public boolean isNaN(int index)

Default implementation for the convenience of wrapper of integer types.

Specified by:

isNaN in class Vector

Parameters:

index - the index in the [0 … size-1] range.

Returns:

true if the value at the given index is NaN.

verifyType

void verifyType(Number value,
 byte expected)

Verifies that the given value can be casted to the expected type. The expected type must be one of the Numbers constants.