Click or drag to resize

EarthOrientationParameters Class

Specifies Earth polar motion coordinates and the difference between UT1 and UTC.
Inheritance Hierarchy
SystemObject
  AGI.Foundation.CelestialEarthOrientationParameters

Namespace:  AGI.Foundation.Celestial
Assembly:  AGI.Foundation.Models (in AGI.Foundation.Models.dll) Version: 24.2.419.0 (24.2.419.0)
Syntax
public class EarthOrientationParameters : IEquatableDefinition

The EarthOrientationParameters type exposes the following members.

Constructors
  NameDescription
Public methodEarthOrientationParameters
Initializes a new instance with no pole wander and no difference between UT1 and UTC.
Public methodEarthOrientationParameters(IEnumerableEarthOrientationParametersData)
Initializes a new instance from the specified list of data points.
Public methodEarthOrientationParameters(IEnumerableEarthOrientationParametersData, TimeInterval, TimeInterval, IEnumerableLeapSecond)
Initializes a new instance from the specified list of data points.
Public methodEarthOrientationParameters(IEnumerableEarthOrientationParametersData, TimeInterval, TimeInterval, IEnumerableLeapSecond, String)
Initializes a new instance from the specified list of data points.
Top
Properties
  NameDescription
Public propertyData
Gets the EOP data represented by this instance.
Public propertyLeapSeconds
Gets a list of leap seconds, if known, indicating times when a data point indicates a delta between TAI and UTC which differs from the prior data point. Note that this may not be a complete or accurate set of leap seconds, since it only includes those that occurred during the time period covered by a particular EOP file.
Public propertyNativeItrfFrame
Gets the native International Terrestrial Reference Frame (ITRF) associated with these parameters.
Public propertyObservedInterval
Gets the time interval of observed data points, if known.
Public propertyPredictedInterval
Gets the time interval of predicted data points, if known.
Top
Methods
  NameDescription
Public methodComputeCelestialPoleOffset
Finds the offset to the Celestial Intermediate Pole (CIP) for the given date by interpolating this EOP data, in arc seconds.
Public methodComputeDeltaEpsilonCorrection
Finds the correction to the nutation in obliquity (delta Delta epsilon), in arc seconds, for the given date by interpolating this EOP data.
Public methodComputeDeltaPsiCorrection
Finds the correction to the nutation in longitude (delta Delta psi), in arc seconds, for the given date by interpolating this EOP data.
Public methodComputeEopData
Creates an EarthOrientationParametersData object with the given date and information from the various Compute methods such as ComputePoleWander(JulianDate).
Public methodComputeLengthOfDayCorrection
Finds the correction to the length of a solar day (86400.0 sec) for the given date by interpolating this EOP data.
Public methodComputePoleWander
Finds the pole wander for the given date by interpolating this EOP data, in arc seconds.
Public methodComputeTaiMinusUtc
Returns the difference TAI - UTC for the given date by returning the number of leap seconds at the previous data point.
Public methodComputeUt1MinusUtc
Returns the difference UT1 - UTC for the given date by interpolating this EOP data.
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetDefinitionHashCode
Gets a hash code representing the definition of this object.
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodIsSameDefinition
Determines if this object has the same definition as another object.
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodStatic memberUseForTimeStandardConversions
Configures the TimeStandardConverter so that EOP data is used to convert between the UTC and UT1 time standards.
Top
Remarks
In order to do their work, many other classes require that the OrientationParameters property of the Earth instance in the CentralBodiesFacet calculation context facet hold a valid instance of this class. You can obtain an EOP data file from https://ftp.agi.com/pub/DynamicEarthData/EOP-v1.1.txt and read it using EarthOrientationParametersFile.
Examples

This example shows how to load EOP data from a file and add it to the current calculation context:

C#
EarthOrientationParameters eop = EarthOrientationParametersFile.ReadData(Path.Combine(dataPath, "EOP-v1.1.txt"));
CentralBodiesFacet.GetFromContext().Earth.OrientationParameters = eop;

This example shows how to download EOP data over the internet from an AGI server, and add it to the current calculation context:

C#
CentralBodiesFacet.GetFromContext().Earth.OrientationParameters = EarthOrientationParametersFile.DownloadData();
See Also