publiplots.resolve_marker_map¶

publiplots.resolve_marker_map(values=None, marker_map=None, reverse=False)[source]¶

Create a mapping from category values to marker symbols.

This function creates a dictionary that maps category names to specific marker symbols, which is useful for categorical plots like scatterplots with style parameter. It ensures consistent marker assignment across multiple plots.

Parameters:

values (list of str, optional) – List of category values to map to markers. If None, returns empty dict.
marker_map (dict or list, optional) – Marker specification: - dict: Explicit mapping from values to markers (returned as-is) - list: List of markers to cycle through for values - None: Uses default markers from STANDARD_MARKERS
reverse (bool, default=False) – Whether to reverse the marker assignment order. Only applicable when marker_map is a list or None.

Returns:

Mapping from category values to marker symbols.

Return type:

Dict[str, str]

Examples

Create mapping for categories: >>> categories = [‘A’, ‘B’, ‘C’, ‘D’] >>> mapping = resolve_marker_map(values=categories) >>> mapping[‘A’] ‘o’ >>> mapping[‘B’] ‘s’

Use custom markers: >>> mapping = resolve_marker_map( … values=[‘cat’, ‘dog’, ‘bird’], … marker_map=[‘o’, ‘^’, ‘s’] … )

Use explicit mapping: >>> mapping = resolve_marker_map( … values=[‘A’, ‘B’], … marker_map={‘A’: ‘o’, ‘B’: ‘^’} … ) >>> mapping {‘A’: ‘o’, ‘B’: ‘^’}