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

Class ReadDoublePrecisionDAF

java.lang.Object

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

public final class ReadDoublePrecisionDAF
extends Object

Class for reading double precision records from DAFs readContentDPRecord, getContentSummaryRecord are the only approved means for reading double precision records to and from DAFs.
They keep track of which records have been read most recently, and of which records have been requested most often, in order to minimize the amount of time spent actually reading from external storage.

This class is based on the dafwrd.for file of the SPICE library

Since:

4.11

Author:

T0281925

Field Summary

Fields

Modifier and Type	Field and Description
static int	BYTES_DOUBLE Number of bytes that represent a double precision number.
static String	READ_ACCESS Reading access identifier.

Method Summary

Modifier and Type	Method and Description
static double[]	getContentSummaryRecord(int handle, int record, int begin, int end, boolean[] found) Read a portion of the contents of a summary record in a DAF file.
static double[]	readContentDPRecord(int handle, int record, int begin, int end, boolean[] found) Read a portion of the contents of a double precision record in a DAF file.

Methods inherited from class java.lang.Object

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

Field Detail

READ_ACCESS

public static final String READ_ACCESS

Reading access identifier.

See Also:

Constant Field Values

BYTES_DOUBLE

public static final int BYTES_DOUBLE

Number of bytes that represent a double precision number.

See Also:

Constant Field Values

Method Detail

getContentSummaryRecord

public static double[] getContentSummaryRecord(int handle,
                                               int record,
                                               int begin,
                                               int end,
                                               boolean[] found)
                                        throws PatriusException

Read a portion of the contents of a summary record in a DAF file.

Checks the DAF record buffer to see if the requested record can be returned without actually reading it from external storage. If not, it reads the record and stores it in the buffer, typically removing another record from the buffer as a result.

Bad values of begin and end are not signaled as errors. The for loop will manage.

Based on the DAFGSR routine from the SPICE library.

Parameters:

handle - the handle associated with a DAF

record - the record number of a particular double precision record within the DAF, whose contents are to be read

begin - the first word in the specified record to be returned

end - the final word in the specified record to be returned

found - (out) true if the specified record was found

Returns:

contains the specified portion of the specified record from the specified file

Throws:

PatriusException - if there is a problem in the reading of the file

readContentDPRecord

public static double[] readContentDPRecord(int handle,
                                           int record,
                                           int begin,
                                           int end,
                                           boolean[] found)
                                    throws PatriusException

Read a portion of the contents of a double precision record in a DAF file.

Checks the DAF record buffer to see if the requested record can be returned without actually reading it from external storage. If not, it reads the record and stores it in the buffer, typically removing another record from the buffer as a result.

Bad values of begin and end are not signaled as errors. The for loop will manage.

Based on the DAFGDR routine from the SPICE library.

Parameters:

handle - the handle associated with a DAF

record - the record number of a particular double precision record within the DAF, whose contents are to be read

begin - the first word in the specified record to be returned

end - the final word in the specified record to be returned

found - (out) true if the specified record was found

Returns:

contains the specified portion of the specified record from the specified file

Throws:

PatriusException - if there is a problem in the reading of the file