proposed addition of a df.agg stacked go.bar example

Author: rl-utility-man

doc/python/bar-charts.md

@@ -304,6 +304,57 @@ fig.update_layout(barmode='stack')
 fig.show()
 ```
 
+### Stacked Bar Chart from aggregating a data frame 
+
+Stacked bar charts are a powerful way to present results summarizing categories generated using the Pandas aggregate commands, which produce a wide format data set with one row for each bar component and a column for each bar, which is the transpose of the orientation of the px.bar wide data frame.  Tranposing and updating the indexes is a somewhat involved option. Here is one straightforward way to aggregate a data set into a summarized form and present the results as a stacked bar.
+
+```
+
+from plotly import graph_objects as go
+import pandas as pd
+
+#get one year of gapminder data
+url = 'https://raw.githubusercontent.com/plotly/datasets/master/gapminderDataFiveYear.csv'
+df = pd.read_csv(url)
+df = df[df['year']==2007]
+df["gdp"]=df["pop"]*df['gdpPercap']
+
+
+#build the summary of interest
+df_summarized = df.groupby("continent", observed=True).agg("sum").reset_index()
+
+df_summarized["percent of world population"]=100*df_summarized["pop"]/df_summarized["pop"].sum()
+df_summarized["percent of world GDP"]=100*df_summarized["gdp"]/df_summarized["gdp"].sum()
+
+
+df2 = df_summarized[["continent", 
+"percent of world population",
+"percent of world GDP",
+]]
+
+#we now have a wide data frame, but it's in the opposite orientation from the one that px is designed to deal with.
+#transposing it and rebuilding the indexes is an option, but iterating through the DF using graph objects is more succinct. 
+
+fig=go.Figure()
+for category in df_summarized["continent"].values:
+    fig.add_trace(go.Bar(
+            x=df2.columns[1:],
+            #we need to get a pandas series that contains just the values to graph; 
+            #we do so by selecting the right row, selecting the right columns
+            #and then tranposing and using iloc to convert to a series
+            #here, I assume that the bar element category variable is in column 0
+            y=list(df2.loc[df2["continent"]==category][list(df2.columns[1:])].transpose().iloc[:,0]),
+            name=str(category)
+
+
+        )
+)
+fig.update_layout(barmode="stack")
+
+fig.show()
+```
+
+
 ### Bar Chart with Hover Text
 
 ```python