CcsdsOrbitEphemerisMessageSegment Class

Ephemeris (and optionally covariance) data for an object that is valid for a given time period. CreatePoint can be used to make a PointInterpolator that can interpolate over the ephemeris data.

The CCSDS specifications can be found on the CCSDS website. The two supported formats for OEM files are Key-value notation (KVN) and extensible markup language (XML). The official recommended standards for KVN OEM files can be found in "Orbit Data Messages", Document CCSDS 502.0-B-2 on the above website. The official recommended standards for XML OEM files can be found in "XML Specifications for Navigation Data Messages", Document CCSDS 505.0-B-2 on the website. Both documents also contain a few useful examples of correctly formatted OEM files for their respective formats.

Inheritance Hierarchy

SystemObject
AGI.Foundation.InfrastructureDefinitionalObject
AGI.Foundation.CcsdsCcsdsOrbitEphemerisMessageSegment

Namespace: AGI.Foundation.Ccsds
Assembly: AGI.Foundation.Models (in AGI.Foundation.Models.dll) Version: 24.3.420.0 (24.3.420.0)

Syntax

C++

Copy

public class CcsdsOrbitEphemerisMessageSegment : DefinitionalObject

Public Class CcsdsOrbitEphemerisMessageSegment
	Inherits DefinitionalObject

public ref class CcsdsOrbitEphemerisMessageSegment : public DefinitionalObject

type CcsdsOrbitEphemerisMessageSegment =  
    class
        inherit DefinitionalObject
    end

The CcsdsOrbitEphemerisMessageSegment type exposes the following members.

Constructors

	Name	Description
	CcsdsOrbitEphemerisMessageSegment	Initializes a new instance. EphemerisData, ReferenceFrame, and Interpolator properties must be set before CreatePoint is called.
	CcsdsOrbitEphemerisMessageSegment(CcsdsOrbitEphemerisMessageSegment, CopyContext)	Initializes a new instance as a copy of an existing instance.

Top

Properties

	Name	Description
	Center	Gets or sets the origin of the ReferenceFrameName, which may be a natural Solar System body, including any planet barycenter or the Solar System barycenter, or another spacecraft.
	CovarianceAxes	Gets or sets a collection containing the axes of the covariance data. This collection is not provided automatically by ReadFrom(String) because the axes provided with OEM covariance data are optional, and they are not necessarily supported as Axes objects. If this is not provided by the user, an attempt will be made to build a collection of axes from the axes of given reference frame, the covariance axes names collection, and other data provided by the OEM file. If this attempt fails, will be returned. The user would then have to build this collection manually. Note that this data is not required by CreatePoint.
	CovarianceAxesNames	Gets or sets a collection containing names for covariance axes that are different from those of the reference frame.
	CovarianceData	Gets or sets the covariance data.
	CovarianceDataComments	Gets a collection containing comments from the covariance data of a segment of a CCSDS OEM file.
	EphemerisData	Gets or sets the ephemeris data.
	EphemerisDataComments	Gets a collection containing comments from the ephemeris data of a segment of a CCSDS OEM file.
	InterpolationMethod	Gets or sets the optional interpolation method for the ephemeris data immediately following the metadata block.
	InterpolationOrder	Gets or sets the interpolation order for the ephemeris data immediately following the metadata block. By default, this is zero.
	Interpolator	Gets or sets an interpolator for the ephemeris data. This value is not provided automatically by ReadFrom(String) because the interpolation information is optional. If this is not provided by the user, an attempt will be made to build an interpolator from the given interpolation method, interpolation order, and ephemeris data. If this attempt fails, will be returned. The user would then have to build an interpolator manually.
	IsFrozen	Gets a value indicating whether this object is frozen. A frozen object cannot be modified and an ObjectFrozenException will be thrown if an attempt is made to do so. (Inherited from DefinitionalObject.)
	MetaDataComments	Gets a collection containing comments from the metadata of a segment of a CCSDS OEM file.
	ObjectId	Gets or sets the object identifier for which the ephemeris is provided.
	ObjectName	Gets or sets the name of the object for which the ephemeris is provided.
	ReferenceFrame	Gets or sets the reference frame in which the ephemeris data is given. This value is not provided automatically by ReadFrom(String) because the reference frames given in OEM metadata are not necessarily supported as ReferenceFrame objects. If this is not provided by the user, an attempt will be made to infer the reference frame from the given center, reference frame, and reference frame epoch data. If this attempt fails, will be returned. The reference frame inference attempts to associate center names and reference frame names from the SANA website with reference frames available from the CentralBody, SolarSystemBarycenter, and PlanetarySystemBarycenter types. Only a subset of the SANA reference frames are supported, so it may be necessary for the user to manually create their own reference frames.
	ReferenceFrameEpoch	Gets or sets the epoch of reference frame, if not intrinsic to the definition of the reference frame.
	ReferenceFrameName	Gets or sets the name of the reference frame in which the ephemeris data are given. The reference frame must be the same for all data elements, with the exception of the covariance matrix, for which an applicable different reference frame may be specified.
	ReferenceFrameType	Gets or sets the type of the reference frame.
	StartTime	Gets or sets the start of total time span covered by the ephemeris data and covariance data immediately following the metadata block.
	StopTime	Gets or sets the end of total time span covered by ephemeris data and covariance data immediately following the metadata block.
	TimeStandard	Gets or sets the time standard used for metadata, ephemeris data, and covariance data. The valid values for CCSDS time systems are given by the SANA website. Only time systems that are compatible with the available time standards can be read by ReadFrom(String).
	UseableStartTime	Gets or sets the optional start of useable time span covered by ephemeris data immediately following the metadata block. Note that this value is ignored by CreatePoint.
	UseableStopTime	Gets or sets the optional end of useable time span covered by ephemeris data immediately following the metadata block. Note that this value is ignored by CreatePoint.

