GNSS Constellation Scope Functions
For the Ansys Orbit Determination Tool Kit (ODTK®) application, these are the scope functions for the GNSS Constellation object.
|
bool AddGNSSSatellites() Use this to add the GNSS Satellites in the GNSS Source file to a GNSS Constellation. Return Value
|
Example VBS: Copy
|
|
string GetFilename() This function is provided for backward compatibility for scripts written prior to version 7.1. It returns a single-source file name regardless of the type of source file being used. It is equivalent to SourceFilename when the source file is not an SP3 file. If you provide the source information in an SP3 format, it returns the first SP3 file from the Files list. It is hosted in the SVReference.Source scope. Return Value
|
Example VBS: Copy
|
|
bool GNSSSourceToSimrun(string outputFile, double dtMin) Converts the GNSS orbit and clock states given in the GNSS Constellation source file to a .simrun file (simulation state history file). This enables use of the ODTK State Differencing and Reporting/Graphing tools for analysis. The GNSS Source file may be in .sp3, .aux, .yuma, .alm, .sem, .al3, or .rinex format. You must set the OverrideStartTime flag in the GNSS constellation object to false. See also the SP3ToSimrun function. This function was the helper function to the GNSSSource_To_Simrun utility prior to ODTK application version 7.0. Ansys replaced it with GNSSSourceToSimrun7, but still maintain it to support any legacy user scripts. Parameters
Return Value
|
Example VBS: Copy
|
|
bool GNSSSourceToSimrun7(string outputFile, string startTime, string stopTime, double dtMin) This is a helper function for the GNSS Source ToSimRun utility. It converts the GNSS orbit and clock states given in the GNSS Constellation source file to a .simrun file (simulation state history file). This enables use of the ODTK State Differencing and Reporting/Graphing tools for analysis. The GNSS Source file may be in .sp3, .aux, .yuma, .alm, .sem, .al3, or .rinex format. Parameters
Return Value
|
Example VBS: Copy
|
|
bool GNSSUTCSteeringReport(string startTime, double duration, double timeStep, string filename) This generates a report containing GNSS UTC Time-Steered Bias and Drift versus Non-Steered Bias and Drift for purposes of analysis. It uses the GNSS steering parameters given in the GNSS constellation object, which may be defined when there are GNSSSatellite objects in the constellation. Parameters
Return Value
|
Example VBS: Copy
|
|
bool RemoveGNSSSatellites() Use this to remove all GNSS Satellites from the GNSS Constellation. Return Value
|
Example VBS: Copy
|
|
bool RemoveGNSSSatellitesWithMessage() Use this to remove all GNSS Satellites from the GNSS Constellation, with a message box to confirm the remove operation. Return Value
|
Example VBS: Copy
|
|
bool ReplaceICRFWithJ2000() This function cycles through each GNSSSatellite object that is part of the GNSSConstellation and looks for references to the ICRF frame and changes them to the J2000 frame. For each satellite, it will transform the orbit from ICRF to J2000. It will also check the ephemeris generation CoordFrame and check each maneuver frame, changing frames from ICRF to J2000. It does not otherwise modify maneuver data. The message viewer displays any indication of change. Calling this function at the scenario level will in turn call this function for each satellite and GNSSSatellite object. Return Value
|
Example VBS: Copy
|
|
CAgAttr RetrieveCatalogData(const string& sCatalogFilename, const int& week, const double& toa) This is a helper function for the ViewGroupDelayData utility. This utility compares the SV group delay (Tgd) values in the Catalog to those in the RINEX NAV message. This function retrieves the Tgd values from the Catalog for those SVs that are active at the given time. Parameters
Return ValueThe function returns a CAgAttr object containing the following members:
|
Example VBS: Copy
|