add faceting support for all figure factory methods

CHANGELOG.md

@@ -2,6 +2,12 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## Unreleased
+
+### Updated
+
+- All `plotly.express` figure factory functions now support faceting [2646](https://github.com/plotly/plotly.py/issues/2646)
+
 
 ## [4.14.3] - 2021-01-12
 

doc/python/plotly-express.md

@@ -66,7 +66,7 @@ The Plotly Express API in general offers the following features:
 * **Automatic Hover Labels**: PX functions populate the hover-label using the labels mentioned above, and provide [extra control with the `hover_name` and `hover_data` arguments](/python/hover-text-and-formatting/).
 * **Styling Control**: PX functions [read styling information from the default figure template](/python/styling-plotly-express/), and support commonly-needed [cosmetic controls like `category_orders` and `color_discrete_map`](/python/styling-plotly-express/) to precisely control categorical variables.
 * **Uniform Color Handling**: PX functions automatically switch between [continuous](/python/colorscales/) and [categorical color](/python/discrete-color/) based on the input type.
-* **Faceting**: the 2D-cartesian plotting functions support [row, column and wrapped facetting with `facet_row`, `facet_col` and `facet_col_wrap` arguments](/python/facet-plots/).
+* **Faceting**: Plotting functions support [row, column and wrapped facetting with `facet_row`, `facet_col` and `facet_col_wrap` arguments](/python/facet-plots/).
 * **Marginal Plots**: the 2D-cartesian plotting functions support [marginal distribution plots](/python/marginal-plots/) with the `marginal`, `marginal_x` and `marginal_y` arguments.
 * **A Pandas backend**: the 2D-cartesian plotting functions are available as [a Pandas plotting backend](/python/pandas-backend/) so you can call them via `df.plot()`.
 * **Trendlines**: `px.scatter` supports [built-in trendlines with accessible model output](/python/linear-fits/).

packages/python/plotly/plotly/express/_chart_types.py

@@ -631,6 +631,11 @@ def scatter_3d(
     y=None,
     z=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     symbol=None,
     size=None,
     text=None,
@@ -683,6 +688,11 @@ def line_3d(
     y=None,
     z=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     line_dash=None,
     text=None,
     line_group=None,
@@ -730,6 +740,11 @@ def scatter_ternary(
     b=None,
     c=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     symbol=None,
     size=None,
     text=None,
@@ -770,6 +785,11 @@ def line_ternary(
     b=None,
     c=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     line_dash=None,
     line_group=None,
     hover_name=None,
@@ -805,6 +825,11 @@ def scatter_polar(
     r=None,
     theta=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     symbol=None,
     size=None,
     hover_name=None,
@@ -850,6 +875,11 @@ def line_polar(
     r=None,
     theta=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     line_dash=None,
     hover_name=None,
     hover_data=None,
@@ -892,6 +922,11 @@ def bar_polar(
     r=None,
     theta=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     hover_name=None,
     hover_data=None,
     custom_data=None,
@@ -1095,6 +1130,11 @@ def scatter_mapbox(
     lat=None,
     lon=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     text=None,
     hover_name=None,
     hover_data=None,
@@ -1135,6 +1175,11 @@ def choropleth_mapbox(
     featureidkey=None,
     locations=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     hover_name=None,
     hover_data=None,
     custom_data=None,
@@ -1171,6 +1216,11 @@ def density_mapbox(
     lat=None,
     lon=None,
     z=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     hover_name=None,
     hover_data=None,
     custom_data=None,
@@ -1208,6 +1258,11 @@ def line_mapbox(
     lat=None,
     lon=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     text=None,
     hover_name=None,
     hover_data=None,
@@ -1241,6 +1296,11 @@ def scatter_matrix(
     data_frame=None,
     dimensions=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     symbol=None,
     size=None,
     hover_name=None,
@@ -1280,6 +1340,11 @@ def parallel_coordinates(
     data_frame=None,
     dimensions=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     labels=None,
     color_continuous_scale=None,
     range_color=None,
@@ -1304,6 +1369,11 @@ def parallel_categories(
     data_frame=None,
     dimensions=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     labels=None,
     color_continuous_scale=None,
     range_color=None,
@@ -1331,6 +1401,11 @@ def pie(
     names=None,
     values=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     color_discrete_sequence=None,
     color_discrete_map=None,
     hover_name=None,
@@ -1380,6 +1455,11 @@ def sunburst(
     path=None,
     ids=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     color_continuous_scale=None,
     range_color=None,
     color_continuous_midpoint=None,
@@ -1430,6 +1510,11 @@ def treemap(
     ids=None,
     path=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     color_continuous_scale=None,
     range_color=None,
     color_continuous_midpoint=None,
@@ -1518,6 +1603,11 @@ def funnel_area(
     names=None,
     values=None,
     color=None,
+    facet_row=None,
+    facet_col=None,
+    facet_col_wrap=0,
+    facet_row_spacing=None,
+    facet_col_spacing=None,
     color_discrete_sequence=None,
     color_discrete_map=None,
     hover_name=None,