fr.cnes.sirius.patrius.propagation.analytical.tle

Class TLE

java.lang.Object

fr.cnes.sirius.patrius.propagation.analytical.tle.TLE

All Implemented Interfaces:

TimeStamped, Serializable

public class TLE
extends Object
implements TimeStamped, Serializable

This class is a container for a single set of TLE data.

TLE sets can be built either by providing directly the two lines, in which case parsing is performed internally or by providing the already parsed elements.

TLE are not transparently convertible to Orbit instances. They are significant only with respect to their dedicated propagator, which also computes position and velocity coordinates. Any attempt to directly use orbital parameters like eccentricity, inclination, etc. without any reference to the TLE propagator is prone to errors.

More information on the TLE format can be found on the CelesTrak website.

Author:

Fabien Maussion, Luc Maisonobe

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT Identifier for default type of ephemeris (SGP4/SDP4).
static int	SDP4 Identifier for SDP4 type of ephemeris.
static int	SDP8 Identifier for SDP8 type of ephemeris.
static int	SGP Identifier for SGP type of ephemeris.
static int	SGP4 Identifier for SGP4 type of ephemeris.
static int	SGP8 Identifier for SGP8 type of ephemeris.

Constructor Summary

Constructors

Constructor and Description
TLE(int satelliteNumberIn, char classificationIn, int launchYearIn, int launchNumberIn, String launchPieceIn, int ephemerisTypeIn, int elementNumberIn, AbsoluteDate epochIn, double meanMotionIn, double meanMotionFirstDerivativeIn, double meanMotionSecondDerivativeIn, double e, double i, double paIn, double raanIn, double meanAnomalyIn, int revolutionNumberAtEpochIn, double bStarIn) Simple constructor from already parsed elements.
TLE(String line1In, String line2In) Simple constructor from unparsed two lines.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object object) Test for the equality of two TLE objects.
double	getBStar() Get the ballistic coefficient.
char	getClassification() Get the classification.
AbsoluteDate	getDate() Get the TLE current date.
double	getE() Get the eccentricity.
int	getElementNumber() Get the element number.
int	getEphemerisType() Get the type of ephemeris.
double	getI() Get the inclination in [0, π].
int	getLaunchNumber() Get the launch number.
String	getLaunchPiece() Get the launch piece.
int	getLaunchYear() Get the launch year.
String	getLine1() Get the first line.
String	getLine2() Get the second line.
double	getMeanAnomaly() Get the mean anomaly in [0, 2π].
double	getMeanMotion() Get the mean motion.
double	getMeanMotionFirstDerivative() Get the mean motion first derivative.
double	getMeanMotionSecondDerivative() Get the mean motion second derivative.
double	getPerigeeArgument() Get the argument of perigee in [0, 2π].
double	getRaan() Get Right Ascension of the Ascending node in [0, 2π].
int	getRevolutionNumberAtEpoch() Get the revolution number.
int	getSatelliteNumber() Get the satellite id.
int	hashCode() Get a hashCode for the TLE.
static boolean	isFormatOK(String line1, String line2) Check the lines format validity.
String	toString() Get a string representation of this TLE set.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT

public static final int DEFAULT

Identifier for default type of ephemeris (SGP4/SDP4).

See Also:

Constant Field Values

SGP

public static final int SGP

Identifier for SGP type of ephemeris.

See Also:

Constant Field Values

SGP4

public static final int SGP4

Identifier for SGP4 type of ephemeris.

See Also:

Constant Field Values

SDP4

public static final int SDP4

Identifier for SDP4 type of ephemeris.

See Also:

Constant Field Values

SGP8

public static final int SGP8

Identifier for SGP8 type of ephemeris.

See Also:

Constant Field Values

SDP8

public static final int SDP8

Identifier for SDP8 type of ephemeris.

See Also:

Constant Field Values

Constructor Detail

TLE

public TLE(String line1In,
           String line2In)
    throws PatriusException

Simple constructor from unparsed two lines.

The static method isFormatOK(String, String) should be called before trying to build this object.

Parameters:

line1In - the first element (69 char String)

line2In - the second element (69 char String)

Throws:

PatriusException - if some format error occurs or lines are inconsistent

TLE

public TLE(int satelliteNumberIn,
           char classificationIn,
           int launchYearIn,
           int launchNumberIn,
           String launchPieceIn,
           int ephemerisTypeIn,
           int elementNumberIn,
           AbsoluteDate epochIn,
           double meanMotionIn,
           double meanMotionFirstDerivativeIn,
           double meanMotionSecondDerivativeIn,
           double e,
           double i,
           double paIn,
           double raanIn,
           double meanAnomalyIn,
           int revolutionNumberAtEpochIn,
           double bStarIn)
    throws PatriusException

