Apply blacken-docs formatting to sub-plots.md documentation

Co-authored-by: jnumainville <[email protected]>

Author: Copilot

plugins/plotly-express/docs/sub-plots.md

@@ -10,27 +10,33 @@ Create a series of plots as subplots, all providing unique perspectives on the d
 
 ```python order=tipping_plots,tips
 import deephaven.plot.express as dx
-tips = dx.data.tips() # import a ticking version of the Tips dataset
+
+tips = dx.data.tips()  # import a ticking version of the Tips dataset
 
 # create 4 plots from within make_subplots
 tipping_plots = dx.make_subplots(
-    dx.scatter(tips, x="TotalBill", y="Tip", by="Sex",
-        title="Tip amount by total bill"),
-    dx.violin(tips, y="TotalBill", by="Day",
-        title="Total bill distribution by day"),
+    dx.scatter(
+        tips, x="TotalBill", y="Tip", by="Sex", title="Tip amount by total bill"
+    ),
+    dx.violin(tips, y="TotalBill", by="Day", title="Total bill distribution by day"),
     dx.pie(
-        tips
-        .count_by("Count", by=["Sex", "Smoker"])
+        tips.count_by("Count", by=["Sex", "Smoker"])
         .update_view("SmokerStatus = Smoker == `No` ? `non-smoker` : `smoker`")
         .update_view("SmokerLabel = Sex + ` ` + SmokerStatus"),
-        names="SmokerLabel", values="Count",
-        title="Total bill by sex and smoking status"),
-    dx.bar(tips
-        .view(["TotalBill", "Tip", "Day"])
-        .avg_by("Day"),
-        x="Day", y=["TotalBill", "Tip"],
-        title="Average tip as a fraction of total bill"),
-    rows=2, cols=2, shared_xaxes=False, shared_yaxes=False
+        names="SmokerLabel",
+        values="Count",
+        title="Total bill by sex and smoking status",
+    ),
+    dx.bar(
+        tips.view(["TotalBill", "Tip", "Day"]).avg_by("Day"),
+        x="Day",
+        y=["TotalBill", "Tip"],
+        title="Average tip as a fraction of total bill",
+    ),
+    rows=2,
+    cols=2,
+    shared_xaxes=False,
+    shared_yaxes=False,
 )
 ```
 
@@ -40,6 +46,7 @@ You can add titles to individual subplots using the `subplot_titles` parameter.
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
+
 tips = dx.data.tips()
 
 lunch_tips = tips.where("Time = `Lunch`")
@@ -50,7 +57,7 @@ tipping_plots = dx.make_subplots(
     dx.scatter(lunch_tips, x="TotalBill", y="Tip"),
     dx.scatter(dinner_tips, x="TotalBill", y="Tip"),
     rows=2,
-    subplot_titles=["Lunch Tips", "Dinner Tips"]
+    subplot_titles=["Lunch Tips", "Dinner Tips"],
 )
 ```
 
@@ -60,6 +67,7 @@ You can automatically use the titles from the original figures as subplot titles
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
+
 tips = dx.data.tips()
 
 lunch_tips = tips.where("Time = `Lunch`")
@@ -71,9 +79,7 @@ dinner_chart = dx.scatter(dinner_tips, x="TotalBill", y="Tip", title="Dinner Tip
 
 # Use existing titles as subplot titles
 tipping_plots = dx.make_subplots(
-    lunch_chart, dinner_chart,
-    rows=2,
-    use_existing_titles=True
+    lunch_chart, dinner_chart, rows=2, use_existing_titles=True
 )
 ```
 
@@ -83,14 +89,15 @@ You can add an overall title to the combined subplot figure using the `title` pa
 
 ```python order=tipping_plots,tips
 import deephaven.plot.express as dx
+
 tips = dx.data.tips()
 
 tipping_plots = dx.make_subplots(
     dx.scatter(tips, x="TotalBill", y="Tip", by="Day"),
     dx.histogram(tips, x="TotalBill"),
     rows=2,
     subplot_titles=["Daily Patterns", "Distribution"],
-    title="Tipping Analysis"
+    title="Tipping Analysis",
 )
 ```
 
