CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl/pypi-proplot

A succinct matplotlib wrapper for making beautiful, publication-quality graphics.

Pending
Overview
Eval results
Files

demonstrations.mddocs/

Demonstrations and Exploration

Built-in functions for exploring and demonstrating proplot's capabilities, including colormap galleries, color space visualizations, and font collections. These functions help users discover and understand proplot's extensive customization options.

Capabilities

Demonstration Functions

def show_cmaps(*args, **kwargs):
    """
    Display available colormaps in organized galleries.
    
    Parameters:
    - *args: Colormap categories or names to display
    - ncols (int): Number of columns in gallery
    - **kwargs: Additional display parameters
    
    Displays colormaps by category:
    - Sequential, diverging, cyclic, qualitative
    - Custom and user-registered colormaps
    """

def show_channels(*args, **kwargs):
    """
    Display colormap channels across different color spaces.
    
    Parameters:
    - *args: Colormap names to analyze
    - space (str): Color space for channel analysis
    - **kwargs: Additional analysis parameters
    
    Shows hue, saturation, luminance progression
    for perceptual colormap evaluation.
    """

def show_colors(*args, **kwargs):
    """
    Display available named colors in organized swatches.
    
    Parameters:
    - *args: Color categories or names to display
    - ncols (int): Number of columns in display
    - **kwargs: Additional display parameters
    
    Displays:
    - Built-in matplotlib colors
    - Proplot named colors
    - User-registered colors
    """

def show_colorspaces(*args, **kwargs):
    """
    Display color space demonstrations and comparisons.
    
    Parameters:
    - *args: Color spaces to demonstrate
    - **kwargs: Additional demonstration parameters
    
    Demonstrates differences between:
    - RGB, HCL, HSL, HSV color spaces
    - Perceptual uniformity comparisons
    """

def show_cycles(*args, **kwargs):
    """
    Display available color cycles for line plotting.
    
    Parameters:
    - *args: Color cycle names to display
    - ncols (int): Number of columns in display
    - **kwargs: Additional display parameters
    
    Shows:
    - Built-in color cycles
    - Custom and user-registered cycles
    """

def show_fonts(*args, **kwargs):
    """
    Display available fonts with sample text.
    
    Parameters:
    - *args: Font families to display
    - **kwargs: Additional display parameters
    
    Displays:
    - System fonts
    - TeX Gyre fonts (proplot defaults)
    - User-registered fonts
    """

Usage Examples

import proplot as pplt

# Show all sequential colormaps
pplt.show_cmaps('sequential')

# Show specific colormaps
pplt.show_cmaps('viridis', 'plasma', 'cividis')

# Analyze colormap perceptual properties
pplt.show_channels('viridis', 'jet', space='hcl')

# Display color cycles
pplt.show_cycles()

# Show available colors
pplt.show_colors('blue')

# Font exploration
pplt.show_fonts()

# Color space comparison
pplt.show_colorspaces('hcl', 'hsl')

These demonstration functions are invaluable for:

  • Exploring proplot's extensive asset libraries
  • Understanding color space differences
  • Selecting appropriate colormaps and colors
  • Evaluating perceptual uniformity
  • Discovering available customization options

Install with Tessl CLI

npx tessl i tessl/pypi-proplot

docs

axes-plotting.md

colors-colormaps.md

configuration.md

demonstrations.md

figure-subplots.md

index.md

projections.md

scales.md

tick-control.md

utilities.md

tile.json