hwostyle

Matplotlib style sheets and utilities for HWO direct imaging figures.

Installation

pip install hwostyle

For development:

git clone https://github.com/HabitableWorldsObservatory/hwostyle.git
cd hwostyle
pip install -e ".[dev,test]"

Quick Start

import hwostyle

# Switch to paper mode (white background, muted colors)
hwostyle.use("light")

# Switch to talk mode (black background, neon colors)
hwostyle.use("dark")

# Access the palette
colors = hwostyle.palette
colors.cyan   # '#08F7FE' in dark, '#0097A7' in light

# Use domain-specific colormaps
cmap = hwostyle.cmaps.intensity   # PSF images
cmap = hwostyle.cmaps.residual    # difference maps
cmap = hwostyle.cmaps.phase       # wavefront error
cmap = hwostyle.cmaps.statistic   # signed statistics, SNR maps (PuOr)

# Brand roles: name the entity, not the color
hwostyle.roles.planet
hwostyle.roles.positive           # certified claim

Modes

Color Palette

Roles

A role is what a plotted entity is; it resolves to one color per theme. Palette-backed roles follow the palette family; fixed roles keep their color in every family (paper and barbie use the light value).

hwostyle.cmaps.statistic (PuOr) is the diverging map for signed statistics and SNR maps; residual stays red-blue for difference images.

Barbie Palette