ODTK 7.1.1 Release Notes

ODTK 7.1.1 is a minor feature release with improvements in several areas. You are encouraged to read thoroughly all the release notes items to understand how you may benefit or be impacted if upgrading from a previous version.

New features

General

Python install detection is a new feature. At startup, ODTK tries to locate your Python executable and use it appropriately when generating reports. You can control the exact location of which Python executable is used by selecting from the Edit - Preferences - Python Settings options.

We also updated several HTML utilities:

The StateFileDumper and FlexibleStateFileDumper tools can now extract the covariance in the Frenet representation from the various *.run files.
The InitialState tool can now use SP3 files and CCSDS OPM version 2 files as a source of ephemeris.

The cross-platform API now includes a Java client, in addition to the already existing Python, MATLAB, and C++ clients. This makes it easier for customers who want to integrate with Java applications.

The time re-ordering that occurs at the end of a Fixed Interval Smoother run was optimized to run much faster.

Deep Space updates

We now support facilities on central bodies other than Earth. Now you can simulate the process tracking data for trackers on the Moon or other planets.

The DSN tracking system station locations are up to date based on the most recent JPL "Coverage and Geometry" report.

Reports and graphs

The Static Product Builder has new options when selecting the Input Data Sources. You can now select objects that generate *.* run files, such as MyFilter. ODTK automatically figures out the file path to the run file. You can select "First Filter" or other similar objects. This should make sharing Data Product List (*.dpl) files between users easier. You can still specify a particular *.* run file explicitly as well.

ODTK now has six additional report styles:

Report	Description
Satellite Consistency	Shows time-ordered values for the position and velocity filter-smoother consistency statistics
Satellite Consistency Summary	Aggregates the filter-smoother consistency test statistics for position, velocity, ballistic coefficient, and solar radiation
Tracker Consistency	Shows time-ordered values for the tracker measurement bias consistency statistics
Tracker Consistency Summary	Aggregates the tracker measurement bias consistency statistics
Ionosphere and Troposphere Measurement Corrections	Shows the time-order values of the corrections applied to the measurements

Measurement formats

The GEOS-C tracking data file reader now also supports one-way Doppler measurements (using Record Type 38).

The CCSDS TDM format now supports DSN 1W Doppler measurements.

ODTK now supports the NGA GPS monitoring station MDP binary format. It always has; we just now enabled it by default.

Scripting Guide updates

Please see the ODTK Scripting Help topics for changes to scripting interfaces and additional scripting examples.

Additional enhancements and resolved issues in ODTK 7.1.1

