Alterlab Seaborn: Install, Source and Security

Alterlab Seaborn

Published by alterlab-ieu in alterlab-academic-skills

No known issues70 installs

What this skill does

Builds statistical plots with the seaborn Python library and pandas DataFrame integration, on attractive matplotlib-based defaults. Use for quick exploration of distributions, relationships, and categorical comparisons — box plots, violin plots, swarm/strip plots, KDE/histograms, pair plots, joint plots, regression plots, correlation heatmaps, and faceted small multiples (relplot/displot/catplot/lmplot). For interactive/hover/zoom charts defer to alterlab-plotly; for exact journal/manuscript sty

Add Alterlab Seaborn to your agent

Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.

Install with a prompt

Paste this into a compatible coding agent:

add this skill "alterlab-seaborn" from https://github.com/alterlab-ieu/alterlab-academic-skills

Install with the CLI

Run this command in a controlled environment after reviewing the repository:

npx skills add https://github.com/alterlab-ieu/alterlab-academic-skills --skill alterlab-seaborn

Skill instructions

Seaborn Statistical Visualization

Overview

Seaborn is a Python visualization library for creating publication-quality statistical graphics. Use this skill for dataset-oriented plotting, multivariate analysis, automatic statistical estimation, and complex multi-panel figures with minimal code.

When to Use This Skill

Use seaborn for quick, attractive statistical graphics straight from a pandas DataFrame: distributions, relationships, categorical comparisons, correlation heatmaps, and faceted small multiples.

Does NOT Trigger

ScenarioUse Instead
Interactive chart with hover, zoom, or an HTML dashboardalterlab-plotly
Exact journal/manuscript styling (column widths, point fonts, CMYK, vector export)alterlab-scientific-viz
Low-level control of individual artists or layouts beyond FacetGrid/PairGridalterlab-matplotlib (seaborn axes-level plots accept ax= for this)
A full exploratory-data-analysis report on a data file (structure, quality, summary statistics)alterlab-eda
Choosing and running the statistical test behind a comparisonalterlab-statistical-analysis

Design Philosophy

  1. Dataset-oriented — work directly with DataFrames and named variables, not abstract coordinates.
  2. Semantic mapping — automatically translate data values into visual properties (color, size, style).
  3. Statistical awareness — built-in aggregation, error estimation, and confidence intervals.
  4. Aesthetic defaults — publication-ready themes and palettes out of the box.
  5. Matplotlib integration — full compatibility with matplotlib customization when needed.

Quick Start

Examples target seaborn ≥ 0.13 (verified on 0.13.2, still the current release in September 2026). Two API points that bite on this version: pass palette= only together with hue= (palette-without-hue is deprecated and slated for removal in v0.14), and style error bars via err_kws={...} rather than the deprecated errcolor/errwidth/scale/join keywords (slated for removal in v0.15).

With matplotlib 3.11 every plotting function still works, but boxplot (and catplot(kind="box")) emits a vert MatplotlibDeprecationWarning and heatmap a set_bad PendingDeprecationWarning. Both come from seaborn's internals and are harmless for now; matplotlib 3.13 is scheduled to remove vert, so pin matplotlib<3.13 in environments that depend on sns.boxplot until a seaborn release addresses it.

import seaborn as sns
import matplotlib.pyplot as plt
import pandas as pd

df = sns.load_dataset('tips')
sns.scatterplot(data=df, x='total_bill', y='tip', hue='day')
plt.show()

Core Workflow

  1. Shape the data as long-form ("tidy") — one column per variable, one row per observation. This works with every seaborn function. Reshape wide data with df.melt(...). See references/data_palettes_theming.md.
  2. Pick the plot category for your variable types (see routing below).
  3. Encode extra dimensions with hue, size, style semantic mappings.
  4. Choose axes-level vs figure-level: axes-level (scatterplot, boxplot, heatmap, …) plug into custom matplotlib layouts via ax=; figure-level (relplot, displot, catplot, lmplot, …) own the whole figure and facet via col/row.
  5. Theme and save with set_theme/set_context and savefig(dpi=300, bbox_inches='tight') (PDF for vector).

Plot Category Routing

Choose the category, then see references/plotting_functions.md for parameters and code for each.

GoalCategoryKey functions
How variables relateRelationalscatterplot, lineplot, relplot
Spread / shape / densityDistributionhistplot, kdeplot, ecdfplot, displot, jointplot, pairplot
Compare across categoriesCategoricalstripplot, swarmplot, boxplot, violinplot, barplot, pointplot, countplot, catplot
Linear relationships / residualsRegressionregplot, lmplot, residplot
Matrices / correlationsMatrixheatmap, clustermap
Custom multi-panel gridsGridsFacetGrid, PairGrid, JointGrid

The modern declarative seaborn.objects interface (ggplot2-like, composable) is best for complex layered or programmatic plots — see references/objects_interface.md.

Color and Theming (essentials)

  • Qualitative palettes for categories ("colorblind", "deep", "muted"); sequential for ordered data ("rocket", "viridis"); diverging for centered data ("vlag", "coolwarm", with center=0).
  • set_theme(style=..., context=..., palette=...); styles whitegrid/ticks/…; contexts paper→talk→poster scale element sizes.

Full palette and theming reference: references/data_palettes_theming.md.

Best Practices (essentials)

  • Plot from named DataFrame columns (preserves axis labels); use figure-level functions for faceting; encode extra dimensions with hue/size/style.
  • Know what each function estimates: lineplot/barplot auto-compute mean + CI — override with errorbar= and estimator=.
  • Combine with matplotlib (ax.set(...), axhline, tight_layout) for fine-tuning; save at dpi=300, and PDF for publications.

Full best-practices, common patterns, and troubleshooting (legend placement, overlapping labels, figure sizing, palette distinctness, KDE bandwidth): references/best_practices_and_troubleshooting.md.

Reference Index

  • references/plotting_functions.md — every plot category with parameters and code (relational, distribution, categorical, regression, matrix, multi-plot grids, figure-vs-axes-level).
  • references/data_palettes_theming.md — long/wide data structure, color palettes (qualitative/sequential/diverging/custom), and theming (set_theme, styles, contexts).
  • references/best_practices_and_troubleshooting.md — best practices, common patterns (EDA, publication figures, multi-panel, time series), and troubleshooting.
  • references/function_reference.md — comprehensive function signatures, parameters, and examples.
  • references/objects_interface.md — detailed guide to the modern seaborn.objects API.
  • references/examples.md — scenario-based worked examples and code patterns.

Files included

  • evals/evals.json
  • references/best_practices_and_troubleshooting.md
  • references/data_palettes_theming.md
  • references/examples.md
  • references/function_reference.md
  • references/objects_interface.md
  • references/plotting_functions.md
  • SKILL.md

More skills