GNSS Constellation Scope Functions

bool AddGNSSSatellites()

Use this to add the GNSS Satellites in the GNSS Source file to a GNSS Constellation.

Return Value

Example VBS:

1
bSuccess = sc.GNSS.AddGNSSSatellites

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:

1
Filename = sc.GNSS.SVReference.Source.GetFilename()

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:

1
2
outputFile = "c:\tmp\gpsSource.simrun"
bResult = sc.GNSS.GNSSSourceToSimrun(outputFile, 30.0)

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:

1
2
3
4
5
outputFile = "c:\tmp\gpsSource.simrun"
bResult = sc.GNSS.GNSSSourceToSimrun7(outputFile, _
                                      "02 Jun 2012 00:00:00 GNSSG", _
                                      "03 Jun 2012 00:00:00 GNSSG", _
                                      15.0)

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:

1
2
3
4
5
start = "1 Jul 2008 12:00:00 GNSSG"
duration = 1
dt = 15
file = "C:\tmp\steering.txt"
bResult = sc.GNSS.GNSSUTCSteeringReport(start, duration, dt, file)

bool RemoveGNSSSatellites()

Use this to remove all GNSS Satellites from the GNSS Constellation.

Return Value

Example VBS:

1
bResult = sc.GNSS.RemoveGNSSSatellites

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:

1
bResult = sc.GNSS.RemoveGNSSSatellitesWithMessage

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:

1
bResult = sc.GNSS.ReplaceICRFWithJ2000

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 Value

The function returns a CAgAttr object containing the following members:

Example VBS:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
sCatalogFile = dir & "GNSSCatalog.txt"
week         = 1651
toa          = 2599200
set retv = ODTK.RetrieveCatalogData(sCatlogFile, week, toa)
odtk.writemessage retv.Succeed,"force"
odtk.writemessage retv.GNSS,"force"
odtk.writemessage retv.EpochTime,"force"
odtk.writemessage retv.Messages,"force"
set listPRNData = retv.PRNData
set listSVNData = retv.SVNData
set listTgdData = retv.TgdData
kount = listPRNData.count
if kount > 0 Then
    for a = 0 to kount - 1
        set prnData = listPRNData(a)
        prnI = listPRNData(a)
        snum = listSVNData(a)
        tgdC = listTgdData(a)
    next
end if