Top

Methods

	Name	Description
	CheckForSameDefinition(CcsdsOrbitEphemerisMessageSegment)	Checks to determine if another instance has the same definition as this instance and returns if it does. Derived classes MUST override this method and check all new fields introduced by the derived class for definitional equivalence. It is NOT necessary to check base class fields because the base class will already have done that. When overriding this method, you should NOT call the base implementation because it will return for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IsSameDefinition(Object).
	CheckForSameDefinition(DefinitionalObject)	Checks to determine if another instance has the same definition as this instance and returns if it does. Derived classes MUST override this method and check all new fields introduced by the derived class for definitional equivalence. It is NOT necessary to check base class fields because the base class will already have done that. When overriding this method, you should NOT call the base implementation because it will return for all derived-class instances. Derived classes should check the type of other to preserve the symmetric nature of IsSameDefinition(Object). (Overrides DefinitionalObjectCheckForSameDefinition(DefinitionalObject).)
	Clone	Clones this object using the specified context. (Overrides DefinitionalObjectClone(CopyContext).)
	ComputeCurrentDefinitionHashCode	Computes a hash code based on the current properties of this object. Derived classes MUST override this method and compute a hash code that combines: a unique hash code seed, the base implementation result, and the hash codes of all new fields introduced by the derived class which are used in the CheckForSameDefinition(DefinitionalObject) method. (Overrides DefinitionalObjectComputeCurrentDefinitionHashCode.)
	CreatePoint	Creates a Point whose time-varying position is computed by interpolating over the ephemeris data held by this instance. If the ReferenceFrame or Interpolator is not provided by the user, an attempt will be made to infer those values from the available information in other properties. If that attempt fails, a PropertyInvalidException will be thrown.
	EnumerateDependencies	Enumerates the dependencies of this object by calling EnumerateT(T) for each object that this object directly depends upon. Derived classes which contain additional dependencies MUST override this method, call the base implementation, and enumerate dependencies introduced by the derived class. (Overrides DefinitionalObjectEnumerateDependencies(DependencyEnumerator).)
	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.)
	Freeze	Freezes this object. Further attempts to modify it will result in an ObjectFrozenException. (Inherited from DefinitionalObject.)
	FreezeAggregatedObjects	Called by Freeze to also freeze any objects that are considered to be a part of this object. Derived classes which contain additional aggregated objects MUST override this method, call the base implementation, and freeze aggregated objects introduced by the derived class. The objects that need to be frozen in this method are frequently created in this object's constructor and are not settable via properties. (Inherited from DefinitionalObject.)
	GetDefinitionHashCode	Gets a hash code representing the definition of this object. (Inherited from DefinitionalObject.)
	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. (Inherited from DefinitionalObject.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ThrowIfFrozen	Throws ObjectFrozenException if this object IsFrozen. This method should be called from any method or property that modifies this object. (Inherited from DefinitionalObject.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Reference

AGI.Foundation.Ccsds Namespace