.icicle()

In Plotly, the .icicle() function under the plotly.express module is used to create icicle charts, which are hierarchical visualizations similar to sunburst charts and treemaps. Icicle charts display hierarchical data with nested rectangles, where each level of the hierarchy is represented as a segment. This chart type is useful for visualizing multi-level categorical data in a structured and intuitive way.

Syntax

plotly.express.icicle(data_frame=None, path=None, values=None, color=None, color_continuous_scale=None, title=None, ...)

• data_frame: The Pandas DataFrame containing hierarchical data.
• path: A list of column names representing different levels of the hierarchy.
• values (Optional): The column that defines the values of the segments.
• color (Optional): The column used for segment coloring.
• color_continuous_scale (Optional): A color scale for continuous data.
• title (Optional): The title of the icicle chart.

Note: The ellipsis (…) indicates that there can be additional optional parameters beyond those listed here.

Example

The following example demonstrates the usage of the .icicle() function:

import plotly.express as px
import pandas as pd

# Create a sample hierarchical dataset
data = pd.DataFrame({
  "Region": ["World", "World", "World", "Asia", "Asia", "Europe", "Europe"],
  "Country": ["Asia", "Europe", "America", "China", "India", "Germany", "France"],
  "Population": [4600, 750, 1000, 1400, 1300, 83, 67]
})

# Create an icicle chart
chart = px.icicle(
  data_frame=data,
  path=["Region", "Country"],
  values="Population",
  color="Population",
  color_continuous_scale="Viridis",
  title="Population Distribution in Different Regions"
)

# Display the icicle chart
chart.show()

The above code produces the following output: