Class IntColumn

    • Field Detail

      • data

        protected final it.unimi.dsi.fastutil.ints.IntArrayList data
    • Constructor Detail

      • IntColumn

        protected IntColumn​(String name,
                            it.unimi.dsi.fastutil.ints.IntArrayList data)
    • Method Detail

      • create

        public static IntColumn create​(String name,
                                       int initialSize)
      • indexColumn

        public static IntColumn indexColumn​(String columnName,
                                            int size,
                                            int startsWith)
        Returns a new numeric column initialized with the given name and size. The values in the column are integers beginning at startsWith and continuing through size (exclusive), monotonically increasing by 1 TODO consider a generic fill function including steps or random samples from various distributions
      • valueHash

        public int valueHash​(int rowNumber)
        Returns an int suitable as a hash for the value in this column at the given index
        Specified by:
        valueHash in interface Column<Integer>
      • equals

        public boolean equals​(int rowNumber1,
                              int rowNumber2)
        Returns true if the value in this column at rowNumber1 is equal to the value at rowNumber2
        Specified by:
        equals in interface Column<Integer>
      • clear

        public void clear()
        Removes all elements TODO: Make this return this column
        Specified by:
        clear in interface Column<Integer>
      • valueIsMissing

        public static boolean valueIsMissing​(int value)
      • get

        public Integer get​(int index)
        Returns the value at the given zero-based index
        Specified by:
        get in interface Column<Integer>
      • asIntArray

        public int[] asIntArray()
      • unique

        public IntColumn unique()
        Returns a column of the same type containing only the unique values
        Specified by:
        unique in interface Column<Integer>
        Returns:
        a Column
      • top

        public IntColumn top​(int n)
        Returns the largest ("top") n values in the column TODO(lwhite): Consider whether this should exclude missing
        Specified by:
        top in class NumberColumn<IntColumn,​Integer>
        Parameters:
        n - The maximum number of records to return. The actual number will be smaller if n is greater than the number of observations in the column
        Returns:
        A list, possibly empty, of the largest observations
      • bottom

        public IntColumn bottom​(int n)
        Returns the smallest ("bottom") n values in the column TODO(lwhite): Consider whether this should exclude missing
        Specified by:
        bottom in class NumberColumn<IntColumn,​Integer>
        Parameters:
        n - The maximum number of records to return. The actual number will be smaller if n is greater than the number of observations in the column
        Returns:
        A list, possibly empty, of the smallest n observations
      • lag

        public IntColumn lag​(int n)
        Returns a column of the same type and size as the receiver, containing the receivers values offset by n.

        For example if you lag a column containing 2, 3, 4 by 1, you get a column containing NA, 2, 3

        Specified by:
        lag in interface Column<Integer>
        Specified by:
        lag in interface NumericColumn<Integer>
      • append

        public IntColumn append​(int i)
      • intIterator

        public it.unimi.dsi.fastutil.ints.IntIterator intIterator()
      • asObjectArray

        public Integer[] asObjectArray()
        Returns an array of objects as appropriate for my type of column
        Specified by:
        asObjectArray in interface Column<Integer>
      • set

        public IntColumn set​(int i,
                             Integer val)
        Sets the value at index row to the given value and return this column
        Specified by:
        set in interface Column<Integer>
      • set

        public IntColumn set​(int i,
                             int val)
      • append

        public IntColumn append​(Column<Integer> column)
        Appends all the values in the argument to the bottom of this column and return this column
        Specified by:
        append in interface Column<Integer>
      • append

        public IntColumn append​(Column<Integer> column,
                                int row)
        Appends the value at the given row in the given column to the bottom of this column and return this column
        Specified by:
        append in interface Column<Integer>
      • set

        public IntColumn set​(int row,
                             Column<Integer> column,
                             int sourceRow)
        Sets the value at row to the value at sourceRow in the given column and return this column
        Specified by:
        set in interface Column<Integer>
      • asBytes

        public byte[] asBytes​(int rowNumber)
        Returns the contents of the cell at rowNumber as a byte[].
        Specified by:
        asBytes in interface Column<Integer>
        Parameters:
        rowNumber - index of the row
        Returns:
        content as byte[]
      • countUnique

        public int countUnique()
        Returns the count of unique values in this column.
        Specified by:
        countUnique in interface Column<Integer>
        Returns:
        unique values as int
      • getInt

        public int getInt​(int row)
        Returns the value at the given index. The actual value is returned if the ColumnType is INTEGER. Otherwise the value is rounded as described below.

        Returns the closest int to the argument, with ties rounding to positive infinity.

        Special cases:

        • If the argument is NaN, the result is 0.
        • If the argument is positive infinity or any value greater than or equal to the value of Integer.MAX_VALUE, an error will be thrown
        Parameters:
        row - the index of the value to be rounded to an integer.
        Returns:
        the value of the argument rounded to the nearest int value.
        Throws:
        ClassCastException - if the absolute value of the value to be rounded is too large to be cast to an int
      • isMissingValue

        public boolean isMissingValue​(int value)
      • sortAscending

        public void sortAscending()
        Sorts my values in ascending order
        Specified by:
        sortAscending in interface Column<Integer>
      • sortDescending

        public void sortDescending()
        Sorts my values in descending order
        Specified by:
        sortDescending in interface Column<Integer>
      • appendObj

        public IntColumn appendObj​(Object obj)
        Appends the given value to the bottom of this column and return this column
        Specified by:
        appendObj in interface Column<Integer>
      • appendCell

        public IntColumn appendCell​(String value)
        Add one element to the bottom of this column and set its value to the parsed value of the given String. Parsing is type-specific
        Specified by:
        appendCell in interface Column<Integer>
      • getUnformattedString

        public String getUnformattedString​(int row)
        Returns a String representation of the value at index r, without any formatting applied
        Specified by:
        getUnformattedString in interface Column<Integer>
      • asLongColumn

        public LongColumn asLongColumn()
        Returns a new LongColumn containing a value for each value in this column

        A widening primitive conversion from int to long does not lose any information at all; the numeric value is preserved exactly.

        A missing value in the receiver is converted to a missing value in the result

        Specified by:
        asLongColumn in interface NumericColumn<Integer>
      • asFloatColumn

        public FloatColumn asFloatColumn()
        Returns a new FloatColumn containing a value for each value in this column, truncating if necessary.

        A widening primitive conversion from an int to a float does not lose information about the overall magnitude of a numeric value. It may, however, result in loss of precision - that is, the result may lose some of the least significant bits of the value. In this case, the resulting floating-point value will be a correctly rounded version of the integer value, using IEEE 754 round-to-nearest mode.

        Despite the fact that a loss of precision may occur, a widening primitive conversion never results in a run-time exception.

        A missing value in the receiver is converted to a missing value in the result

        Specified by:
        asFloatColumn in interface NumericColumn<Integer>
      • isIn

        public Selection isIn​(int... numbers)
      • isNotIn

        public Selection isNotIn​(int... numbers)
      • asDoubleColumn

        public DoubleColumn asDoubleColumn()
        Returns a new DoubleColumn containing a value for each value in this column, truncating if necessary.

        A widening primitive conversion from an int to a double does not lose information about the overall magnitude of a numeric value. It may, however, result in loss of precision - that is, the result may lose some of the least significant bits of the value. In this case, the resulting floating-point value will be a correctly rounded version of the integer value, using IEEE 754 round-to-nearest mode.

        Despite the fact that a loss of precision may occur, a widening primitive conversion never results in a run-time exception.

        A missing value in the receiver is converted to a missing value in the result

        Specified by:
        asDoubleColumn in interface NumericColumn<Integer>
      • asShortColumn

        public ShortColumn asShortColumn()
        Returns a new ShortColumn containing a value for each value in this column

        A narrowing conversion of a signed integer to an integral type T simply discards all but the n lowest order bits, where n is the number of bits used to represent type T. In addition to a possible loss of information about the magnitude of the numeric value, this may cause the sign of the resulting value to differ from the sign of the input value.

        In other words, if the element being converted is larger (or smaller) than Short.MAX_VALUE (or Short.MIN_VALUE) you will not get a conventionally good conversion.

        Despite the fact that overflow, underflow, or other loss of information may occur, a narrowing primitive conversion never results in a run-time exception.

        A missing value in the receiver is converted to a missing value in the result

        Specified by:
        asShortColumn in interface NumericColumn<Integer>
      • setMissing

        public IntColumn setMissing​(int r)
        Sets the value at index i to the missing-value indicator for this column type, and return this column
        Specified by:
        setMissing in interface Column<Integer>
      • asSet

        public Set<Integer> asSet()
        Returns a Set containing all the unique values in this column
        Specified by:
        asSet in interface Column<Integer>