asdm::ArrayTime Class Reference

#include <ArrayTime.h>

Inherits asdm::Interval.

List of all members.


Detailed Description

The ArrayTime class implements the concept of a point in time, implemented as an Interval of time since 17 November 1858 00:00:00 UTC, the beginning of the modified Julian Day.

All dates are assumed to be in the Gregorian calendar, including those prior to October 15, 1582. So, if you are interested in very old dates, this isn't the most convenient class to use.

Internally the time is kept in units of nanoseconds (10-9 seconds). The base time is 17 November 1858 00:00:00 UTC, and the maximum time is to the year 2151 (2151-02-25T23:47:16.854775807). This differs from the OMG Time service The OMG time is in units of 100 nanoseconds using the beginning of the Gregorian calandar,15 October 1582 00:00:00 UTC, as the base time. The reason for this increased accuracy is that the Control system is capable of measuring time to an accuracy of 40 nanoseconds. Therefore, by adhering to the representation of time used in the OMG Time Serivce we would be losing precision.

The Time class is an extension of the Interval class, since all times are intervals since 17 November 1858 00:00:00 UTC.

All times in this class are assumed to be International Atomic Time (TAI). A specific TAI time differs from the corresponding UTC time by an offset that is an integral number of seconds.

In the methods that give various quantities associated with calendar times, this class does not apply any UTC corrections. Therefore, if you use these methods to produce calendar times, the results will differ from civil time by a few seconds. The classes UTCTime and LocalTime take the UTC and timezone corrections into account.

The main reference used in crafting these methods is Astronomical Algorithms by Jean Meeus, second edition, 2000, Willmann-Bell, Inc., ISBN 0-943396-61-1. See chapter 7, "Julian day", and chapter 12, "Sidereal Time".

Version:
1.0 12 January, 2004
Author:
Allen Farris
Version:
1.1 Aug 8, 2006
Author:
Michel Caillat added toBin/fromBin methods.


Public Member Functions

 ArrayTime (const string &s)
 ArrayTime (const ArrayTime &t)
 ArrayTime (const IDLArrayTime &t)
 ArrayTime (int year, int month, double day)
 ArrayTime (int year, int month, int day, int hour, int minute, double second)
 ArrayTime (double modifiedJulianDay)
 ArrayTime (int modifiedJulianDay, double secondsInADay)
 ArrayTime (long long nanoseconds)
double getJD () const
double getMJD () const
double getJDI () const
double getMJDI () const
IDLArrayTime toIDLArrayTime () const
string toFITS () const
void toBin (EndianOSStream &eoss)
int * getDateTime () const
double getTimeOfDay () const
int getDayOfWeek () const
int getDayOfYear () const
string timeOfDayToString () const
double getLocalSiderealTime (double longitudeInHours) const
double getGreenwichMeanSiderealTime () const

Static Public Member Functions

bool isLeapYear (int year)
double getMJD (double jd)
double getJD (double mjd)
ArrayTime add (const ArrayTime &time, const Interval &interval)
ArrayTime sub (const ArrayTime &time, const Interval &interval)
ArrayTime getArrayTime (StringTokenizer &t)
void toBin (const vector< ArrayTime > &arrayTime, EndianOSStream &eoss)
void toBin (const vector< vector< ArrayTime > > &arrayTime, EndianOSStream &eoss)
void toBin (const vector< vector< vector< ArrayTime > > > &arrayTime, EndianOSStream &eoss)
ArrayTime fromBin (EndianISStream &eiss)
vector< ArrayTimefrom1DBin (EndianISStream &eiss)
vector< vector< ArrayTime > > from2DBin (EndianISStream &eiss)
vector< vector< vector< ArrayTime > > > from3DBin (EndianISStream &eiss)
double unitToJD (long long unit)
double unitToMJD (long long unit)
long long jdToUnit (double jd)
long long mjdToUnit (double mjd)
double utcCorrection (double jd)

Static Public Attributes

const int numberSigDigitsInASecond = 9
const long long unitsInASecond = 1000000000LL
const long long unitsInADayL = 86400000000000LL
const double unitsInADay
const double unitsInADayDiv100
const double julianDayOfBase
const long long julianDayOfBaseInUnitsInADayDiv100 = 2073600432000000000LL


Member Function Documentation

vector<ArrayTime> asdm::ArrayTime::from1DBin EndianISStream &  eiss  )  [static]
 

Read the binary representation of a vector of ArrayTime from an EndianISStream and use the read value to set a vector of ArrayTime.

Parameters:
dis the EndianISStream to be read
Returns:
a vector of ArrayTime

Reimplemented from asdm::Interval.

vector<vector<ArrayTime> > asdm::ArrayTime::from2DBin EndianISStream &  eiss  )  [static]
 

Read the binary representation of a vector of vector of ArrayTime from an EndianISStream and use the read value to set a vector of vector of ArrayTime.

Parameters:
eiis the EndianISStream to be read
Returns:
a vector of vector of ArrayTime

Reimplemented from asdm::Interval.

vector<vector<vector<ArrayTime> > > asdm::ArrayTime::from3DBin EndianISStream &  eiss  )  [static]
 

Read the binary representation of a vector of vector of vector of ArrayTime from an EndianISStream and use the read value to set a vector of vector of vector of ArrayTime.

Parameters:
eiss the EndianISStream to be read
Returns:
a vector of vector of vector of ArrayTime

ArrayTime asdm::ArrayTime::fromBin EndianISStream &  eiss  )  [static]
 

Read the binary representation of an ArrayTime from a EndianISStream and use the read value to set an ArrayTime.

Parameters:
eiss the EndianStream to be read
Returns:
an ArrayTime

Reimplemented from asdm::Interval.

void asdm::ArrayTime::toBin const vector< vector< vector< ArrayTime > > > &  arrayTime,
EndianOSStream &  eoss
[static]
 

Write the binary representation of a vector of vector of vector of ArrayTime to a EndianOSStream.

Parameters:
arrayTime the vector of vector of vector of ArrayTime to be written
eoss the EndianOSStream to be written to

void asdm::ArrayTime::toBin const vector< vector< ArrayTime > > &  arrayTime,
EndianOSStream &  eoss
[static]
 

Write the binary representation of a vector of vector of ArrayTime to a EndianOSStream.

Parameters:
arrayTime the vector of vector of ArrayTime to be written
eoss the EndianOSStream to be written to

void asdm::ArrayTime::toBin const vector< ArrayTime > &  arrayTime,
EndianOSStream &  eoss
[static]
 

Write the binary representation of a vector of ArrayTime to a EndianOSStream.

Parameters:
arrayTime the vector of ArrayTime to be written
eoss the EndianOSStream to be written to

void asdm::ArrayTime::toBin EndianOSStream &  eoss  ) 
 

Write the binary representation of this to a EndianOSStream.

Reimplemented from asdm::Interval.


The documentation for this class was generated from the following file:
Generated on Tue Nov 18 17:43:42 2008 for ASDM C++ Implementation by doxygen 1.3.8