org.apache.commons.math3.ode

Class EquationsMapper

java.lang.Object

org.apache.commons.math3.ode.EquationsMapper

All Implemented Interfaces:

java.io.Serializable

public class EquationsMapper
extends java.lang.Object
implements java.io.Serializable

Class mapping the part of a complete state or derivative that pertains to a specific differential equation.

Instances of this class are guaranteed to be immutable.

Since:

3.0

See Also:

SecondaryEquations, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private int	dimension Dimension of the secondary state parameters.
private int	firstIndex Index of the first equation element in complete state arrays.
private static long	serialVersionUID Serializable UID.

Constructor Summary

Constructors

Constructor and Description
EquationsMapper(int firstIndex, int dimension) simple constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	extractEquationData(double[] complete, double[] equationData) Extract equation data from a complete state or derivative array.
int	getDimension() Get the dimension of the secondary state parameters.
int	getFirstIndex() Get the index of the first equation element in complete state arrays.
void	insertEquationData(double[] equationData, double[] complete) Insert equation data into a complete state or derivative array.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

Serializable UID.

See Also:

Constant Field Values

firstIndex

private final int firstIndex

Index of the first equation element in complete state arrays.

dimension

private final int dimension

Dimension of the secondary state parameters.

Constructor Detail

EquationsMapper

public EquationsMapper(int firstIndex,
               int dimension)

simple constructor.

Parameters:

firstIndex - index of the first equation element in complete state arrays

dimension - dimension of the secondary state parameters

Method Detail

getFirstIndex

public int getFirstIndex()

Get the index of the first equation element in complete state arrays.

Returns:

index of the first equation element in complete state arrays

getDimension

public int getDimension()

Get the dimension of the secondary state parameters.

Returns:

dimension of the secondary state parameters

extractEquationData

public void extractEquationData(double[] complete,
                       double[] equationData)
                         throws DimensionMismatchException

Extract equation data from a complete state or derivative array.

Parameters:

complete - complete state or derivative array from which equation data should be retrieved

equationData - placeholder where to put equation data

Throws:

DimensionMismatchException - if the dimension of the equation data does not match the mapper dimension

insertEquationData

public void insertEquationData(double[] equationData,
                      double[] complete)
                        throws DimensionMismatchException

Insert equation data into a complete state or derivative array.

Parameters:

equationData - equation data to be inserted into the complete array

complete - placeholder where to put equation data (only the part corresponding to the equation will be overwritten)

Throws:

DimensionMismatchException - if the dimension of the equation data does not match the mapper dimension