Fix and improve 3D docs

Author: kMutagene

docs/01_2_multiple-charts.fsx

@@ -255,7 +255,7 @@ let multipleTraceTypesGrid =
         Chart.Point([1,2; 2,3])
         Chart.PointTernary([1,2,3; 2,3,4])
         Chart.Heatmap([[1; 2];[3; 4]], ShowScale=false)
-        Chart.Point3d([1,3,2])
+        Chart.Point3D([1,3,2])
         Chart.PointMapbox([1,2]) |> Chart.withMapbox(Mapbox.init(Style = StyleParam.MapboxStyle.OpenStreetMap))
         [
             // you can use nested combined charts, but they have to have the same trace type (Cartesian2D in this case)

docs/03_0_3d-scatter-plots.fsx

@@ -30,15 +30,18 @@ index: 1
 
 *Summary:* This example shows how to create three-dimensional point and line charts in F#.
 
-A Scatter3d chart report shows a three-dimensional spinnable view of your data
+Point3D, Line3D, and Bubble3D charts are all derived from `Chart.Scatter3D` and can be generated by that function as well.
+However, `Chart.Point3D`, `Chart.Line3D`, or `Chart.Bubble3D` provide sensible defaults and arguments for the respective derived chart, and are recommended to use.
+
+## 3D point chart
 *)
 
 open Plotly.NET 
 
 let point3d = 
-    Chart.Point3d(
+    Chart.Point3D(
         [1,3,2; 6,5,4; 7,9,8],
-        Labels = ["A"; "B"; "C"],
+        MultiText = ["A"; "B"; "C"],
         TextPosition = StyleParam.TextPosition.BottomCenter
     )
     |> Chart.withXAxisStyle("my x-axis", Id=StyleParam.SubPlotId.Scene 1) // in contrast to 2D plots, x and y axes of 3D charts have to be set via the scene object
@@ -55,16 +58,35 @@ point3d
 point3d |> GenericChart.toChartHTML
 (*** include-it-raw ***)
 
+(**
+## 3D point chart with marker colorscale
+*)
+
+let point3d2 = 
+    Chart.Point3D(
+        [1,3,2; 6,5,4; 7,9,8],
+        MarkerColor = Color.fromColorScaleValues [0;1;2],
+        MultiText = ["A"; "B"; "C"],
+        TextPosition = StyleParam.TextPosition.BottomCenter
+    )
 
+(*** condition: ipynb ***)
+#if IPYNB
+point3d2
+#endif // IPYNB
+
+(***hide***)
+point3d2 |> GenericChart.toChartHTML
+(*** include-it-raw ***)
 
 (**
-# 3D Line plots
+# 3D Line chart
 *)
 
 let line3d = 
-    Chart.Line3d(
+    Chart.Line3D(
         [1,3,2; 6,5,4; 7,9,8],
-        Labels = ["A"; "B"; "C"],
+        MultiText = ["A"; "B"; "C"],
         TextPosition = StyleParam.TextPosition.BottomCenter,
         ShowMarkers = true
     )
@@ -78,15 +100,39 @@ line3d
 line3d |> GenericChart.toChartHTML
 (*** include-it-raw ***)
 
+(**
+## 3D line chart with line colorscale
+*)
+
+let line3d2 = 
+    Chart.Line3D(
+        [1,3,2; 6,5,4; 7,9,8],
+        MultiText = ["A"; "B"; "C"],
+        TextPosition = StyleParam.TextPosition.BottomCenter,
+        ShowMarkers = true,
+        LineColor = Color.fromColorScaleValues [0;1;2],
+        LineWidth = 10.
+    )
+
+(*** condition: ipynb ***)
+#if IPYNB
+line3d2
+#endif // IPYNB
+
+(***hide***)
+line3d2 |> GenericChart.toChartHTML
+(*** include-it-raw ***)
+
+
 (**
 # 3D Bubble plots
 *)
 
 let bubble3d =
-    Chart.Bubble3d(
+    Chart.Bubble3D(
         [1,3,2; 6,5,4; 7,9,8],
         [10;20;30],
-        Labels = ["A"; "B"; "C"],
+        MultiText = ["A"; "B"; "C"],
         TextPosition = StyleParam.TextPosition.BottomCenter
     )
 
@@ -97,4 +143,29 @@ bubble3d
 
 (***hide***)
 bubble3d |> GenericChart.toChartHTML
-(*** include-it-raw ***)
+(*** include-it-raw ***)
+
+
+(**
+## 3D bubble chart with colorscale
+*)
+
+let bubble3d2 = 
+    Chart.Bubble3D(
+        [1,3,2; 6,5,4; 7,9,8],
+        [10;20;30],
+        MultiText = ["A"; "B"; "C"],
+        TextPosition = StyleParam.TextPosition.BottomCenter,
+        MarkerColor = Color.fromColorScaleValues [0;1;2],
+        MarkerColorScale = StyleParam.Colorscale.Viridis
+    )
+
+(*** condition: ipynb ***)
+#if IPYNB
+bubble3d2
+#endif // IPYNB
+
+(***hide***)
+bubble3d2 |> GenericChart.toChartHTML
+(*** include-it-raw ***)
+

docs/03_2_3d-mesh-plots.fsx

@@ -65,7 +65,7 @@ let c = Array.init 50 (fun _ -> rnd.NextDouble())
 open Plotly.NET.TraceObjects
 
 let mesh3d =
-    Trace3D.initMesh3d 
+    Trace3D.initMesh3D 
         (fun mesh3d ->
             mesh3d?x <- a
             mesh3d?y <- b