Simple constructor from already parsed elements.

Parameters:

satelliteNumberIn - satellite number

classificationIn - classification (U for unclassified)

launchYearIn - launch year (all digits)

launchNumberIn - launch number

launchPieceIn - launch piece

ephemerisTypeIn - type of ephemeris

elementNumberIn - element number

epochIn - elements epoch

meanMotionIn - mean motion (rad/s)

meanMotionFirstDerivativeIn - mean motion first derivative (rad/s²)

meanMotionSecondDerivativeIn - mean motion second derivative (rad/s³)

e - eccentricity

i - inclination (rad). In case of negative inclination, inclination will be set to positive value and 180° will be added to RAAN value

paIn - argument of perigee (rad). It will then be normalized in [0, 360°]

raanIn - right ascension of ascending node (rad). It will then be normalized in [0, 360°]

meanAnomalyIn - mean anomaly (rad). It will then be normalized in [0, 360°]

revolutionNumberAtEpochIn - revolution number at epoch

bStarIn - ballistic coefficient

Throws:

PatriusException - thrown if inclination is negative

Method Detail

getLine1

public String getLine1()
                throws PatriusException

Get the first line.

Returns:

first line

Throws:

PatriusException - if UTC conversion cannot be done

getLine2

public String getLine2()

Get the second line.

Returns:

second line

getSatelliteNumber

public int getSatelliteNumber()

Get the satellite id.

Returns:

the satellite number

getClassification

public char getClassification()

Get the classification.

Returns:

classification

getLaunchYear

public int getLaunchYear()

Get the launch year.

Returns:

the launch year

getLaunchNumber

public int getLaunchNumber()

Get the launch number.

Returns:

the launch number

getLaunchPiece

public String getLaunchPiece()

Get the launch piece.

Returns:

the launch piece

getEphemerisType

public int getEphemerisType()

Get the type of ephemeris.

Returns:

the ephemeris type (one of DEFAULT, SGP, SGP4, SGP8, SDP4, SDP8)

getElementNumber

public int getElementNumber()

Get the element number.

Returns:

the element number

getDate

public AbsoluteDate getDate()

Get the TLE current date.

Specified by:

getDate in interface TimeStamped

Returns:

the epoch

getMeanMotion

public double getMeanMotion()

Get the mean motion.

Returns:

the mean motion (rad/s)

getMeanMotionFirstDerivative

public double getMeanMotionFirstDerivative()

Get the mean motion first derivative.

Returns:

the mean motion first derivative (rad/s²)

getMeanMotionSecondDerivative

public double getMeanMotionSecondDerivative()

Get the mean motion second derivative.

Returns:

the mean motion second derivative (rad/s³)

getE

public double getE()

Get the eccentricity.

Returns:

the eccentricity

getI

public double getI()

Get the inclination in [0, π].

Returns:

the inclination (rad)

getPerigeeArgument

public double getPerigeeArgument()

Get the argument of perigee in [0, 2π].

Returns:

omega (rad)

getRaan

public double getRaan()

Get Right Ascension of the Ascending node in [0, 2π].

Returns:

the raan (rad)

getMeanAnomaly

public double getMeanAnomaly()

Get the mean anomaly in [0, 2π].

Returns:

the mean anomaly (rad)

getRevolutionNumberAtEpoch

public int getRevolutionNumberAtEpoch()

Get the revolution number.

Returns:

the revolutionNumberAtEpoch

getBStar

public double getBStar()

Get the ballistic coefficient.

Returns:

bStar

toString

public String toString()

Get a string representation of this TLE set.

The representation is simply the two lines separated by the platform line separator.

Overrides:

toString in class Object

Returns:

string representation of this TLE set

isFormatOK

public static boolean isFormatOK(String line1,
                                 String line2)
                          throws PatriusException

Check the lines format validity.

Parameters:

line1 - the first element

line2 - the second element

Returns:

true if format is recognized (non null lines, 69 characters length, line content), false if not

Throws:

PatriusException - if checksum is not valid

equals

public boolean equals(Object object)

Test for the equality of two TLE objects.

TLE objects are considered equals if they have the same attributes

Overrides:

equals in class Object

Parameters:

object - Object to test for equality to this

Returns:

true if two TLE are equal

hashCode

public int hashCode()

Get a hashCode for the TLE.

Overrides:

hashCode in class Object

Returns:

a hash code value for this object