Module org.bzdev.math

Package org.bzdev.math.rv

Class DetermIATimeRV

java.lang.Object

org.bzdev.math.rv.RandomVariable<Long>

org.bzdev.math.rv.LongRandomVariable

org.bzdev.math.rv.InterarrivalTimeRV

org.bzdev.math.rv.DetermIATimeRV

All Implemented Interfaces:

Cloneable, RandomVariableOps<Long>

public class DetermIATimeRV
extends InterarrivalTimeRV

Random variable that generates a deterministic sequence of long values.

Constructor Summary

Constructors

Constructor	Description
DetermIATimeRV(long[] values)	Constructor for a repeating sequence.
DetermIATimeRV(long[] values, long finalValue)	Constructor.
DetermIATimeRV(long value, long finalValue)	Constructor given a starting value and a final value.

Method Summary

Modifier and Type	Method	Description
protected int	getCharacteristics()	Spliterator characteristics.
long	getFinalValue()	Get the final value for this random variable.
long[]	getValues()	Get the values for this random variable.
boolean	isRepeating()	Determine if this random variable repeats its sequence.
Long	next()	Get the next value for a random variable.
void	setMaximum(Long max, boolean closed)	Set the maximum value for a random variable.
void	setMinimum(Long min, boolean closed)	Set the minimum value for a random variable.
String	toString()

Methods inherited from class org.bzdev.math.rv.LongRandomVariable

getMaximum, getMaximumClosed, getMinimum, getMinimumClosed, parallelStream, parallelStream, rangeTestFailed, rangeTestNeeded, setRequiredMaximum, setRequiredMinimum, spliterator, spliterator, stream, stream, tightenMaximum, tightenMaximumS, tightenMinimum, tightenMinimumS

Methods inherited from class org.bzdev.math.rv.RandomVariable

clone

Methods inherited from class java.lang.Object

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

Constructor Details

DetermIATimeRV

public DetermIATimeRV(long[] values,
 long finalValue)

Constructor. When next is called, after the values in the first argument are returned in order, the final value is returned persistently from then on.

Parameters:

values - the values of the random variable in the order in which these are returned

finalValue - the final value of the random variable

DetermIATimeRV

public DetermIATimeRV(long[] values)

Constructor for a repeating sequence.

Parameters:

values - the values of the random variable in the order in which these are returned

DetermIATimeRV

public DetermIATimeRV(long value,
 long finalValue)

Constructor given a starting value and a final value.

Parameters:

value - the starting value of the random variable

finalValue - the subsequent value of the random variable

Method Details

getValues

public long[] getValues()

Get the values for this random variable.

Returns:

the values in the order in which they are generated, excluding a final value for the non-repeating case

getFinalValue

public long getFinalValue()

Get the final value for this random variable.

Returns:

the final value; 0 if this random variable repeats

isRepeating

public boolean isRepeating()

Determine if this random variable repeats its sequence.

Returns:

true if it is repeating; false otherwise

setMinimum

public void setMinimum(Long min,
 boolean closed)
                throws UnsupportedOperationException,
IllegalArgumentException

Description copied from class: RandomVariable

Set the minimum value for a random variable.

Specified by:

setMinimum in interface RandomVariableOps<Long>

Overrides:

setMinimum in class LongRandomVariable

Parameters:

min - minimum value.

closed - true if the minimum value is part of the range; false if it is a lower bound on the range

Throws:

UnsupportedOperationException - the random variable's type does not have an order imposed on it or the operation is not supported for implementation reasons

IllegalArgumentException - an argument is out of range

setMaximum

public void setMaximum(Long max,
 boolean closed)
                throws UnsupportedOperationException,
IllegalArgumentException

Description copied from class: RandomVariable

Set the maximum value for a random variable.

Specified by:

setMaximum in interface RandomVariableOps<Long>

Overrides:

setMaximum in class LongRandomVariable

Parameters:

max - maximum value.

closed - true if the minimum value is part of the range; false if it is a lower bound on the range

Throws:

UnsupportedOperationException - the random variable's type does not have an order imposed on it or the operation is not supported for implementation reasons

IllegalArgumentException - an argument is out of range

next

public Long next()

Description copied from class: RandomVariable

Get the next value for a random variable. In general, each value will be independent of the last.

Specified by:

next in interface RandomVariableOps<Long>

Specified by:

next in class RandomVariable<Long>

Returns:

the next value

toString

public String toString()

Overrides:

toString in class Object

getCharacteristics

protected int getCharacteristics()

Description copied from class: RandomVariable

Spliterator characteristics. The characteristics returned should not include Spliterator.SIZED or Spliterator.SUBSIZED. The default value is Spliterator.IMMUTABLE | Spliterator.NONNULL. If the characteristics include Spliterator.ORDERED, Spliterator.trySplit() will return null. The characteristics include Spliterator.ORDERED for the random variables in this package that return a deterministic sequence of values.

Overrides:

getCharacteristics in class RandomVariable<Long>

Returns:

the characteristics