tracts.plot.plot_all_from_output_directories#

plot_all_from_output_directories(output_dirs, output_filename_format=None, log_scale=True, save_dir=None, sum_female_and_male_allosome_tracts=True, title_fontsize=None, subtitle_fontsize=None, label_fontsize=None, tick_fontsize=None, legend_fontsize=None)#

Convenience wrapper around plot_admixture_from_output(), plot_migration_matrices_from_output() and plot_tract_length_distributions_from_output(), to re-produce all three sets of plots for a list of output directories (e.g. corresponding to different models or populations) in a single call.

Since titles are inherently specific to each run, they are not exposed here; call the individual plotting functions directly to customize titles or subtitles. Font sizes, being run-agnostic style choices, are exposed and applied uniformly across every directory in output_dirs.

Parameters:

  • output_dirs (Iterable[str | Path]) – The output directories for which to (re-)produce plots.

  • output_filename_format (str | None) – See plot_admixture_from_output(). If None (default), it is auto-detected separately for each directory in output_dirs, so directories using different formats are supported. Pass an explicit value only if every directory in output_dirs shares that same format.

  • log_scale (bool) – See plot_tract_length_distributions_from_output().

  • save_dir (str | Path | None) – See plot_admixture_from_output(). Applied to every directory in output_dirs; since each output directory typically has its own output_filename_format prefix, plots from multiple runs can safely be collected into the same save_dir without overwriting each other.

  • sum_female_and_male_allosome_tracts (bool) – See plot_tract_length_distributions_from_output().

  • title_fontsize (float | None) – The font size of plot titles, applied to every directory in output_dirs. If None (default), each plotting function’s own default is used (a fixed size for tract length/admixture plots, an adaptive size for the migration matrices plot).

  • subtitle_fontsize (float | None) – The font size of plot subtitles (tract length distribution plots only). If None, the default of plot_tract_length_distributions_from_output() is used.

  • label_fontsize (float | None) – The font size of axis labels (tract length distribution and admixture plots). If None, each plotting function’s own default is used.

  • tick_fontsize (float | None) – The font size of tick labels, applied to every directory in output_dirs. If None (default), each plotting function’s own default is used (a fixed size for tract length/admixture plots, an adaptive size for the migration matrices plot).

  • legend_fontsize (float | None) – The font size of legends (tract length distribution and admixture plots). If None, each plotting function’s own default is used.

Return type:

None