add Splom and Parcats charts in examples and book

 - add extra png's for book TOC

Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>

Author: andrei-ng

docs/book/src/SUMMARY.md

@@ -16,6 +16,7 @@
         - [Bar Charts](./recipes/basic_charts/bar_charts.md)
         - [Pie Charts](./recipes/basic_charts/pie_charts.md)
         - [Sankey Diagrams](./recipes/basic_charts/sankey_diagrams.md)
+        - [Parallel Categories](./recipes/basic_charts/parcats_charts.md)
         - [Treemap Charts](./recipes/basic_charts/treemap_charts.md)
         - [Sunburst Charts](./recipes/basic_charts/sunburst_charts.md)
         - [Icicle Charts](./recipes/basic_charts/icicle_charts.md)
@@ -26,6 +27,7 @@
         - [Violin Plots](./recipes/statistical_charts/violin_plots.md)
         - [Histograms](./recipes/statistical_charts/histograms.md)
         - [2D Histograms](./recipes/statistical_charts/histogram2d.md)
+        - [SPLOM](./recipes/statistical_charts/splom.md)
     - [Scientific Charts](./recipes/scientific_charts.md)
        - [Contour Plots](./recipes/scientific_charts/contour_plots.md)
        - [Heatmaps](./recipes/scientific_charts/heatmaps.md)

docs/book/src/recipes/basic_charts.md

@@ -9,7 +9,8 @@ Line Charts | [![Line Charts](./img/line_shape_options_for_interpolation.png)](.
 Bar Charts | [![Bar Charts](./img/bar_chart_with_error_bars.png)](./basic_charts/scatter_plots.md)
 Pie Charts | [![Pie Charts](./img/pie_charts.png)](./basic_charts/pie_charts.md)
 Sankey Diagrams | [![Sankey Diagrams](./img/basic_sankey.png)](./basic_charts/sankey_diagrams.md)
-Treemap Charts | [Treemap Charts](./basic_charts/treemap_charts.md)
-Sunburst Charts | [Sunburst Charts](./basic_charts/sunburst_charts.md)
-Icicle Charts | [Icicle Charts](./basic_charts/icicle_charts.md)
-Indicator Charts | [Indicator Charts](./basic_charts/indicator_charts.md)
+Parallel Categories | [![Parallel Categories](./img/parallelcat.png)](./basic_charts/parcats_charts.md)
+Treemap Charts | [![Treemap Charts](./img/treemap.png)](./basic_charts/treemap_charts.md)
+Sunburst Charts | [![Sunburst Charts](./img/sunburst.png)](./basic_charts/sunburst_charts.md)
+Icicle Charts | [![Icicle Charts](./img/icicle.png)](./basic_charts/icicle_charts.md)
+Indicator Charts | [![Indicator Charts](./img/indicator.png)](./basic_charts/indicator_charts.md)

docs/book/src/recipes/basic_charts/parcats_charts.md

@@ -0,0 +1,38 @@
+# Parallel Categories
+
+A parallel categories (`parcats`) chart visualizes multi-dimensional categorical
+data as a set of parallel axes, one per category column, with ribbons flowing
+between the categories. Like Sankey diagrams, it is domain-based rather than
+cartesian — each [`ParcatsDimension`](https://docs.rs/plotly/latest/plotly/parcats/struct.ParcatsDimension.html)
+defines one axis, and optional `counts` let you weight aggregated paths instead
+of plotting one row per observation.
+
+The following imports have been used to produce the plots below:
+
+```rust,no_run
+use plotly::color::NamedColor;
+use plotly::common::Domain;
+use plotly::layout::Layout;
+use plotly::parcats::{
+    ParcatsArrangement, ParcatsDimension, ParcatsHoverInfo, ParcatsHoverOn, ParcatsLine,
+    ParcatsLineShape,
+};
+use plotly::{Parcats, Plot};
+```
+
+The `to_inline_html` method is used to produce the html plot displayed in this page.
+
+## Basic Parallel Categories
+```rust,no_run
+{{#include ../../../../../examples/basic_charts/src/main.rs:basic_parcats}}
+```
+
+{{#include ../../../../../examples/basic_charts/output/inline_basic_parcats.html}}
+
+
+## Styled Parallel Categories
+```rust,no_run
+{{#include ../../../../../examples/basic_charts/src/main.rs:styled_parcats}}
+```
+
+{{#include ../../../../../examples/basic_charts/output/inline_styled_parcats.html}}

docs/book/src/recipes/img/icicle.png

@@ -9,3 +9,4 @@ Box Plots | [![Line Charts](./img/box_plot.png)](./statistical_charts/box_plots.
 Violin Plots | [![Violin Plots](./img/violin_plot.png)](./statistical_charts/violin_plots.md)
 Histograms | [![Scatter Plots](./img/overlaid_histogram.png)](./statistical_charts/histograms.md)
 2D Histograms | [![2D Histograms](./img/basic_histogram2d.png)](./statistical_charts/histogram2d.md)
+SPLOM | [![SPLOM](./img/splom.png)](./statistical_charts/splom.md)