agi.foundation.numericalmethods

(agi.foundation.core-2025r1.jar)

Class DurationFunctionDetails

java.lang.Object

agi.foundation.numericalmethods.DurationFunctionDetails

public class DurationFunctionDetails
extends Object

Holds details of a function to be explored with DurationFunctionExplorer.

Constructor Summary

Constructors

Constructor and Description
DurationFunctionDetails() Initializes a new instance.
DurationFunctionDetails(DurationSimpleFunction function) Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
double	getCurrentValue() Gets the value of the function at the CurrentDuration (get).
boolean	getCurrentValueIsValid() Gets a value indicating whether CurrentValue (get) is valid.
HierarchicalLogger	getDebuggingLogger() Gets the HierarchicalLogger, used to provide debugging output for the findings analysis.
DurationFunctionExplorer	getExplorer() Gets the DurationFunctionExplorer that is exploring this function.
ConvergenceCriteria	getExtremumConvergenceCriteria() Gets the criteria used for convergence when searching for a precise local extremum of this function.
double	getExtremumValueTolerance() Gets the tolerance with which to converge on function value when finding a local extremum of this function.
DurationSimpleFunction	getFunction() Gets the function to explore.
double	getPreviousPreviousValue() Gets the value of the function at the PreviousPreviousDuration (get).
boolean	getPreviousPreviousValueIsValid() Gets a value indicating whether PreviousPreviousValue (get) is valid.
double	getPreviousValue() Gets the value of the function at the PreviousDuration (get).
boolean	getPreviousValueIsValid() Gets a value indicating whether PreviousValue (get) is valid.
DurationFunctionThresholdCollection	getThresholds() Gets the collection of thresholds of interest.
void	setDebuggingLogger(HierarchicalLogger value) Sets the HierarchicalLogger, used to provide debugging output for the findings analysis.
void	setExtremumConvergenceCriteria(ConvergenceCriteria value) Sets the criteria used for convergence when searching for a precise local extremum of this function.
void	setExtremumValueTolerance(double value) Sets the tolerance with which to converge on function value when finding a local extremum of this function.
void	setFunction(DurationSimpleFunction value) Sets the function to explore.

Methods inherited from class java.lang.Object

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

Constructor Detail

DurationFunctionDetails

public DurationFunctionDetails()

Initializes a new instance.

DurationFunctionDetails

public DurationFunctionDetails(DurationSimpleFunction function)

Initializes a new instance.

Parameters:

function - The function to explore.

Method Detail

getExplorer

public final DurationFunctionExplorer getExplorer()

Gets the DurationFunctionExplorer that is exploring this function.

getFunction

public final DurationSimpleFunction getFunction()

Gets the function to explore.

setFunction

public final void setFunction(DurationSimpleFunction value)

Sets the function to explore.

getThresholds

@Nonnull
public final DurationFunctionThresholdCollection getThresholds()

Gets the collection of thresholds of interest.

getExtremumValueTolerance

public final double getExtremumValueTolerance()

Gets the tolerance with which to converge on function value when finding a local extremum of this function. By default, this property has the value 0.0, but it is ignored because ExtremumConvergenceCriteria (get / set) is set to ConvergenceCriteria.VARIABLE.

setExtremumValueTolerance

public final void setExtremumValueTolerance(double value)

Sets the tolerance with which to converge on function value when finding a local extremum of this function. By default, this property has the value 0.0, but it is ignored because ExtremumConvergenceCriteria (get / set) is set to ConvergenceCriteria.VARIABLE.

getExtremumConvergenceCriteria

@Nonnull
public final ConvergenceCriteria getExtremumConvergenceCriteria()

Gets the criteria used for convergence when searching for a precise local extremum of this function. When set to ConvergenceCriteria.VARIABLE, the ExtremumDurationTolerance (get / set) is used. When set to ConvergenceCriteria.FUNCTION, the ExtremumValueTolerance (get / set) is used. Convergence can also be allowed on ConvergenceCriteria.EITHER criteria or ConvergenceCriteria.BOTH criteria can be required. By default, this property has the value ConvergenceCriteria.VARIABLE.

setExtremumConvergenceCriteria

public final void setExtremumConvergenceCriteria(@Nonnull
                                                 ConvergenceCriteria value)

Sets the criteria used for convergence when searching for a precise local extremum of this function. When set to ConvergenceCriteria.VARIABLE, the ExtremumDurationTolerance (get / set) is used. When set to ConvergenceCriteria.FUNCTION, the ExtremumValueTolerance (get / set) is used. Convergence can also be allowed on ConvergenceCriteria.EITHER criteria or ConvergenceCriteria.BOTH criteria can be required. By default, this property has the value ConvergenceCriteria.VARIABLE.

getCurrentValue

public final double getCurrentValue()

Gets the value of the function at the CurrentDuration (get).

Throws:

IllegalStateException - The current value is not available because the function was not sampled for the CurrentDuration (get).

getCurrentValueIsValid

public final boolean getCurrentValueIsValid()

Gets a value indicating whether CurrentValue (get) is valid. CurrentValue (get) is invalid if the function was not sampled for the CurrentDuration (get).

getPreviousValue

public final double getPreviousValue()

Gets the value of the function at the PreviousDuration (get).

Throws:

IllegalStateException - The current value is not available because the function was not sampled for the PreviousDuration (get).

getPreviousValueIsValid

public final boolean getPreviousValueIsValid()

Gets a value indicating whether PreviousValue (get) is valid. PreviousValue (get) is invalid if the function was not sampled for the PreviousDuration (get).

getPreviousPreviousValue

public final double getPreviousPreviousValue()

Gets the value of the function at the PreviousPreviousDuration (get).

Throws:

IllegalStateException - The current value is not available because the function was not sampled for the PreviousPreviousDuration (get).

getPreviousPreviousValueIsValid

public final boolean getPreviousPreviousValueIsValid()

Gets a value indicating whether PreviousPreviousValue (get) is valid. PreviousPreviousValue (get) is invalid if the function was not sampled for the PreviousPreviousDuration (get).

getDebuggingLogger

public final HierarchicalLogger getDebuggingLogger()

Gets the HierarchicalLogger, used to provide debugging output for the findings analysis.

setDebuggingLogger

public final void setDebuggingLogger(HierarchicalLogger value)

Sets the HierarchicalLogger, used to provide debugging output for the findings analysis.