chaotic_pfc.analysis.latex_export

LaTeX table export for chaotic-PFC analysis results.

Every exporter accepts a lang parameter ("pt" or "en") that drives column headers, captions, and filter names via t().

All tables use booktabs rules and are wrapped in a table float (longtable for the full ranking). Output encoding is UTF-8.

Functions

export_consolidated_extended_table(...[, ...])

Export consolidated extended top-k (Categoria B).

export_consolidated_full_ranking(...[, ...])

Export consolidated full ranking (Categoria C.1, longtable).

export_consolidated_top_k_table(...[, ...])

Export consolidated top-k (Categoria A, Kaiser collapsed to best β).

export_extended_top_k_table(top_k_data, ...)

Export Categoria B — Top-3 per filter with extended λ_max statistics.

export_full_ranking_table(rank_data, output_path)

Export Categoria C.1 — Full ranking (longtable).

export_kaiser_beta_optimal_table(beta_data, ...)

Export optimal Kaiser β per filter type.

export_sweet_spots_table(sweet_spot_data, ...)

Export Categoria C.2 — Sweet-spot points per filter type.

export_top_k_table(top_k_data, output_path)

Export Categoria A — Top-3 per filter (chaotic area only).
chaotic_pfc.analysis.latex_export.export_top_k_table(top_k_data, output_path, caption_key=None, label=None, lang=None)[source]

Export Categoria A — Top-3 per filter (chaotic area only).

Parameters:

  • top_k_data (dict[str, list[ConfigRank]]) – {filter_type: [ConfigRank, ...]} from top_k_per_filter().

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key for the caption. Defaults to analysis.tables.top_k.caption.

  • label (str | None) – LaTeX label (without \label wrapper).

  • lang (str | None) – "pt" or "en". Defaults to the active locale.

Returns:

The path written.

Return type:

Path

chaotic_pfc.analysis.latex_export.export_extended_top_k_table(top_k_data, output_path, caption_key=None, label=None, lang=None)[source]

Export Categoria B — Top-3 per filter with extended λ_max statistics.

Parameters:

  • top_k_data (dict[str, list[ConfigRank]]) – {filter_type: [ConfigRank, ...]} from top_k_per_filter().

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key for the caption. Defaults to analysis.tables.top_k_extended.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path

chaotic_pfc.analysis.latex_export.export_full_ranking_table(rank_data, output_path, caption_key=None, label=None, lang=None)[source]

Export Categoria C.1 — Full ranking (longtable).

Parameters:

  • rank_data (list[ConfigRank]) – Sorted list from rank_configurations().

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key for the caption. Defaults to analysis.tables.full_ranking.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path

chaotic_pfc.analysis.latex_export.export_sweet_spots_table(sweet_spot_data, output_path, caption_key=None, label=None, lang=None)[source]

Export Categoria C.2 — Sweet-spot points per filter type.

Parameters:

  • sweet_spot_data (dict[str, SweetSpot]) – {filter_type: SweetSpot} from sweet_spot_per_filter().

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key for the caption. Defaults to analysis.tables.sweet_spots.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path

chaotic_pfc.analysis.latex_export.export_kaiser_beta_optimal_table(beta_data, output_path, caption_key=None, label=None, lang=None)[source]

Export optimal Kaiser β per filter type.

Parameters:

  • beta_data (dict[str, KaiserBetaOptimal]) – {filter_type: KaiserBetaOptimal} from kaiser_beta_optimal().

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key. Defaults to analysis.tables.kaiser_beta_optimal.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path

chaotic_pfc.analysis.latex_export.export_consolidated_top_k_table(consolidated_top_k, output_path, caption_key=None, label=None, lang=None)[source]

Export consolidated top-k (Categoria A, Kaiser collapsed to best β).

Parameters:

  • consolidated_top_k (dict[str, list[ConfigRank]]) – {filter_type: [ConfigRank, ...]} from top_k_per_filter() run on consolidated sweeps.

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key. Defaults to analysis.tables.consolidated_top_k.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path

chaotic_pfc.analysis.latex_export.export_consolidated_extended_table(consolidated_top_k, output_path, caption_key=None, label=None, lang=None)[source]

Export consolidated extended top-k (Categoria B).

Parameters:

  • consolidated_top_k (dict[str, list[ConfigRank]]) – From top_k_per_filter() on consolidated sweeps.

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key. Defaults to analysis.tables.consolidated_extended.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path

chaotic_pfc.analysis.latex_export.export_consolidated_full_ranking(consolidated_rank, output_path, caption_key=None, label=None, lang=None)[source]

Export consolidated full ranking (Categoria C.1, longtable).

Parameters:

  • consolidated_rank (list[ConfigRank]) – From rank_configurations() on consolidated sweeps.

  • output_path (str | Path) – Destination .tex file.

  • caption_key (str | None) – i18n key. Defaults to analysis.tables.consolidated_full_ranking.caption.

  • label (str | None) – LaTeX label.

  • lang (str | None) – "pt" or "en".

Return type:

Path