org.apache.commons.math3.ode.nonstiff

Class LutherFieldStepInterpolator<T extends RealFieldElement<T>>

java.lang.Object

org.apache.commons.math3.ode.sampling.AbstractFieldStepInterpolator<T>

org.apache.commons.math3.ode.nonstiff.RungeKuttaFieldStepInterpolator<T>

org.apache.commons.math3.ode.nonstiff.LutherFieldStepInterpolator<T>

Type Parameters:

T - the type of the field elements

All Implemented Interfaces:

FieldStepInterpolator<T>

 class LutherFieldStepInterpolator<T extends RealFieldElement<T>>
extends RungeKuttaFieldStepInterpolator<T>

This class represents an interpolator over the last step during an ODE integration for the 6th order Luther integrator.

This interpolator computes dense output inside the last step computed. The interpolation equation is consistent with the integration scheme.

Since:

3.6

See Also:

LutherFieldIntegrator

Field Summary

Fields

Modifier and Type	Field and Description
private T	c5a -49 - 49 q.
private T	c5b 392 + 287 q.
private T	c5c -637 - 357 q.
private T	c5d 833 + 343 q.
private T	c6a -49 + 49 q.
private T	c6b -392 - 287 q.
private T	c6c -637 + 357 q.
private T	c6d 833 - 343 q.
private T	d5a 49 + 49 q.
private T	d5b -1372 - 847 q.
private T	d5c 2254 + 1029 q
private T	d6a 49 - 49 q.
private T	d6b -1372 + 847 q.
private T	d6c 2254 - 1029 q

Constructor Summary

Constructors

Constructor and Description
LutherFieldStepInterpolator(Field<T> field, boolean forward, T[][] yDotK, FieldODEStateAndDerivative<T> globalPreviousState, FieldODEStateAndDerivative<T> globalCurrentState, FieldODEStateAndDerivative<T> softPreviousState, FieldODEStateAndDerivative<T> softCurrentState, FieldEquationsMapper<T> mapper) Simple constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected FieldODEStateAndDerivative<T>	computeInterpolatedStateAndDerivatives(FieldEquationsMapper<T> mapper, T time, T theta, T thetaH, T oneMinusThetaH) Compute the state and derivatives at the interpolated time.
protected LutherFieldStepInterpolator<T>	create(Field<T> newField, boolean newForward, T[][] newYDotK, FieldODEStateAndDerivative<T> newGlobalPreviousState, FieldODEStateAndDerivative<T> newGlobalCurrentState, FieldODEStateAndDerivative<T> newSoftPreviousState, FieldODEStateAndDerivative<T> newSoftCurrentState, FieldEquationsMapper<T> newMapper) Create a new instance.

Methods inherited from class org.apache.commons.math3.ode.nonstiff.RungeKuttaFieldStepInterpolator

create, currentStateLinearCombination, derivativeLinearCombination, previousStateLinearCombination

Methods inherited from class org.apache.commons.math3.ode.sampling.AbstractFieldStepInterpolator

getCurrentState, getGlobalCurrentState, getGlobalPreviousState, getInterpolatedState, getPreviousState, isForward, restrictStep

Methods inherited from class java.lang.Object

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

Field Detail

c5a

private final T extends RealFieldElement<T> c5a

-49 - 49 q.

c5b

private final T extends RealFieldElement<T> c5b

392 + 287 q.

c5c

private final T extends RealFieldElement<T> c5c

-637 - 357 q.

c5d

private final T extends RealFieldElement<T> c5d

833 + 343 q.

c6a

private final T extends RealFieldElement<T> c6a

-49 + 49 q.

c6b

private final T extends RealFieldElement<T> c6b

-392 - 287 q.

c6c

private final T extends RealFieldElement<T> c6c

-637 + 357 q.

c6d

private final T extends RealFieldElement<T> c6d

833 - 343 q.

d5a

private final T extends RealFieldElement<T> d5a

49 + 49 q.

d5b

private final T extends RealFieldElement<T> d5b

-1372 - 847 q.

d5c

private final T extends RealFieldElement<T> d5c

2254 + 1029 q

d6a

private final T extends RealFieldElement<T> d6a

49 - 49 q.

d6b

private final T extends RealFieldElement<T> d6b

-1372 + 847 q.

d6c

private final T extends RealFieldElement<T> d6c

2254 - 1029 q

Constructor Detail

LutherFieldStepInterpolator

LutherFieldStepInterpolator(Field<T> field,
                           boolean forward,
                           T[][] yDotK,
                           FieldODEStateAndDerivative<T> globalPreviousState,
                           FieldODEStateAndDerivative<T> globalCurrentState,
                           FieldODEStateAndDerivative<T> softPreviousState,
                           FieldODEStateAndDerivative<T> softCurrentState,
                           FieldEquationsMapper<T> mapper)

Simple constructor.

Parameters:

field - field to which the time and state vector elements belong

forward - integration direction indicator

yDotK - slopes at the intermediate points

globalPreviousState - start of the global step

globalCurrentState - end of the global step

softPreviousState - start of the restricted step

softCurrentState - end of the restricted step

mapper - equations mapper for the all equations

Method Detail

create

protected LutherFieldStepInterpolator<T> create(Field<T> newField,
                                    boolean newForward,
                                    T[][] newYDotK,
                                    FieldODEStateAndDerivative<T> newGlobalPreviousState,
                                    FieldODEStateAndDerivative<T> newGlobalCurrentState,
                                    FieldODEStateAndDerivative<T> newSoftPreviousState,
                                    FieldODEStateAndDerivative<T> newSoftCurrentState,
                                    FieldEquationsMapper<T> newMapper)

Create a new instance.

Specified by:

create in class RungeKuttaFieldStepInterpolator<T extends RealFieldElement<T>>

Parameters:

newField - field to which the time and state vector elements belong

newForward - integration direction indicator

newYDotK - slopes at the intermediate points

newGlobalPreviousState - start of the global step

newGlobalCurrentState - end of the global step

newSoftPreviousState - start of the restricted step

newSoftCurrentState - end of the restricted step

newMapper - equations mapper for the all equations

Returns:

a new instance

computeInterpolatedStateAndDerivatives

protected FieldODEStateAndDerivative<T> computeInterpolatedStateAndDerivatives(FieldEquationsMapper<T> mapper,
                                                                   T time,
                                                                   T theta,
                                                                   T thetaH,
                                                                   T oneMinusThetaH)

Compute the state and derivatives at the interpolated time. This is the main processing method that should be implemented by the derived classes to perform the interpolation.

Specified by:

computeInterpolatedStateAndDerivatives in class AbstractFieldStepInterpolator<T extends RealFieldElement<T>>

Parameters:

mapper - mapper for ODE equations primary and secondary components

time - interpolation time

theta - normalized interpolation abscissa within the step (theta is zero at the previous time step and one at the current time step)

thetaH - time gap between the previous time and the interpolated time

oneMinusThetaH - time gap between the interpolated time and the current time

Returns:

interpolated state and derivatives