Satellite Scope Functions

bool DoesRefTrajHaveCov()

This is a helper function for the InitalStateTool utility. It checks whether or not the reference trajectory for the associated satellite object contains valid covariance data. You must set the Satellite.EstimateOrbit flag to false for this function to work properly.

Return Value

bool True if the reference trajectory for the associated satellite object contains valid covariance data

Example VBS:

Copy 
result = sc.Satellite(0).DoesRefTrajHaveCov

listOfStrings SelectMeasurements(int sampleSize, string tracker1, string tracker2, int measType1, int measType2, int measType3, int measType4)

This opens a dialog box in which you can choose measurements of a satellite's orbit. It returns a list of the measurement strings that you select. The selected measurement strings are also available in the satellite's SelectedMeasurements attribute. A complete list of possible measurement choices is available in the SelectedMeasurements.Choices attribute.

Parameters

sampleSize int Enter an integer that limits the amount of measurements from which you can choose. If the satellite has a huge number of tracking measurements, this could cause the dialog box to take a long time to open. A good choice for this value is 300.
tracker1, tracker2 string The second and third inputs are strings that represent the fully qualified names of the one or two trackers that provide the measurements. For example, the fully qualified name of a facility tracker is of the form "TrackingSystem.Facility". The fully qualified name of a tracking instrument on a satellite is of the form "Satellite.TrackingInstrument". The second string should be the empty string, designated by "", if the measurement types only require one tracker. The second string needs to represent a valid tracker if the measurement types include a two-tracker measurement type, such as TDOA or FDOA.
measType1, measType2, measType3, measType4 int The fourth through seventh inputs are integers that represent integer codes for the desired measurement types. These integer codes are based on the EMeasType enumeration. An example is the ground-based right ascension measurement type, which is number 18 on that list. Choose zero for one or more of these inputs if you want to include fewer than four measurement types. The function will return an error if you enter all four measurement types as zero.

Return Value

listOfStrings A list of the measurement strings that you select

Example JavaScript:

Copy 
// This opens a dialog box that enables you to select right ascension and declination
// measurement pairs for measurements of Satellite(0) from Facility1, which is in
// TrackingSystem1.
var result = sc.Satellite(0).SelectMeasurements(300, "TrackingSystem1.Facility1", "", 18, 19, 0, 0);
// Your measurement choices are also accessible from the SelectedMeasurements attribute.
var result2 = sc.Satellite(0).SelectedMeasurements;
// The list of available choices are accessible from the SelectedMeasurement.Choices attribute.
var allChoices = sc.Satellite(0).SelectedMeasurements.Choices;

The following is an example measurement string for a satellite that is being tracked by a ground facility that provides ground-based right ascension (EMeasType code 18), declination (19), right ascension rate (174) and declination rate (175).

Copy 
Seconds after first meas | Time Tag | measType1 | meas1 | measType2 | meas2 | measType3 | meas3 | measType4 | meas4 | measType name strings
"60 01 Jul 2024 13:36:00.000 UTCG 18: 140.466340 deg; 19: -67.598640 deg; 174: -0.086731 deg/sec; 175: -0.079192 deg/sec; RA;Dec;RA Rate;Dec Rate"

bool UpdateMotionModel(string motionModelName)

Use this to change a satellite's MotionModel setting. The possible choices are "Orbiter" and "Lander". The satellite's initial state is converted as needed between Inertial (Orbiter) and Fixed (Lander) coordinates. You access this function via the Satellite's ReferenceTrajectory attribute scope.

Parameters

motionModelName string "Orbiter" or "Lander"

Return Value

bool True if the motion model setting was successfully changed

Example VBS:

Copy 
bResult = sc.Satellite(0).ReferenceTrajectory.UpdateMotionModel("Lander")