explore_trend_plot_by_group

source

explore_trend_plot_by_group(
    df,
    group_var,
    var,
    *,
    time=None,
    points=True,
    error_bars=False,
    title=None,
    subtitle=None,
)

Line-plot the mean of var over time, one line per group_var level.

Parameters

Name	Type	Description	Default
df	pd.DataFrame	Data frame containing the time index, grouping factor and variable.	required
group_var	str	Grouping column.	required
var	str	Numeric variable to plot.	required
time	str | None	Time identifier column. Defaults to the panel time declared via :func:expdpy.set_panel.	None
points	bool	Whether to mark each observation with a point.	True
error_bars	bool	Whether to draw standard-error bars (mean +/- se).	False

Returns

Name	Type	Description
	ByGroupTrendGraphResult	df (columns time, group_var, mean, se) and the Plotly fig.

Examples

Basic — one line per group, tracking a variable’s mean over time:

import expdpy as ex
from expdpy.data import load_kuznets, load_kuznets_data_def

df = ex.set_labels(load_kuznets(), load_kuznets_data_def(), set_panel=True)
ex.explore_trend_plot_by_group(
    df, group_var="continent", var="gini_regional"
).fig

Advanced — add standard-error bars and drop the per-observation markers:

import expdpy as ex
from expdpy.data import load_kuznets, load_kuznets_data_def

df = ex.set_labels(load_kuznets(), load_kuznets_data_def(), set_panel=True)
ex.explore_trend_plot_by_group(
    df, group_var="continent", var="gini_regional",
    error_bars=True, points=False,
).fig