Additional Enhancements and Resolved Issues in ODTK 7.1.1
Tracking No.	Description
77670	There is an easier way to select run files in static product builder by selecting an object from the drop-down menu.
80827	A new optional keyword has been added to the gravity field file format to allow for specification of the central body fixed reference frame to be used for gravity field evaluations. This keyword has been added to the lunar gravity field files for lunar Prospector and GRAIL derived gravity fields and overrides the FixedFrameForGravity setting in the Moon.cb file.
92291	The ability to include the state-error transition function in STK *.e files has been added.
95427	The option to use the Joseph form of the update of the covariance matrix during measurement processing in the Filter has been added. The use of the Joseph form provides a more computationally stable update at the expense of being less computationally efficient.
99563	We added new build gravity process noise model inputs for new Ceres and Lunar gravity models. This change was added to ODTK 6.6 but was not mentioned in the release notes for that version.
106264	ODTK now supports On-Demand licensing feature similiar to STK. To find out more about our On-Demand licensing, please visit our website (www.support.agi.com/licensing-options).
108612	This removes false error messages that would appear in the Message Viewer if you visited the Edit > Preferences > UI Plugins page.
109895	The ability to host tracking facilities on central bodies other than the Earth has been added.
109947	This fixes an issue where GPS phase count measurements were resetting at the start of each custom tracking interval. This now only happens if the MinPassDelta is exceeded between intervals or a tracking interval tries to produce measurements when not valid or visible.
110389	CA and DF NavSol are now default measurements for GNSS Receivers.
110425	The Initial State Tool in the ODTK Utilities now has support for SP3 files.
110463	ODTK no longer crashes when using RINEX files without a marker number.
110784	Fixed one of the Python scripts used to support the various "Residuals by X" reports, where X is Azimuth, Elevarion, Range, etc.
110914	This corrects an error in the State Content Tool that resulted in the possibility of measurement bias states being missed. This should have been reported as part of the Filter estimation state. Bias states were not properly reported when (1) the filter was set to determine bias state inclusion dynamically, (2) the filter was running from a restart, (3) the affected biases were in state space with significant correlations to other states in the restart record, and (4) no additional measurements depending on those biases existed after the restart time.
110945	There are now four new report styles that display the filter-smoother consistency test values for various satellite and tracker parameters. The new styles are: Satellite Consistency Satellite Consistency Summary Tracker Bias Consistency Tracker Bias Consistency Summary
110964	A Java client was added for the Cross-Platform API. See the Scripting Help topics for more details on how to use it.
111075	Date/Time edit boxes embedded in the HTML utilities running inside ODTK were not converting time from UTCG to TDT/TAI correctly because of uninitialized offsets between those time scales inside the AgUiDatePickerCtrlActiveX object. They now convert correctly. This issue did not affect Date/Time conversions inside ODTK native White Panels controls.
111168	Beidou and Glonass GNSS Catalog files were updated based on recent constellation updates.
111201	The post-processing step to reorder the index at the end of long duration Smoother runs was taking a lot of time. The time is shorter now thanks to combining multiple index records for a single file I/O operation.
111248	The GEOS-C file reader now supports one-way doppler measurements.
111254	Adds two new report styles, "Ionosphere measurement Corrections" and "Troposphere measurement Corrections".
111325	You can now select an object X in the Object Browser and select File - Export -- X with SubObjects. It exports the object to a file, even if the object has no subobjects. Previously, this action would not work.
111326	Fixed an issue where 6x6 covariance data was not being reported in ephemeris files generated by predict-only smoother runs.
111402	The Initial State Tool can now use files in the CCSDS OPM version 2.0 format, including the initialization of covariance information.
111406	GPS C2W pseudorange and L2W phase measurements were being incorrectly treated as P2 pseudorange and L2 phase. These are now mapped correctly.
111416	This corrects an error in internal PRN mappings that prevented the processing of raw GNSS measurements, such as pseudo-range and carrier phase, originating from GNSS systems other than GPS when using SP3 formatted files of GNSS satellite position and clocks.
111655	The Tracking System Design exercise can now use the built-in optical constraint features.
111685	Python settings can be configured in Edit -> Preferences UI.
111724	ODTK now works with Python 3.8.3. You need to ensure that your Python installation has the following optional modules: h5py, numpy, pandas, pyparsing, pytz. Some Linux users may experience issues (not unique to ODTK) importing the math module in the Python Tracking Data Provider plugins. if that is the case, the workaround is to explicitly set the loader option prior to starting ODTK.
111751	If you use a GNSS SP3 file that contains more than 99 satellites, ODTK will now properly parse it.
111984	The Facility Location Error Ellipse graph style now correctly names the Y axis as "North Corrections" and the X axis as "East Corrections". The original names were "East" and "South", with the implied interpretation of the graph as a pseudo map projection, where East is to the left and South is to the bottom of the map. This seemed too confusing and inconsistent with all other graphs in ODTK.
112004	The ODTK Math Spec was updated to correct the discussion about the EGM96 and Grace gravity field process noise models. It had the two switched relative to the source paper referenced in the math specification.
112078	This modifies the spacecraft velocity used in the computation of aberration effects during the processing of measurements from a space-based tracker that is obtaining its position information via the specification of tracker position through the tracking data interface. The inertial velocity is now explicitly set to zero, which will result in zero diurnal aberration. The velocity values in this case were previously undefined, which could have led to erroneous computation of diurnal aberration effects.
112142	The CCSDS TDM tracking data reader has been updated to load DSN 1W Doppler Measurements.
112297	The jsoncpp library replaces nlohmann json library, and the variant.hpp library is now at version 1.4.0.
112441	ODTK supports MDP binary tracking data format used by the NGA GPS monitoring stations.
112455	Previously, if you created individual GPS satellites under a Constellation, put them into the Filter.SatelliteList, and disabled the Estimation flags on the Constellation object, you would get an exception trying to open the list or run the Filter. Now you will get a warning message about incompatible object types in the SatelliteList.
112504	We fixed the updating of the GNSS Constellation Source data start and stop time in the case where a list of SP3 files are populated through the automation interface.
112505	The ConcatenateSP3 file HTML utility wasn't properly skipping duplicate epoch time entries where one file ended at time T and the second file began at time T. The utility now detects this and will only include data from the end of the earlier file time T and not create a second set of data at time T from the second file.
112506	The DSN network tracking system shipped with ODTK is now up to date with the latest JPL report 301 version M "Coverage and Geometry".
112584	ODTK has a new optional keyword in the gravity field file format to allow for specification of the central body fixed reference frame to be used for gravity field evaluations. This keyword has been added to the lunar gravity field files for Lunar Prospector and GRAIL derived gravity fields and overrides the FixedFrameForGravity setting in the Moon.cb file.
112613	The Python-based reporting script odtk_report_utilities.py now detects if the h5py library is version 3.0 or newer and properly handles its treatment of strings as UTF-8 encoded byte arrays. If you are seeing text strings that look like b'blah blah' in your reports, then you need this update.
112621	In Edit > Preferences > File Find, there are now categories for Meterological Data Files and DSN Media Calibration Data Files. This allows easier sharing of those files between multiple users/scenarios and no longer requires manual updating of file paths after *.sco are moved or copied to another system.

