water.rapids.ast.params

Class AstNumList

java.lang.Object

water.Iced<T>

water.rapids.ast.AstRoot

water.rapids.ast.AstParameter

water.rapids.ast.params.AstNumList

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, Freezable

public class AstNumList
extends AstParameter

A collection of base/stride/cnts. Syntax: { {num | num:cnt | num:cnt:stride},* }

The bases can be unordered with dups (often used for column selection where repeated columns are allowed, and order matters). The _isList flag tracks that all cnts are 1 (and hence all strides are ignored and 1); these lists may or may not be sorted. Note that some column selection is dense (typical all-columns is: {0:MAX_INT}), and this has cnt>1.

When cnts are > 1, bases must be sorted, with base+stride*cnt always less than the next base. Typical use-case might be a list of probabilities for computing quantiles, or grid-search parameters.

Asking for a sorted integer expansion will sort the bases internally, and also demand no overlap between bases. The has(), min() and max() calls require a sorted list.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
double[]	_bases
boolean	_isList
boolean	_isSort

Constructor Summary

Constructors

Constructor and Description
AstNumList()
AstNumList(java.util.ArrayList<java.lang.Double> bases, java.util.ArrayList<java.lang.Double> strides, java.util.ArrayList<java.lang.Long> counts)
AstNumList(double d)
AstNumList(double[] list)
AstNumList(int[] list)
AstNumList(long lo, long hi_exclusive)

Method Summary

Modifier and Type	Method and Description
long	cnt()
int[]	columns(java.lang.String[] names)
Val	exec(Env env) "Execute" this AST expression, and return the result.
double[]	expand()
int[]	expand4()
long[]	expand8()
long[]	expand8Sort()
boolean	has(long v)
long	index(long v) Finds index of a given value in this number sequence, indexing start at 0.
boolean	isDense()
boolean	isEmpty()
double	max()
double	min()
AstNumList	sort()
java.lang.String	str() String representation of this Ast object in the Rapids language.
java.lang.String	toJavaString()

Methods inherited from class water.rapids.ast.AstParameter

description, example

Methods inherited from class water.rapids.ast.AstRoot

toString

Methods inherited from class water.Iced

asBytes, clone, copyOver, frozenType, read, readExternal, readJSON, reloadFromBytes, toJsonBytes, toJsonString, write, writeExternal, writeJSON

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

_bases

public final double[] _bases

_isList

public final boolean _isList

_isSort

public boolean _isSort

Constructor Detail

AstNumList

public AstNumList(java.util.ArrayList<java.lang.Double> bases,
                  java.util.ArrayList<java.lang.Double> strides,
                  java.util.ArrayList<java.lang.Long> counts)

AstNumList

public AstNumList(double d)

AstNumList

public AstNumList(long lo,
                  long hi_exclusive)

AstNumList

public AstNumList()

AstNumList

public AstNumList(double[] list)

AstNumList

public AstNumList(int[] list)

Method Detail

exec

public Val exec(Env env)

Description copied from class: AstRoot

"Execute" this AST expression, and return the result. For different ASTs this may have different interpretation. For example, consider this Rapids expression:

    (mean frame True False)

It will be parsed into the following structure:

 AstExec() instance with
    _asts = [AstMean() singleton instance,
             new AstId(frame),
             AstConst.TRUE,
             AstConst.FALSE]
 

Execution of AstExec will execute its first argument, _asts[0], verify that it produces a function (ValFun), then call AstPrimitive.apply(Env, Env.StackHelp, AstRoot[]) on that function passing down the list of _asts arguments.

The AstMean class will in turn execute all its arguments, where execution of AstId fetches the referred symbol from the environment, and execution of AstConst returns the value of that constant.

Certain other functions may choose not to evaluate all their arguments (for example boolean expressions providing short-circuit evaluation).

Specified by:

exec in class AstRoot

str

public java.lang.String str()

Description copied from class: AstRoot

String representation of this Ast object in the Rapids language. For AstPrimitives this is the name of the function; for AstParameters this is either the name of the variable, or the value of the numeric constant that the parameter represents. For more complicated constructs such as AstExec or AstFunction this method should return those objects as a Rapids string.

Specified by:

str in class AstRoot

toJavaString

public java.lang.String toJavaString()

Overrides:

toJavaString in class AstParameter

expand

public double[] expand()

sort

public AstNumList sort()

expand4

public int[] expand4()

expand8

public long[] expand8()

expand8Sort

public long[] expand8Sort()

max

public double max()

min

public double min()

cnt

public long cnt()

isDense

public boolean isDense()

isEmpty

public boolean isEmpty()

has

public boolean has(long v)

index

public long index(long v)

Finds index of a given value in this number sequence, indexing start at 0.

Parameters:

v - value

Returns:

value index (>= 0) or -1 if value is not a member of this sequence

columns

public int[] columns(java.lang.String[] names)

Overrides:

columns in class AstParameter