@@ -105,7 +112,8 @@ When one axis is adjusted, all axes are adjusted to match.
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
-tips = dx.data.tips() # import a ticking version of the Tips dataset
+
+tips = dx.data.tips()  # import a ticking version of the Tips dataset
 
 # filter the tips dataset for separate lunch and dinner charts
 lunch_tips = tips.where("Time = `Lunch`")
@@ -115,7 +123,9 @@ dinner_tips = tips.where("Time = `Dinner`")
 tipping_plots = dx.make_subplots(
     dx.scatter(lunch_tips, x="TotalBill", y="Tip", labels={"Tip": "Lunch Tips"}),
     dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
-    rows=2, shared_yaxes="all", shared_xaxes="all"
+    rows=2,
+    shared_yaxes="all",
+    shared_xaxes="all",
 )
 ```
 
@@ -126,7 +136,8 @@ When one y-axis is adjusted, all axes along the same row are adjusted to match.
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
-tips = dx.data.tips() # import a ticking version of the Tips dataset
+
+tips = dx.data.tips()  # import a ticking version of the Tips dataset
 
 # filter the tips dataset for separate lunch and dinner charts
 lunch_tips = tips.where("Time = `Lunch`")
@@ -135,16 +146,18 @@ dinner_tips = tips.where("Time = `Dinner`")
 # create chart that shares y axes along the row
 tipping_plots = dx.make_subplots(
     dx.scatter(lunch_tips, x="TotalBill", y="Tip", labels={"Tip": "Lunch Tips"}),
-     dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
-    cols=2, shared_yaxes=True
+    dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
+    cols=2,
+    shared_yaxes=True,
 )
 ```
 
 To share the y axes along the same column, set `shared_yaxes` to `"columns"`.
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
-tips = dx.data.tips() # import a ticking version of the Tips dataset
+
+tips = dx.data.tips()  # import a ticking version of the Tips dataset
 
 # filter the tips dataset for separate lunch and dinner charts
 lunch_tips = tips.where("Time = `Lunch`")
@@ -153,8 +166,9 @@ dinner_tips = tips.where("Time = `Dinner`")
 # create chart that shares y axes along the column
 tipping_plots = dx.make_subplots(
     dx.scatter(lunch_tips, x="TotalBill", y="Tip", labels={"Tip": "Lunch Tips"}),
-     dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
-    rows=2, shared_yaxes="columns"
+    dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
+    rows=2,
+    shared_yaxes="columns",
 )
 ```
 
@@ -165,7 +179,8 @@ When one x-axis is adjusted, all axes along the same column are adjusted to matc
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
-tips = dx.data.tips() # import a ticking version of the Tips dataset
+
+tips = dx.data.tips()  # import a ticking version of the Tips dataset
 
 # filter the tips dataset for separate lunch and dinner charts
 lunch_tips = tips.where("Time = `Lunch`")
@@ -174,16 +189,18 @@ dinner_tips = tips.where("Time = `Dinner`")
 # create chart that shares x axes along the column
 tipping_plots = dx.make_subplots(
     dx.scatter(lunch_tips, x="TotalBill", y="Tip", labels={"Tip": "Lunch Tips"}),
-     dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
-    rows=2, shared_xaxes=True
+    dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
+    rows=2,
+    shared_xaxes=True,
 )
 ```
 
 To share the x axes along the same column, set `shared_yaxes` to `"columns"`.
 
 ```python order=tipping_plots,lunch_tips,dinner_tips
 import deephaven.plot.express as dx
-tips = dx.data.tips() # import a ticking version of the Tips dataset
+
+tips = dx.data.tips()  # import a ticking version of the Tips dataset
 
 # filter the tips dataset for separate lunch and dinner charts
 lunch_tips = tips.where("Time = `Lunch`")
@@ -192,8 +209,9 @@ dinner_tips = tips.where("Time = `Dinner`")
 # create chart that shares x axes along the row
 tipping_plots = dx.make_subplots(
     dx.scatter(lunch_tips, x="TotalBill", y="Tip", labels={"Tip": "Lunch Tips"}),
-     dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
-    cols=2, shared_xaxes="rows"
+    dx.scatter(dinner_tips, x="TotalBill", y="Tip", labels={"Tip": "Dinner Tips"}),
+    cols=2,
+    shared_xaxes="rows",
 )
 ```