Skip to main content

barh

Creates a horizontal bar plot.

A horizontal bar plot presents quantitative data with rectangular bars with lengths proportional to the values they represent. It shows comparisons among discrete categories. One axis shows the specific categories being compared, and the other axis represents a measured value.

Syntax

barh(x, y, **kwargs)

Parameters

Parameter

Type

Description

x

str or list of str

Name(s) of the column(s) to use for the horizontal axis. Multiple columns can be plotted.

y

str or list of str

Name(s) of the column(s) to use for the vertical axis. Multiple columns can be plotted.

**kwargs

optional

Additional keyword arguments.

Returns

plotly.graph_objs.Figure

Notes

In Plotly and Matplotlib, the interpretation of x and y for barh plots differs. In Plotly, x refers to the values and y refers to the categories. In Matplotlib, x refers to the categories and y refers to the values. Ensure correct axis labeling based on the backend used.

Examples

Python
from pyspark.sql import SparkSession
spark = SparkSession.builder.getOrCreate()
data = [("A", 10, 1.5), ("B", 30, 2.5), ("C", 20, 3.5)]
columns = ["category", "int_val", "float_val"]
df = spark.createDataFrame(data, columns)
df.plot.barh(x="int_val", y="category")