Package org.hipparchus.ode.nonstiff.interpolators

Class AdamsFieldStateInterpolator<T extends CalculusFieldElement<T>>

java.lang.Object

org.hipparchus.ode.sampling.AbstractFieldODEStateInterpolator<T>

org.hipparchus.ode.nonstiff.interpolators.AdamsFieldStateInterpolator<T>

Type Parameters:

T - the type of the field elements

All Implemented Interfaces:

FieldODEStateInterpolator<T>

public class AdamsFieldStateInterpolator<T extends CalculusFieldElement<T>>
extends AbstractFieldODEStateInterpolator<T>

This class implements an interpolator for Adams integrators using Nordsieck representation.

This interpolator computes dense output around the current point. The interpolation equation is based on Taylor series formulas.

See Also:

AdamsBashforthFieldIntegrator, AdamsMoultonFieldIntegrator

Constructor Summary

Constructors

Constructor	Description
AdamsFieldStateInterpolator(T stepSize, FieldODEStateAndDerivative<T> reference, T[] scaled, Array2DRowFieldMatrix<T> nordsieck, boolean isForward, FieldODEStateAndDerivative<T> globalPreviousState, FieldODEStateAndDerivative<T> globalCurrentState, FieldEquationsMapper<T> equationsMapper)	Simple constructor.

Method Summary

Modifier and Type	Method	Description
protected FieldODEStateAndDerivative<T>	computeInterpolatedStateAndDerivatives(FieldEquationsMapper<T> equationsMapper, T time, T theta, T thetaH, T oneMinusThetaH)	Compute the state and derivatives at the interpolated time.
protected AdamsFieldStateInterpolator<T>	create(boolean newForward, FieldODEStateAndDerivative<T> newGlobalPreviousState, FieldODEStateAndDerivative<T> newGlobalCurrentState, FieldODEStateAndDerivative<T> newSoftPreviousState, FieldODEStateAndDerivative<T> newSoftCurrentState, FieldEquationsMapper<T> newMapper)	Create a new instance.
Array2DRowFieldMatrix<T>	getNordsieck()	Get the Nordsieck vector.
T[]	getScaled()	Get the first scaled derivative.
static <S extends CalculusFieldElement<S>> FieldODEStateAndDerivative<S>	taylor(FieldEquationsMapper<S> equationsMapper, FieldODEStateAndDerivative<S> reference, S time, S stepSize, S[] scaled, Array2DRowFieldMatrix<S> nordsieck)	Estimate state by applying Taylor formula.

Methods inherited from class org.hipparchus.ode.sampling.AbstractFieldODEStateInterpolator

getCurrentState, getGlobalCurrentState, getGlobalPreviousState, getInterpolatedState, getMapper, getPreviousState, isCurrentStateInterpolated, isForward, isPreviousStateInterpolated, restrictStep

Methods inherited from class java.lang.Object

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

Constructor Detail

AdamsFieldStateInterpolator

public AdamsFieldStateInterpolator(T stepSize,
                                   FieldODEStateAndDerivative<T> reference,
                                   T[] scaled,
                                   Array2DRowFieldMatrix<T> nordsieck,
                                   boolean isForward,
                                   FieldODEStateAndDerivative<T> globalPreviousState,
                                   FieldODEStateAndDerivative<T> globalCurrentState,
                                   FieldEquationsMapper<T> equationsMapper)

Simple constructor.

Parameters:

stepSize - step size used in the scaled and Nordsieck arrays

reference - reference state from which Taylor expansion are estimated

scaled - first scaled derivative

nordsieck - Nordsieck vector

isForward - integration direction indicator

globalPreviousState - start of the global step

globalCurrentState - end of the global step

equationsMapper - mapper for ODE equations primary and secondary components

Method Detail

create

protected AdamsFieldStateInterpolator<T> create(boolean newForward,
                                                FieldODEStateAndDerivative<T> newGlobalPreviousState,
                                                FieldODEStateAndDerivative<T> newGlobalCurrentState,
                                                FieldODEStateAndDerivative<T> newSoftPreviousState,
                                                FieldODEStateAndDerivative<T> newSoftCurrentState,
                                                FieldEquationsMapper<T> newMapper)

Create a new instance.

Specified by:

create in class AbstractFieldODEStateInterpolator<T extends CalculusFieldElement<T>>

Parameters:

newForward - integration direction indicator

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

getScaled

public T[] getScaled()

Get the first scaled derivative.

Returns:

first scaled derivative

getNordsieck

public Array2DRowFieldMatrix<T> getNordsieck()

Get the Nordsieck vector.

Returns:

Nordsieck vector

computeInterpolatedStateAndDerivatives

protected FieldODEStateAndDerivative<T> computeInterpolatedStateAndDerivatives(FieldEquationsMapper<T> equationsMapper,
                                                                               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 AbstractFieldODEStateInterpolator<T extends CalculusFieldElement<T>>

Parameters:

equationsMapper - 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

taylor

public static <S extends CalculusFieldElement<S>> FieldODEStateAndDerivative<S> taylor(FieldEquationsMapper<S> equationsMapper,
                                                                                       FieldODEStateAndDerivative<S> reference,
                                                                                       S time,
                                                                                       S stepSize,
                                                                                       S[] scaled,
                                                                                       Array2DRowFieldMatrix<S> nordsieck)

Estimate state by applying Taylor formula.

Type Parameters:

S - the type of the field elements

Parameters:

equationsMapper - mapper for ODE equations primary and secondary components

reference - reference state

time - time at which state must be estimated

stepSize - step size used in the scaled and Nordsieck arrays

scaled - first scaled derivative

nordsieck - Nordsieck vector

Returns:

estimated state