added 3d surface example

emmanuelle · emmanuelle · commit d4941b7b17c4 · 2019-12-04T14:49:37.000-05:00
diff --git a/doc/python/3d-surface-plots.md b/doc/python/3d-surface-plots.md
@@ -20,14 +20,14 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.6.7
+    version: 3.7.3
   plotly:
     description: How to make 3D-surface plots in Python
     display_as: 3d_charts
     language: python
     layout: base
     name: 3D Surface Plots
-    order: 3
+    order: 6
     page_type: example_index
     permalink: python/3d-surface-plots/
     thumbnail: thumbnail/3d-surface.jpg
@@ -52,6 +52,31 @@ fig.update_layout(title='Mt Bruno Elevation', autosize=False,
 fig.show()
 ```
 
+### Passing x and y data to 3D Surface Plot
+
+If you do not specify `x` and `y` coordinates, integer indices are used for the `x` and `y` axis. You can also pass `x` and `y` values to `go.Surface`. 
+
+```python
+import plotly.graph_objects as go
+
+import pandas as pd
+import numpy as np
+
+# Read data from a csv
+z_data = pd.read_csv('https://raw.githubusercontent.com/plotly/datasets/master/api_docs/mt_bruno_elevation.csv')
+z = z_data.values
+sh_0, sh_1 = z.shape
+x, y = np.linspace(0, 1, sh_0), np.linspace(0, 1, sh_1)
+
+fig = go.Figure(data=[go.Surface(z=z, x=x, y=y)])
+
+fig.update_layout(title='Mt Bruno Elevation', autosize=False,
+                  width=500, height=500,
+                  margin=dict(l=65, r=50, b=65, t=90))
+
+fig.show()
+```
+
 #### Surface Plot With Contours
 
 
@@ -76,35 +101,7 @@ fig.update_layout(title='Mt Bruno Elevation', autosize=False,
 
 fig.show()
 ```
-#### Configure Surface Contour Levels
-This example shows how to slice the surface graph on the desired position for each of x, y and z axis. [contours.x.start](https://plot.ly/python/reference/#surface-contours-x-start) sets the starting contour level value, `end` sets the end of it, and `size` sets the step between each contour level. 
-
-```python
-import plotly.graph_objects as go
 
-fig = go.Figure(go.Surface(
-    contours = {
-        "x": {"show": True, "start": 1.5, "end": 2, "size": 0.04, "color":"white"},
-        "z": {"show": True, "start": 0.5, "end": 0.8, "size": 0.05}
-    },
-    x = [1,2,3,4,5],
-    y = [1,2,3,4,5],
-    z = [
-        [0, 1, 0, 1, 0],
-        [1, 0, 1, 0, 1],
-        [0, 1, 0, 1, 0],
-        [1, 0, 1, 0, 1],
-        [0, 1, 0, 1, 0]
-    ]))
-fig.update_layout(
-        scene = {
-            "xaxis": {"nticks": 20},
-            "zaxis": {"nticks": 4},
-            'camera_eye': {"x": 0, "y": -1, "z": 0.5},
-            "aspectratio": {"x": 1, "y": 1, "z": 0.2}
-        })
-fig.show()
-```
 #### Multiple 3D Surface Plots
 
 ```python
