publiplots.resolve_markers

publiplots.resolve_markers(markers=None, n_markers=None, reverse=False)[source]

Resolve marker patterns for plotting.

This is a helper function that standardizes marker specifications into a concrete list of markers. It handles marker cycling for arbitrary numbers of categories and supports marker reversal.

Parameters:
  • markers (list of str, optional) – List of marker symbols to use. If None, uses default STANDARD_MARKERS.

  • n_markers (int, optional) – Number of markers to return. If provided, markers will be cycled to reach this count. If None, returns all markers.

  • reverse (bool, default=False) – Whether to reverse the marker order. Useful for changing visual hierarchy.

Returns:

List of resolved marker symbols.

Return type:

List[str]

Examples

Get default markers: >>> markers = resolve_markers() >>> len(markers) 10

Get exactly 5 markers with cycling: >>> markers = resolve_markers(n_markers=5) >>> len(markers) 5

Use custom markers: >>> markers = resolve_markers(markers=[‘o’, ‘^’, ‘s’], n_markers=7)

Get reversed markers: >>> markers = resolve_markers(n_markers=4, reverse=True)

See also

resolve_marker_map

Create a mapping from values to markers