org.orekit.propagation.events

Class FieldFunctionalDetector<T extends CalculusFieldElement<T>>

java.lang.Object

org.orekit.propagation.events.FieldAbstractDetector<FieldFunctionalDetector<T>,T>

org.orekit.propagation.events.FieldFunctionalDetector<T>

Type Parameters:

T - the type of numbers this detector uses.

All Implemented Interfaces:

FieldEventDetector<T>

public class FieldFunctionalDetector<T extends CalculusFieldElement<T>>
extends FieldAbstractDetector<FieldFunctionalDetector<T>,T>

A detector that implements the g(FieldSpacecraftState) function using a lambda that can be set using withFunction(Function).

For example, to create a simple date detector use:

 FieldFunctionalDetector<T> d = new FieldFunctionalDetector<>(field)
     .withGFunction((s) -> s.getDate().durationFrom(triggerDate))
     .withMaxCheck(field.getZero().add(1e10));
 

Since:

10.2

Author:

Evan Ward

Field Summary

Fields inherited from class org.orekit.propagation.events.FieldAbstractDetector

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD

Constructor Summary

Constructors

Constructor and Description
FieldFunctionalDetector(Field<T> field) Create an event detector with the default values.

Method Summary

Modifier and Type	Method and Description
protected FieldFunctionalDetector<T>	create(T newMaxCheck, T newThreshold, int newMaxIter, FieldEventHandler<? super FieldFunctionalDetector<T>,T> newHandler) Build a new instance.
T	g(FieldSpacecraftState<T> s) Compute the value of the switching function.
Function<FieldSpacecraftState<T>,T>	getFunction() Get the switching function.
FieldFunctionalDetector<T>	withFunction(Function<FieldSpacecraftState<T>,T> newGFunction) Create a new event detector with a new g function, keeping all other attributes the same.

Methods inherited from class org.orekit.propagation.events.FieldAbstractDetector

eventOccurred, getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, resetState, withHandler, withMaxCheck, withMaxIter, withThreshold

Methods inherited from class java.lang.Object

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

Constructor Detail

FieldFunctionalDetector

public FieldFunctionalDetector(Field<T> field)

Create an event detector with the default values. These are FieldAbstractDetector.DEFAULT_MAXCHECK, FieldAbstractDetector.DEFAULT_THRESHOLD, FieldAbstractDetector.DEFAULT_MAX_ITER, ContinueOnEvent, and a g function that is identically unity.

Parameters:

field - on which this detector is defined.

Method Detail

g

public T g(FieldSpacecraftState<T> s)

Description copied from class: FieldAbstractDetector

Compute the value of the switching function. This function must be continuous (at least in its roots neighborhood), as the integrator will need to find its roots to locate the events.

Specified by:

g in interface FieldEventDetector<T extends CalculusFieldElement<T>>

Specified by:

g in class FieldAbstractDetector<FieldFunctionalDetector<T extends CalculusFieldElement<T>>,T extends CalculusFieldElement<T>>

Parameters:

s - the current state information: date, kinematics, attitude

Returns:

value of the switching function

create

protected FieldFunctionalDetector<T> create(T newMaxCheck,
                                            T newThreshold,
                                            int newMaxIter,
                                            FieldEventHandler<? super FieldFunctionalDetector<T>,T> newHandler)

Description copied from class: FieldAbstractDetector

Build a new instance.

Specified by:

create in class FieldAbstractDetector<FieldFunctionalDetector<T extends CalculusFieldElement<T>>,T extends CalculusFieldElement<T>>

Parameters:

newMaxCheck - maximum checking interval (s)

newThreshold - convergence threshold (s)

newMaxIter - maximum number of iterations in the event time search

newHandler - event handler to call at event occurrences

Returns:

a new instance of the appropriate sub-type

withFunction

public FieldFunctionalDetector<T> withFunction(Function<FieldSpacecraftState<T>,T> newGFunction)

Create a new event detector with a new g function, keeping all other attributes the same. It is recommended to use FieldAbstractDetector.withMaxCheck(CalculusFieldElement) and FieldAbstractDetector.withThreshold(CalculusFieldElement) to set appropriate values for this g function.

Parameters:

newGFunction - the new g function.

Returns:

a new detector with the new g function.

getFunction

public Function<FieldSpacecraftState<T>,T> getFunction()

Get the switching function.

Returns:

the function used in g(FieldSpacecraftState).