Add Scatter3d support (#66)

* scatter 3D plot example running

* added 3D line plot and examples for 3d line plot and surface plot

* fixes and cleanup

* adjusted CHANGELOG.md

* adjusted CHANGELOG.md

* remove unintentionally included test output file

* fix merge

* tweak examples

* derive Default and sort imports

* fix feature-gated import

* add tests

* update book

* fix examples

* add plot3d examples to ci

* update book

* fix newest book examples

Co-authored-by: Michael Freeborn <[email protected]>

Author: mrhrzg

.github/workflows/dev_ci.yml

@@ -33,6 +33,8 @@ jobs:
         run: cargo run --example statistical_charts --release
       - name: Run subplots
         run: cargo run --example subplots --release
+      - name: Run 3D plots
+        run: cargo run --example plot3d --release
 
   build_windows:
     runs-on: windows-latest
@@ -57,6 +59,8 @@ jobs:
         run: cargo run --example statistical_charts --release
       - name: Run subplots
         run: cargo run --example subplots --release
+      - name: Run 3D plots
+        run: cargo run --example plot3d --release
 
   build_macos:
     runs-on: macos-latest
@@ -81,3 +85,5 @@ jobs:
         run: cargo run --example statistical_charts --release
       - name: Run subplots
         run: cargo run --example subplots --release
+      - name: Run 3D plots
+        run: cargo run --example plot3d --release

.github/workflows/release_ci.yml

@@ -33,6 +33,8 @@ jobs:
         run: cargo run --example statistical_charts --release
       - name: Run subplots
         run: cargo run --example subplots --release
+      - name: Run 3D plots
+        run: cargo run --example plot3d --release
 
   build_windows:
     runs-on: windows-latest
@@ -57,6 +59,8 @@ jobs:
         run: cargo run --example statistical_charts --release
       - name: Run subplots
         run: cargo run --example subplots --release
+      - name: Run 3D plots
+        run: cargo run --example plot3d --release
 
   build_macos:
     runs-on: macos-latest
@@ -81,3 +85,5 @@ jobs:
         run: cargo run --example statistical_charts --release
       - name: Run subplots
         run: cargo run --example subplots --release
+      - name: Run 3D plots
+        run: cargo run --example plot3d --release

CHANGELOG.md

@@ -13,6 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for WASM environments
 - Lots of tests
 - Support for `Sankey` diagrams
+- `Plot3D`: Add 3D plots for scatter, line and surface data
 ### Changed
 - Improve implementation of `private::NumOrString` to support more primitive types ([Issue 
 #47](https://github.com/igiagkiozis/plotly/issues/47))

docs/book/src/SUMMARY.md

@@ -11,6 +11,7 @@
         - [Scatter Plots](./recipes/basic_charts/scatter_plots.md)
         - [Line Charts](./recipes/basic_charts/line_charts.md)
         - [Bar Charts](./recipes/basic_charts/bar_charts.md)        
+        - [Sankey Diagrams](./recipes/basic_charts/sankey_diagrams.md)        
     - [Statistical Charts](./recipes/statistical_charts.md)
         - [Error Bars](./recipes/statistical_charts/error_bars.md)
         - [Box Plots](./recipes/statistical_charts/box_plots.md)
@@ -22,6 +23,8 @@
        - [Time Series and Date Axes](./recipes/financial_charts/time_series_and_date_axes.md)
        - [Candlestick Charts](./recipes/financial_charts/candlestick_charts.md)
        - [OHLC Charts](./recipes/financial_charts/ohlc_charts.md)
+    - [3D Charts](./recipes/3dcharts.md)
+        - [Scatter 3D](./recipes/3dcharts/3dcharts.md)
     - [Subplots](./recipes/subplots.md)
         - [Subplots](./recipes/subplots/subplots.md)
         - [Multiple Axes](./recipes/subplots/multiple_axes.md)

docs/book/src/recipes/3dcharts.md

@@ -0,0 +1,7 @@
+# 3D Charts
+
+The complete source code for the following examples can also be found [here](https://github.com/igiagkiozis/plotly/blob/master/plotly/examples/plot3d.rs).
+
+Kind | Link
+:---|:----:
+Scatter3D |[![Scatter 3D Charts](./img/basic_scatter3d.png)](./3dcharts/3dcharts.md)