nav.nav_master

class NavMaster(obs: Observation, *, nav_models: list[str] | None = None, nav_techniques: list[str] | None = None, config: Config | None = None)

Bases: NavBase

Coordinates the overall navigation process using multiple models and techniques.

This class manages the creation of different navigation models (e.g. stars, bodies, rings, and Titan), combines them appropriately, and applies navigation techniques to determine the final offset between predicted and actual positions.

The floating point offset is of form (dv, du). If an object is predicted by the SPICE kernels to be at location (v, u) in the image, then the actual location of the object is (v+dv, u+du). This means a positive offset is equivalent to shifting a model up and to the right (positive v and u).

property all_models: Sequence[NavModel]

Returns a sequence containing all navigation models.

property body_models: list[NavModelBodyBase]

Returns the list of planetary body navigation models, computing them if necessary.

property combined_model: NavModelCombined | None

Returns the final combined model.

compute_all_models() → None

Creates all navigation models for the observation.

This includes star models, ring models, body models, and Titan-specific models.

compute_body_models() → None

Creates navigation models for planetary bodies in the observation.

Identifies visible bodies within the field of view, sorts them by distance, and creates a navigation model for each one. If body models have already been computed, does nothing.

compute_ring_models() → None

Creates navigation models for planetary rings in the observation.

If ring models have already been computed, does nothing.

compute_star_models() → None

Creates navigation models for stars in the observation.

If star models have already been computed, does nothing.

compute_titan_models() → None

Creates Titan-specific navigation models for the observation.

If Titan models have already been computed, does nothing.

create_overlay() → ndarray[tuple[Any, ...], dtype[uint8]]

Creates a visual overlay combining the image and navigation annotations.

Combines all model annotations, applies the computed offset, and generates an annotated image with contrast adjustment.

property final_offset: tuple[float, float] | None

Returns the final computed offset between predicted and actual positions.

property metadata: dict[str, Any]

Returns the metadata dictionary.

metadata_serializable() → dict[str, Any]

Returns a copy of the metadata dictionary that is JSON serializable.

navigate() → None

Performs navigation by applying different navigation techniques.

Computes all navigation models, then applies star-based and all-model-based navigation techniques. Determines the final offset based on the results.

property obs: Observation

Returns the observation object associated with this navigation master.

property ring_models: list[NavModelRingsBase]

Returns the list of ring navigation models, computing them if necessary.

property star_models: list[NavModelStars]

Returns the list of star navigation models, computing them if necessary.

property titan_models: list[NavModelTitan]

Returns the list of Titan-specific navigation models, computing them if necessary.