register_cycles(user=True, default=False)[source]

Register color cycles packaged with ProPlot or saved to the ~/.proplot/cycles folder. This is called on import. Color cycles are registered according to their filenames – for example, name.hex will be registered as 'name'.

Valid file extensions are as follows:




List of HEX strings in any format (comma-separated, separate lines, with double quotes… anything goes).


XML files with <Point .../> tags specifying x, r, g, b, and (optionally) o parameters, where x is the coordinate and the rest are the red, blue, green, and opacity channel values.

.rgb, .txt

3-4 column table of red, blue, green, and (optionally) opacity channel values, delimited by commas or spaces. If values larger than 1 are detected, they are assumed to be on the 0-255 scale and are divided by 255.

To visualize the registered color cycles, use show_cycles.

  • user (bool, optional) – Whether to reload user cycles. Default is True.

  • default (bool, optional) – Whether to reload default proplot cycles. Default is False.