kessler.model

kessler.model#

Functions

default_prior()

This function returns a dictionary of TLE elements priors. Each prior is a probability density function defined using Pyro distributions. The population of objects from which these priors were derived is the one of May 2022. The priors are defined as follows: - mean_motion_prior: MixtureSameFamily - mean_anomaly_prior: Uniform - eccentricity_prior: MixtureSameFamily - inclination_prior: MixtureSameFamily - argument_of_perigee_prior: Uniform - raan_prior: Uniform - mean_motion_first_derivative_prior: Uniform - b_star_prior: MixtureSameFamily The parameters of the distributions are based on the population of objects. The priors are defined in the following ranges: - mean_motion: [0.0, 0.004] - mean_anomaly: [0.0, 2 * pi] - eccentricity: [0.0, 0.9] - inclination: [0.0, pi] - argument_of_perigee: [0.0, 2 * pi] - raan: [0.0, 2 * pi] - mean_motion_first_derivative: [4.937096738377722e-13, 5.807570136601159e-13] - b_star: (-inf, inf).

find_conjunction(tr0, tr1, miss_dist_threshold)

Classes

Bernoulli([probs, logits, validate_args])

Wraps torch.distributions.bernoulli.Bernoulli with TorchDistributionMixin.

Categorical([probs, logits, validate_args])

Wraps torch.distributions.categorical.Categorical with TorchDistributionMixin.

Conjunction([time0, max_duration_days, ...])

This class implements the Conjunction class, which is used to generate conjunction data messages (CDM) for two objects in space. The class uses the Pyro probabilistic programming library to define the model and perform inference. The class has the following attributes: - time0: The time of the first observation in MJD. - max_duration_days: The maximum duration of the simulation in days. - time_resolution: The time resolution of the simulation in seconds. - time_upsample_factor: The upsample factor for the time resolution. - miss_dist_threshold: The miss distance threshold in meters. - prior_dict: A dictionary containing the priors for the TLE elements. - t_prob_new_obs: The probability of a new observation for the target. - c_prob_new_obs: The probability of a new observation for the chaser. - cdm_update_every_hours: The interval at which to update the CDM in hours. - mc_samples: The number of Monte Carlo samples to use for uncertainty propagation. - mc_upsample_factor: The upsample factor for the Monte Carlo samples. - pc_method: The method to use for calculating the probability of collision. - collision_threshold: The threshold for considering a collision in meters. - likelihood_t_stddev: The standard deviation of the likelihood for the target. - likelihood_c_stddev: The standard deviation of the likelihood for the chaser. - likelihood_time_to_tca_stddev: The standard deviation of the likelihood for time to TCA.

ConjunctionDataMessage([file_name, set_defaults])

ConjunctionSimplified(tles[, ...])

This class is a simplified version of the Conjunction class.

GNSS([instrument_characteristics])

MixtureSameFamily(mixture_distribution, ...)

Wraps torch.distributions.mixture_same_family.MixtureSameFamily with TorchDistributionMixin.

Normal(loc, scale[, validate_args])

Wraps torch.distributions.normal.Normal with TorchDistributionMixin.

Radar([instrument_characteristics])

TLE(data)

This class constructs a TLE object from either a list of strings (that make up the TLE) or from a dictionary.

Uniform(low, high[, validate_args])

Wraps torch.distributions.uniform.Uniform with TorchDistributionMixin.