update of streamtube

Author: emmanuelle

unconverted/python/streamtube-plot.md renamed to python/streamtube-plot.md

@@ -6,11 +6,21 @@ jupyter:
       extension: .md
       format_name: markdown
       format_version: '1.1'
-      jupytext_version: 1.1.1
+      jupytext_version: 1.2.3
   kernelspec:
-    display_name: Python 2
+    display_name: Python 3
     language: python
-    name: python2
+    name: python3
+  language_info:
+    codemirror_mode:
+      name: ipython
+      version: 3
+    file_extension: .py
+    mimetype: text/x-python
+    name: python
+    nbconvert_exporter: python
+    pygments_lexer: ipython3
+    version: 3.7.3
   plotly:
     description: How to make 3D streamtube plots in Python with Plotly.
     display_as: 3d_charts
@@ -26,37 +36,23 @@ jupyter:
     title: 3D Streamtube Plots | Plotly
 ---
 
-#### New to Plotly?
-Plotly's Python library is free and open source! [Get started](https://plot.ly/python/getting-started/) by downloading the client and [reading the primer](https://plot.ly/python/getting-started/).
-<br>You can set up Plotly to work in [online](https://plot.ly/python/getting-started/#initialization-for-online-plotting) or [offline](https://plot.ly/python/getting-started/#initialization-for-offline-plotting) mode, or in [jupyter notebooks](https://plot.ly/python/getting-started/#start-plotting-online).
-<br>We also have a quick-reference [cheatsheet](https://images.plot.ly/plotly-documentation/images/python_cheat_sheet.pdf) (new!) to help you get started!
-
-
-#### Version Check
-Plotly's python package is updated frequently. Run `pip install plotly --upgrade` to use the latest version.
-
-```python
-import plotly
-plotly.__version__
-```
 
 ### Introduction
 
 
-In streamtube plots, attributes inlcude `x`, `y`, and `z`, which set the coorindates of the vector field, and `u`, `v`, and `w`, which sets the x, y, and z components of the vector field. Additionally, you can use `starts` to determine the streamtube's starting position. Lastly, `maxdisplayed` determines the maximum segments displayed in a streamtube.
+In streamtube plots, attributes inlcude `x`, `y`, and `z`, which set the coordinates of the vector field, and `u`, `v`, and `w`, which sets the x, y, and z components of the vector field. Additionally, you can use `starts` to determine the streamtube's starting position. Lastly, `maxdisplayed` determines the maximum segments displayed in a streamtube.
 
 
 ### Basic Streamtube Plot
 
 ```python
-import plotly.plotly as py
-import plotly.graph_objs as go
+import plotly.graph_objects as go
 
 import pandas as pd
 
 df = pd.read_csv('https://raw.githubusercontent.com/plotly/datasets/master/streamtube-basic.csv')
 
-data = [go.Streamtube(
+fig = go.Figure(data=go.Streamtube(
     x = df['x'],
     y = df['y'],
     z = df['z'],
@@ -67,10 +63,10 @@ data = [go.Streamtube(
     colorscale = 'Blues',
     cmin = 0,
     cmax = 3
-    )
-]
+))
+
 
-layout = go.Layout(
+fig.update_layout(
     scene = dict(
       camera = dict(
         eye = dict(
@@ -82,21 +78,108 @@ layout = go.Layout(
     )
 )
 
-fig = go.Figure(data=data, layout=layout)
-py.iplot(fig, filename='streamtube-basic')
+fig.show()
+```
+
+```python
+import numpy as np
+import plotly.graph_objects as go
+
+x, y, z = np.mgrid[1:4:10j, 1:4:10j, 1:4:10j] 
+u = 0.0001 * x**2
+v = 0.005 * np.random.random(y.shape)
+w = 0.1 * z
+
+sx=np.linspace(1, 4, 10, endpoint=True)
+sx, sy=np.meshgrid(sx, sx)
+sz=np.ones(sx.shape)
+
+
+fig = go.Figure(data=go.Streamtube(
+    x=x.ravel(), 
+    y=y.ravel(), 
+    z=z.ravel(), 
+    u=u.ravel(), 
+    v=v.ravel(), 
+    w=w.ravel(), 
+    starts=dict(x=sx.flatten(),
+                             y=sy.flatten(),
+                             z=sz.flatten()),
+    hovertext='w',
+    sizeref=0.3
+))
+fig.show()
+```
+
+```python
+import numpy as np
+import plotly.graph_objects as go
+
+x, y, z = np.mgrid[1:2:4j, 1:2:4j, 1:2:4j]
+u = np.zeros_like(x)
+v = x.copy()
+w = np.zeros_like(z)
+
+fig = go.Figure(data=go.Streamtube(x=x.ravel(), y=y.ravel(), z=z.ravel(),
+                                   u=u.ravel(), v=v.ravel(), w=w.ravel(),
+                                   hoverinfo=['x', 'y']
+))
+fig.show()
+```
+
+```python
+x.ravel(), y.ravel(), z.ravel(), v.ravel()
+```
+
+```python
+v.ravel()
+```
+
+```
+fig.data
+
+```
+
+```python
+import numpy as np
+import plotly.graph_objects as go
+
+x, y, z = np.mgrid[-4:4:20j, -4:4:20j, 0:4:20j] 
+r = np.sqrt(x ** 2 + y ** 2 + z ** 2 + 0.1) 
+#u = 0.1 * y * np.sin(r) / r 
+u = 0.005 * np.random.random(x.shape)
+v = 0.005 * np.random.random(y.shape)
+#v = -0.1 * x * np.sin(r) / r 
+w = 0.1 * z
+
+sx=np.linspace(-4, 4, 10)
+sx, sy=np.meshgrid(sx, sx)
+sz=np.ones(sx.shape)
+
+
+fig = go.Figure(data=go.Streamtube(
+    x=x.ravel(), y=y.ravel(), z=z.ravel(), u=u.ravel(), v=v.ravel(), w=w.ravel(), 
+    starts=dict(x=sx.flatten(),
+                             y=sy.flatten(),
+                             z=sz.flatten()),
+))
+fig.show()
+```
+
+```python
+df
 ```
 
 ### Starting Position and Segments
 
 ```python
-import plotly.plotly as py
-import plotly.graph_objs as go
+import plotly.graph_objects as go
 
 import pandas as pd
 
 df = pd.read_csv('https://raw.githubusercontent.com/plotly/datasets/master/streamtube-wind.csv').drop(['Unnamed: 0'],axis=1)
 
-data = [go.Streamtube(
+fig = go.Figure(data=go.Streamtube(
     x = df['x'],
     y = df['y'],
     z = df['z'],
@@ -112,9 +195,9 @@ data = [go.Streamtube(
     colorscale = 'Portland',
     showscale = False,
     maxdisplayed = 3000
-)]
+))
 
-layout = go.Layout(
+fig.update_layout(
     scene = dict(
         aspectratio = dict(
             x = 2,
@@ -130,31 +213,13 @@ layout = go.Layout(
     )
 )
 
-fig = go.Figure(data=data, layout=layout)
-py.iplot(fig, filename="streamtube wind")
+fig.show()
 ```
 
-#### Reference
-See https://plot.ly/python/reference/ for more information and chart attribute options!
-
 ```python
-from IPython.display import display, HTML
-
-display(HTML('<link href="//fonts.googleapis.com/css?family=Open+Sans:600,400,300,200|Inconsolata|Ubuntu+Mono:400,700" rel="stylesheet" type="text/css" />'))
-display(HTML('<link rel="stylesheet" type="text/css" href="http://help.plot.ly/documentation/all_static/css/ipython-notebook-custom.css">'))
-
-! pip install git+https://github.com/plotly/publisher.git --upgrade
-import publisher
-publisher.publish(
-    'streamtube.ipynb', 'python/streamtube-plot/', '3D Streamtube Plots',
-    'How to make 3D streamtube plots in Python with Plotly.',
-    title = '3D Streamtube Plots | Plotly',
-    has_thumbnail='true', thumbnail='thumbnail/streamtube.jpg',
-    language='python',
-    display_as='3d_charts', order=21, ipynb='~notebook_demo/207',
-    uses_plotly_offline=False)
+df
 ```
 
-```python
+#### Reference
+See https://plot.ly/python/reference/ for more information and chart attribute options!
 
-```