Least Squares Output
You can set the following output options a Least Squares (LS) run:
LS Output Options | |
---|---|
Parameter | Description |
Filename | Click in the value column to display a selection window in which you can specify a path and file name (*.lsrun) for LS output. |
ResidualArchiving |
This property enables you to control how much data is written to the output summary file that LS creates when it runs. Options are:
|
OutputStateHistory |
Use this option to have ODTK write a satellite state to the .lsrun file. If ODTK writes the satellite state, then you can difference the .lsrun file with the filter, smoother, and simulator. Also, in any given run, ODTK can only write the state from a single iteration.
|
SuccessfulRun | This is a read-only field that indicates whether LS processing has been run successfully (true) or not (false). |
OrbitState | Set the OrbitState property to Cartesian or Keplerian, as desired. Read-only fields will display changes in the orbit state when you run LS. |
ForceModelList | Shows the force model parameter estimates resulting from the LS Run. For each force model parameter (such as ballistic coefficient and solar pressure coefficient), ODTK displays a flag indicating if the parameter is estimated, the original value, computed correction, the final value, and the uncertainty in the final value. The estimation of force model parameters is controlled by the satellite settings and the EstimateBCoeff and EstimateCr settings in the LeastSquares Stages list. |
MeasBiasList | Shows the measurement bias estimates resulting from the LS Run. For each estimated bias, ODTK displays the original value, computed correction, and final value. ODTK only displays the Measurement Biases solved for. The estimation of measurement biases is controlled by the measurement statistics of tracker objects (facilities and satellites) and the EstimateMeasBias setting in the LeastSquares Stages list. |
STKEphemeris |
Configure the STKEphemeris attribute to generate the ephemeris for each satellite over the LS fit span, or during a prediction period starting at the end of the fit span, or both, written to the specified output directory as Sat_<satname>_LS_<Stage#>_<Iteration#>_<TIME>.e Where TIME is:
The ephemeris is the reference ephemeris used during least squares for generating residuals. To see a read-only list of all ephemeris files created for this least squares object, click next to the Files property. |
StatesToTransfer |
Provides controls for which solved-for states will be transferred to the Satellite during the Transfer-To-Satellite operation. Estimation state options include the Position/Velocity of the satellite, solved-for drag states and solved-for solar pressure states. There is also an option to transfer the Position/Velocity covariance from the least squares solution. If selected, ODTK may apply scale factors for position and velocity state uncertainties during the transfer process to help account for the generally optimistic nature of covariance computed during least squares estimation. Scale factors are specified in sigma space, meaning that ODTK will square them for application to the covariance matrix. Finally, you may transition the solution state to a different time prior to transferring it to the satellite. By default, the transfer epoch will be set the same as the solution epoch, but you can also set it to the beginning, end, or midpoint of the final processing stage or to a user-defined time. ODTK performs covariance scaling after the transition from the solution epoch to the transfer epoch. To successfully transfer a solution state to a parent satellite, you must use the same central body for both the solution and the satellite. ODTK will check this and display an error in the Message Viewer if the central body is different for the two. You cannot tranfer measurement bias solutions. |
TransBiasList | Shows the transponder bias estimates resulting from the LS run. For each estimated bias, ODTK displays the original value, computed corrections, and final value. ODTK only displays the transponder biases solved for. |
Debug |
The Generate control defaults to "false". Toggle it to "true" to have ODTK generate a debug file of the state content for each stage of a Least Squares run. For each iteration, the file will produce the following debug information :
All numbers appear in state units. Range values, such as residuals and weights, appear as two-way values. |