countplot¶

`countplot(data, *, x=None, y=None, hue=None, order=None, hue_order=None, stat='count', color=None, palette=None)` ¶

Plot counts (or proportions) of a categorical variable.

Parameters:

Name	Type	Description	Default
`data`	`IntoFrame`	Input data. Any narwhals-compatible DataFrame or LazyFrame.	required
`x`	`str \| None`	Column name for horizontal categories (mutually exclusive with `y`).	`None`
`y`	`str \| None`	Column name for vertical categories (mutually exclusive with `x`).	`None`
`hue`	`str \| None`	Column name for grouping into separate series.	`None`
`order`	`list \| None`	Explicit category order.	`None`
`hue_order`	`list \| None`	Explicit order for hue levels.	`None`
`stat`	`str`	Statistic to compute. One of `"count"`, `"percent"`, `"proportion"`, `"probability"`.	`'count'`
`color`	`str \| None`	Single colour for all bars (CSS colour string).	`None`
`palette`	`list \| None`	List of colours, one per hue level.	`None`

Returns:

Name	Type	Description
`XYChart`	`XYChart`	An instance ready to render or further configure.

Raises:

Type	Description
`ValueError`	If neither or both of `x`/`y` are provided, or `stat` is invalid.