Description
The SpacecraftObservationFile object provides functionality for reading and writing SpacecraftObservation data (azimuth/right ascension, elevation/declination, range, and range-rate) to or from FreeFlyer's ASCII file format. The time system for data contained in the SpacecraftObservationFile is TAI in Modified Julian format and range and range-rate data are given in km and km/s, respectively. Azimuth, elevation, right ascension, and declination data are given in radians in the reference frame of the observing Sensor. Lastly, the spacecraft observer position is given in km, in the MJ2000 Earth Equatorial inertial reference frame.
Inheritance Hierarchy: ObjectàTrackingDataFileàSpacecraftObservationFile
Available In Editions:
Mission
Timing Precision Mode
This page describes functionality in millisecond timing precision mode.
Name
|
Description
|
ApplyLimitValidationChecks
|
Determines whether to set the Validity flag on measurements as they are loaded, based on the applicable limits for the particular measurement type.
|
DataSpanEndEpoch
|
The Epoch of the last Observation in the file.
|
DataSpanStartEpoch
|
The Epoch of the first Observation in the file.
|
DeclaredName
|
The name of the object as declared.
|
Filename
|
The file name to load.
|
FirstObservation
|
The first Observation in the file.
|
LastObservation
|
The last Observation in the file.
|
Name
|
The name displayed for this object in output windows such as views, plots, and reports.
|
NoObservationErrorAction
|
Specifies the behavior when no matching observations are found in the TrackingDataFile.
|
ObjectBeingObserved
|
The Spacecraft that is being observed.
|
ObjectId
|
The unique identifier for the object.
|
ObjectType
|
The type of the object.
|
ObservedSensor
|
The Sensor object that is attached to the Transponder being observed. The Sensor's X, Y, and Z position properties will be used to model an offset from the origin of the Spacecraft BCS when modeling measurements.
|
Observers
|
An array of the observing Sensor objects.
|
UseAzimuth
|
A flag indicating whether or not the Azimuth measurement will be used.
|
UseDeclination
|
A flag indicating whether or not the Declination measurement will be used.
|
UseElevation
|
A flag indicating whether or not the Elevation measurement will be used.
|
UseIonosphericCorrection
|
A flag indicating whether or not the Ionospheric correction will be used.
|
UseLightTimeCorrection
|
A flag indicating whether or not the Light-Time correction will be used.
|
UseObserverPosition
|
A flag indicating whether or not to read or write the position of the observing Sensor. Note: If you are reading in the position of the observing sensor the observer position must be given in km, in the MJ2000 Earth Equatorial inertial reference frame.
|
UseRange
|
A flag indicating whether or not the Range measurement will be used.
|
UseRangeRate
|
A flag indicating whether or not the Range-Rate measurement will be used.
|
UseRightAscension
|
A flag indicating whether or not the Right Ascension measurement will be used.
|
|
Name
|
Description
|
AddObservationSource
|
Set a Ground Station or Sensor as the Source of the tracking data in the file. Multiple objects of the same type can be set for a given file.
|
ClearSavedStates
|
Clears previous saved states for this object.
|
GetAllObservations
|
Retrieves all observations from the TrackingDataFile and stores them in a List<Observation>. Any current observations held by the OD Observation object will be overwritten by the GetAllObservations() method.
|
GetFromFile
|
Load the object state from the specified FreeFlyer object file.
|
GetFromString
|
Load the object state from the specified string.
|
GetNextObservation
|
Retrieves the next observation in file.
|
PutToFile
|
Convert the object state to FreeFlyer object xml and write to a file.
|
PutToString
|
Convert the object state to FreeFlyer object xml and return as a string.
|
ReferenceEquals
|
Returns 1 if the argument refers to the calling object and 0 otherwise.
|
ResetToStart
|
Resets the TrackingDataFile to the start of the file.
|
Restore
|
Restore an object's state from a previously saved state.
|
Save
|
Save the object's state so that it can be restored later.
|
SetObservedSpacecraft
|
Set the Spacecraft that is being observed for the tracking data in the file.
|
SetObservedTransponder
|
Set the Transponder of the Observed Spacecraft for the tracking data in the file.
|
WriteValidDataToFile
|
Write out all Observations containing valid Measurements to a file. Returns 1 if data was written to a file, 0 if no valid observation data was found, or if the method fails to write to a file.
|
|
See also
Orbit Determination Guide
Tracking Data File Formats
|