plotting.py Functions

Functions to create plots for observability analysis.

obsfind.plotting.elevation_chart(twilight_times, eph_night, target_plot_info, elevation_limit, show_plot=False, fig_path='./temp_airmass')

Creates an elevation chart for a given night.

Inputs

twilight_times : DataFrame with twilight times for the night. eph_night : DataFrame with ephemerides for the night. target_plot_info : DataFrame with target names, markers, and colours. elevation_limit : Minimum elevation limit for plotting. show_plot : Boolean to show the plot (default: False). fig_path : Path to save the figure (default: ‘./temp_airmass’).

Output

Saves the elevation chart as a PNG file if fig_path is provided.

obsfind.plotting.marker_list(target_names)

Creates a list of markers and colours for plotting targets.

Inputs

target_names : List of target names to be plotted.

Output

DataFrame with target names, markers, and colours.

obsfind.plotting.summary_chart(night_summaries, target_plot_info, target=False, fig_path='./temp_summary')

Creates and saves a multi-panel summary chart for one or more targets.

Inputs

night_summariesDataFrame containing nightly summary data for each target,

including columns such as ‘datetime_str’, ‘duration_hours’, ‘Mag’, ‘alpha’, ‘Sky_motion’, ‘RA’, and ‘DEC’.

target_plot_infoDataFrame mapping targets to plot colours and markers.

Must contain ‘targets’, ‘colours’, and ‘markers’ columns.

target(optional) Specific target name to plot. If provided,

only this target will be plotted; otherwise all targets in night_summaries are included.

fig_path : Directory path to save the output figure PNG file.

Output

Saves a PNG image in fig_path containing:

• Six subplots showing time visible, rate of motion, magnitude, RA,

phase angle, and DEC as functions of date. - For all-target plots: includes a legend above the subplots. - For single-target plots: no legend is shown.