iterate_mht

ssapy.correlate_tracks.iterate_mht(data, oldmht, nminlength=20, trimends=2, **kw)[source][source]

Iterates and refines the Multiple Hypothesis Tracking (MHT) process by updating tracks and generating new hypotheses.

Parameters:

datadict

A dictionary containing satellite data. Must include a key ‘satID’ with satellite IDs.

oldmhtMHT

The previous MHT object containing hypotheses and tracking information.

nminlengthint, optional

Minimum length of satellite tracks to be included in the new hypotheses. Tracks shorter than this length are excluded. Default is 20.

trimendsint, optional

Number of observations to trim from both ends of each track. This helps refine the tracks by removing edge data. Default is 2.

**kwdict

Additional keyword arguments passed to the MHT.run() method.

Returns:

newmhtMHT

A new MHT object with updated hypotheses and refined tracks.

Notes:

  • The function identifies the best hypothesis from the oldmht object based on the highest log probability (lnprob).

  • Tracks are filtered based on their length (nminlength) and whether they are marked as “dead.”

  • If trimends is greater than 0, the ends of each track are trimmed, and new track objects are created.

  • The function creates an initial hypothesis using the refined tracks and generates a new MHT object.

  • Satellite IDs used in the updated tracks are excluded from the fitting process for the new MHT object.

  • The newmht.run() method is executed with the provided keyword arguments.