Unresolved issues affecting the current release

You should be aware of the following limitations and unresolved issues affecting ODTK as of the date of this release.

Unresolved Issues
Tracking No.	Description
07071	Tracker satellites cannot share tracking IDs with GPS constellation PRN numbers. If a scenario contains both an optical tracker satellite and a GPS constellation and the tracker satellite has a tracking ID between 1-36, the tracking ID will become ambiguous.
10186	You should not name objects using class names like Filter, Smoother, or Simulator. Refer to the "VBA to VB.NET Migration" section of the ODTK Help.
23349	LaunchPad doesn't format dates in local format. It always uses MM/DD/YYYY, even if your machine is configured to show dates as DD/MM/YYYY.
29439	To avoid abnormal terminations that may occur when FLEXlm code is run with Windows Data Execution Prevention enabled, you need to change the DEP settings. Open the "System Properties", click on the "Advanced" tab, and click on the "Performance, Settings" button. This will bring up a dialog with three tabs. Click on the "DEP" tab and set the option to "Turn on DEP for essential Windows programs and services only". You may need to restart the computer after that.
30517	The Plugins tab does not refresh the SupportsSave column. When you add a new plugin tracking data reader and click Apply, the column labeled SupportsSave is not refreshed. By default, the value in this column is false, but after you add a new tracking data reader that supports save, then the value in this column should be true. You must dismiss the panel and pull it back up to get the correct value.
31034	After a long predict, the covariance is quite large. A very large measurement update can drive the filter covariance negative.
31802	A GPS constellation object does not populate the PRNList until properties are applied. We suggest that when you first assign a source file to a GPS constellation, you press Apply before double-clicking on the PRNList to view its contents.
32139	State File To SP3 utility limits output to GPSSatellites named PRN01, PRN02, etc.
36839	If ODTK aborts or runs out of disk space, then any active runfile is not saved in a valid state. This issue cannot be corrected without a big impact on processing speed due to opening and closing the file and opening to append. You should monitor disk utilization and plan for large run files from ODTK to avoid disk space issues.
42672	Dynamic Earth Data does not use file find paths. Do not attempt to change the location from the default location.
45226	ODTK does not support saving and loading of files that use multi-byte character sets.
100422	When using native support for 4K displays, the Object Properties tree [+] and [-] boxes do not scale properly and will appear very small.