fr.cnes.sirius.patrius.bodies.bsp.spice

Class SpkRecord

java.lang.Object

fr.cnes.sirius.patrius.bodies.bsp.spice.SpkRecord

public final class SpkRecord
extends Object

Class for the reading and evaluation of SPK records.
The interpolation and evaluation of the Chebyshev polynome is also done here.

Since:

4.11

Author:

T0281925

Method Summary

Modifier and Type	Method and Description
static double[]	evaluateType2(double epoch, double[] record) Evaluate a single data record from an PCK or SPK segment of type 2 (Chebyshev Polynomials, 3 components).
static double[]	evaluateType3(double epoch, double[] record) Evaluate a single data record from asegment of type 3 (Chebyshev Polynomials, position and velocity).
static double[]	readType2(int handle, double[] descr, double epoch) Read a single SPK data record from a segment of type 2 (Chebyshev, position only).
static double[]	readType3(int handle, double[] descr, double epoch) Read a single SPK data record from a segment of type 3 (Chebyshev coefficients, position and velocity).

Methods inherited from class java.lang.Object

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

Method Detail

readType2

public static double[] readType2(int handle,
                                 double[] descr,
                                 double epoch)
                          throws PatriusException

Read a single SPK data record from a segment of type 2 (Chebyshev, position only).

Based on the SPKR02 routine from the SPICE library.

Parameters:

handle - File handle

descr - Segment descriptor

epoch - Evaluation epoch

Returns:

RECORD.
It is an array of data from the specified segment which, when evaluated at epoch ET, will give the state (position and velocity) of the target body identified by the input segment descriptor. The descriptor specifies the center of motion and reference frame of the state.

The structure of the record is as follows:

            +--------------------------------------+
            | record size (excluding this element) |
            +--------------------------------------+
            | Coverage interval midpoint           |
            +--------------------------------------+
            | Coverage interval radius             |
            +--------------------------------------+
            | Coeffs for X position component      |
            +--------------------------------------+
            | Coeffs for Y position component      |
            +--------------------------------------+
            | Coeffs for Z position component      |
            +--------------------------------------+
 

In the above record:

• Times are expressed as seconds past J2000 TDB
• Position components have units of km

RECORD must be declared by the caller with size large enough to accommodate the largest record that can be returned by this routine.

Throws:

PatriusException - if there is a problem reading the records.

evaluateType2

public static double[] evaluateType2(double epoch,
                                     double[] record)
                              throws PatriusException

Evaluate a single data record from an PCK or SPK segment of type 2 (Chebyshev Polynomials, 3 components).

Based on the SPKE02 routine from the SPICE library.

Parameters:

epoch - Evaluation epoch

record - Data record

Returns:

a 6-vector, in order: the components of XYZDOT are X, Y, Z, X', Y', and Z'. Units for state evaluations will be km and km/sec. Units for angles will be radians and radians/sec.

Throws:

PatriusException - if there is a problem with the number of coefs or the domain radius

readType3

public static double[] readType3(int handle,
                                 double[] descr,
                                 double epoch)
                          throws PatriusException

Read a single SPK data record from a segment of type 3 (Chebyshev coefficients, position and velocity).

Based on the SPKR03 routine from the SPICE library.

Parameters:

handle - File handle

descr - Segment descriptor

epoch - Evaluation epoch

Returns:

RECORD.
It is an array of data from the specified segment which, when evaluated at epoch ET, will give the state (position and velocity) of the target body identified by the input segment descriptor. The descriptor specifies the center of motion and reference frame of the state. The structure of the record is as follows:

            +--------------------------------------+
            | record size (excluding this element) |
            +--------------------------------------+
            | Coverage interval midpoint           |
            +--------------------------------------+
            | Coverage interval radius             |
            +--------------------------------------+
            | Coeffs for X position component      |
            +--------------------------------------+
            | Coeffs for Y position component      |
            +--------------------------------------+
            | Coeffs for Z position component      |
            +--------------------------------------+
            | Coeffs for X velocity component      |
            +--------------------------------------+
            | Coeffs for Y velocity component      |
            +--------------------------------------+
            | Coeffs for Z velocity component      |
            +--------------------------------------+
 

In the above record:

• Times are expressed as seconds past J2000 TDB
• Position components have units of km

Throws:

PatriusException - if there is a problem reading the records

evaluateType3

public static double[] evaluateType3(double epoch,
                                     double[] record)
                              throws PatriusException

Evaluate a single data record from asegment of type 3 (Chebyshev Polynomials, position and velocity).

Based on the SPKE02 routine from the SPICE library

Parameters:

epoch - Evaluation epoch

record - Data record

Returns:

a 6-vector, in order: the components of XYZDOT are X, Y, Z, X', Y', and Z'. Units for state evaluations will be km and km/sec. Units for angles will be radians and radians/sec.

Throws:

PatriusException - if there is a problem with the number of coefs or the domain radius