export_pdf_groups#

export_pdf_groups(groups, filename, draw_circles=False, with_labels=False, with_title=False, show_progress=True)#

Render groups of diagrams in grids; one grid per PDF page.

Each item in groups is a sequence (list/tuple/set) of diagrams. For each group, a near-square grid (rows × cols) is chosen and the diagrams are drawn into that grid on a single page.

Parameters:

  • groups – Iterable of diagram groups, where each group is an iterable of PlanarDiagram objects.

  • filename (str) – Output PDF path.

  • draw_circles (bool) – If True, also draws auxiliary packing circles (debugging).

  • with_labels (bool) – If True, draw node/endpoint/arc labels.

  • with_title (bool) – If True, add per-diagram titles as in export_pdf.

  • show_progress (bool) – If True and total diagrams across all groups ≥ 10, show a progress bar.

Returns:

None

Raises:

TypeError – If groups is not a sequence of sequences.

Return type:

None

On this page