ObsConstrain#

class jetset.obs_constrain.ObsConstrain(B_range=None, distr_e=None, t_var_sec=None, nu_cut_IR=None, beaming=None, theta=None, bulk_factor=None, obj_class=None, z=None, obspar_workplace=None, **keywords)[source]#

Bases: object

Derive initial jet-model parameters from observed SED features.

Notes

This helper maps phenomenological SED observables to a physically parameterized jetset.jet_model.Jet configuration.

Methods Summary

constrain_SSC_EC_model([name, jet_model, ...])

Build or update an SSC+EC jet model from observables.

constrain_SSC_model([name, jet_model, ...])

Build or update an SSC jet model from observables.

get_model_constraint([name, jet_model, ...])

Apply observational constraints and return an initialized jet model.

Methods Documentation

constrain_SSC_EC_model(name=None, jet_model=None, EC_components_list=['EC_BLR'], params_grid_size=10, electron_distribution_log_values=False, R_H=None, silent=False, R_H_within_BLR=False, R_H_within_DT=False, disk_type='BB')[source]#

Build or update an SSC+EC jet model from observables.

Parameters:
  • name (str, optional) – Name for a newly created jet model.

  • jet_model (Jet, optional) – Existing jet model to update. If omitted, a new one is created.

  • EC_components_list (list of str, optional) – External-Compton components to activate.

  • params_grid_size (int, optional) – Grid size used in internal one-dimensional parameter scans.

  • electron_distribution_log_values (bool, optional) – If True, electron-distribution parameters are interpreted in log space.

  • R_H (float, optional) – Optional dissipation distance override.

  • silent (bool, optional) – If True, suppress progress messages.

  • R_H_within_BLR (bool, optional) – If True, enforce R_H inside BLR when relevant.

  • R_H_within_DT (bool, optional) – If True, enforce R_H inside dusty torus when relevant.

  • disk_type (str, optional) – Disk model type used for EC setup.

Returns:

Constrained SSC+EC jet model.

Return type:

Jet

constrain_SSC_model(name=None, jet_model=None, params_grid_size=10, electron_distribution_log_values=False, silent=False)[source]#

Build or update an SSC jet model from observables.

Parameters:
  • name (str, optional) – Name for a newly created jet model.

  • jet_model (Jet, optional) – Existing jet model to update. If omitted, a new one is created.

  • params_grid_size (int, optional) – Grid size used in internal one-dimensional parameter scans.

  • electron_distribution_log_values (bool, optional) – If True, electron-distribution parameters are interpreted in log space.

  • silent (bool, optional) – If True, suppress progress messages.

Returns:

Constrained SSC jet model.

Return type:

Jet

get_model_constraint(name=None, jet_model=None, EC_components_list=None, params_grid_size=10, electron_distribution_log_values=False, silent=False, R_H=None, R_H_within_BLR=False, R_H_within_DT=False, disk_type='BB')[source]#

Apply observational constraints and return an initialized jet model.

Parameters:
  • name (str, optional) – Name used when creating a new jet model.

  • jet_model (Jet, optional) – Existing jet model to constrain. If omitted, a new one is built.

  • EC_components_list (list of str, optional) – External-Compton components to activate.

  • params_grid_size (int, optional) – Grid size used by numeric scans for B and R constraints.

  • electron_distribution_log_values (bool, optional) – If True, distribution parameters are interpreted in log space.

  • silent (bool, optional) – If True, suppress progress output.

  • R_H (float, optional) – Optional dissipation distance override.

  • R_H_within_BLR (bool, optional) – If True, clip R_H inside BLR when disk/BLR is enabled.

  • R_H_within_DT (bool, optional) – If True, clip R_H inside dusty torus when enabled.

  • disk_type (str, optional) – Disk model type for EC setup.

Returns:

Constrained jet model ready for evaluation and fitting.

Return type:

Jet

Raises:

RuntimeError – If beaming mode or emitter spectral type is not compatible.