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.3.420.0 (24.3.420.0)

Syntax

C++

Copy

public class EarthOrientationParameters : IEquatableDefinition

Public Class EarthOrientationParameters
	Implements IEquatableDefinition

public ref class EarthOrientationParameters : IEquatableDefinition

type EarthOrientationParameters =  
    class
        interface IEquatableDefinition
    end

The EarthOrientationParameters type exposes the following members.

Constructors

	Name	Description
	EarthOrientationParameters	Initializes a new instance with no pole wander and no difference between UT1 and UTC.
	EarthOrientationParameters(IEnumerableEarthOrientationParametersData)	Initializes a new instance from the specified list of data points.
	EarthOrientationParameters(IEnumerableEarthOrientationParametersData, TimeInterval, TimeInterval, IEnumerableLeapSecond)	Initializes a new instance from the specified list of data points.
	EarthOrientationParameters(IEnumerableEarthOrientationParametersData, TimeInterval, TimeInterval, IEnumerableLeapSecond, String)	Initializes a new instance from the specified list of data points.

Top

Properties

	Name	Description
	Data	Gets the EOP data represented by this instance.
	LeapSeconds	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.
	NativeItrfFrame	Gets the native International Terrestrial Reference Frame (ITRF) associated with these parameters.
	ObservedInterval	Gets the time interval of observed data points, if known.
	PredictedInterval	Gets the time interval of predicted data points, if known.

Top

Methods

	Name	Description
	ComputeCelestialPoleOffset	Finds the offset to the Celestial Intermediate Pole (CIP) for the given date by interpolating this EOP data, in arc seconds.
	ComputeDeltaEpsilonCorrection	Finds the correction to the nutation in obliquity (delta Delta epsilon), in arc seconds, for the given date by interpolating this EOP data.
	ComputeDeltaPsiCorrection	Finds the correction to the nutation in longitude (delta Delta psi), in arc seconds, for the given date by interpolating this EOP data.
	ComputeEopData	Creates an EarthOrientationParametersData object with the given date and information from the various Compute methods such as ComputePoleWander(JulianDate).
	ComputeLengthOfDayCorrection	Finds the correction to the length of a solar day (86400.0 sec) for the given date by interpolating this EOP data.
	ComputePoleWander	Finds the pole wander for the given date by interpolating this EOP data, in arc seconds.
	ComputeTaiMinusUtc	Returns the difference TAI - UTC for the given date by returning the number of leap seconds at the previous data point.
	ComputeUt1MinusUtc	Returns the difference UT1 - UTC for the given date by interpolating this EOP data.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetDefinitionHashCode	Gets a hash code representing the definition of this object.
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	IsSameDefinition	Determines if this object has the same definition as another object.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	UseForTimeStandardConversions	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:

Copy

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:

Copy

CentralBodiesFacet.GetFromContext().Earth.OrientationParameters = EarthOrientationParametersFile.DownloadData();

Reference

AGI.Foundation.Celestial Namespace