HECATE.multi_night_analysis

Classes

multi_night_analysis

Aggregate and analyze profile parameters across multiple observation nights.
class multi_night_analysis[source]

Bases: object

Aggregate and analyze profile parameters across multiple observation nights. This class enables comparison of local CCF/spectral line parameters (RV, width, intensity) across different observation nights, with flexible fitting and visualization options.

Parameters:

  • nights_data (dict) – Dictionary mapping night identifiers to data dictionaries. Each night dict should contain: {

    ‘hecate’: HECATE_instance, ‘indices’: indices_array (good data indices), ‘local_params’: local_params_array (shape: 3, N, 2), ‘master_params’: master_params_array (shape: 3, 1, 2), ‘color’: optional_matplotlib_color, ‘label’: optional_label_string

    }

  • data_type (str) – Type of data being analyzed, either ‘CCF’ or ‘line’.

__init__(nights_data: dict, data_type: str = 'CCF')[source]
plot_parameters(param_type: str = 'phases', fit_each_night: bool = False, fit_combined: bool = False, combined_night_names: numpy.array = None, fit_param_indices: numpy.array = None, plot_nested: bool = False, suptitle: str = None, save=None)[source]

Plot profile parameters from all nights with optional linear fits.

Parameters:

  • param_type (str) – ‘phases’ or ‘mu’ - which x-axis to plot against.

  • fit_each_night (bool) – Whether to fit each night individually.

  • fit_combined (bool) – Whether to fit combined nights.

  • combined_night_names (numpy array, optional) – List of night names to combine for fitting. If None and fit_combined=True, uses all nights.

  • fit_param_indices (numpy array, optional) – Parameter indices to fit (0, 1, 2). If None and fit_each_night or fit_combined is True, fits all.

  • plot_nested (bool) – Whether to plot Dynesty trace/corner plots.

  • suptitle (str, optional) – Figure title.

  • save – Path to save plots.

Returns:

fit_results – Dictionary with fit results keyed by (night, param_idx, param_type).

Return type:

dict