Skip to contents

Logos, Wordmarks & Headshots

ggplot2 geoms and ggproto objects for rendering CFB team logos, wordmarks, and player headshots on plots.

GeomCFBheads geom_cfb_logos() GeomCFBlogo
ggplot2 Layer for Visualizing CFB Team Logos
geom_cfb_headshots()
ggplot2 Layer for Visualizing CFB Player Headshots
geom_cfb_wordmarks()
ggplot2 Layer for Visualizing CFB Team Wordmarks

Theme Elements

Image-based ggplot2 theme elements for axis text — replace tick labels with CFB logos, wordmarks, or headshots.

Scales & Axes

CFB color/fill scales and logo/headshot axis annotation scales.

scale_color_cfb() scale_colour_cfb() scale_fill_cfb()
Scale for college football team colors
scale_x_cfb() scale_y_cfb() scale_x_cfb_headshots() scale_y_cfb_headshots()
Axis Scales for CFB Team Logos
theme_x_cfb() theme_y_cfb()
Theme for CFB Team Logos

gt Table Helpers

Embed CFB team logos, wordmarks, and player headshots inside gt table cells or column labels.

gt_fmt_cfb_logo() gt_fmt_cfb_wordmark() gt_fmt_cfb_headshot()
Add logos into rows of a gt table
gt_cfb_cols_label()
Render CFB logos in gt column labels
gt_merge_stack_team_color()
Merge and stack text from two columns in gt and color one with school colors

Team Utilities

Validate, clean, and factor-order CFB team names and abbreviations; look up athlete IDs; control the image cache.

valid_team_names()
Output Valid CFB Team Names and Abbreviations
clean_school_names()
Standardize NCAA School Names
clean_team_abbrs()
Clean CFB team abbreviations
cfb_team_factor()
Order CFB teams as a factor
add_athlete_id_col()
Add Athlete ID's to data frame
.cfbplotR_clear_cache()
Clear the cfbplotR (ggpath) image cache

Premade Plots

High-level functions that build complete CFB-branded plots.

cfb_team_tiers()
Create CFB Team Tiers

Plot Titles & Preview

Add images to ggplot2 titles and preview plots at exact output dimensions.

ggtitle_image() theme_title_image()
Functions for adding an image to the title of a ggplot
ggpreview()
Preview ggplot in Specified Dimensions

Package Data

Built-in reference datasets shipped with cfbplotR.

logo_ref team_name_mapping
Data in the package for reference

Re-exported from ggpath

Generic image geoms and theme elements provided by the ggpath backend.