Merge e0f4c46 into f881acc

doc/User_Guide/Annotating_Data.rst

@@ -0,0 +1,2 @@
+Annotating your Data
+____________________

doc/User_Guide/Data_Pipelines.rst

@@ -0,0 +1,2 @@
+Data Transformation Pipelines
+_____________________________

doc/User_Guide/Dimensioned_Containers.rst

@@ -0,0 +1,2 @@
+Dimensioned Containers
+______________________

doc/User_Guide/IPython_Magics.rst

@@ -0,0 +1,2 @@
+IPython Magics
+______________

doc/User_Guide/Plots_and_Renderers.rst

@@ -0,0 +1,2 @@
+Working with Plot and Renderers
+_______________________________

doc/User_Guide/Plotting_with_Matplotlib.rst

@@ -0,0 +1,2 @@
+Plotting with Matplotlib
+________________________

doc/conf.py

@@ -52,8 +52,8 @@
     ),
     # Links
     'LINKS': (
-        ('Getting started', 'Getting_Started/index.html'),
-        ('User Guides', 'User_Guide/index.html'),
+        ('Getting started', 'getting_started/index.html'),
+        ('User Guide', 'user_guide/index.html'),
         ('Tutorials', 'Tutorials/index.html'),
         ('Gallery', 'Gallery/index.html'),
         ('Reference', 'Reference_Manual/index.html'),
@@ -71,8 +71,8 @@
     ),
     # Links for the docs sub navigation
     'NAV_DOCS': (
-        ('Getting started', 'Getting_Started/index'),
-        ('User Guides', 'User_Guide/index'),
+        ('Getting started', 'getting_started/index'),
+        ('User Guide', 'user_guide/index'),
         ('Tutorials', 'Tutorials/index'),
         ('Gallery', 'gallery/index'),
         ('Reference', 'Reference_Manual/index'),

doc/getting_started/Customization.rst

@@ -0,0 +1,5 @@
+Customization
+_____________
+
+.. notebook:: holoviews ../../examples/getting_started/2-Customization.ipynb
+    :offset: 1

doc/getting_started/Gridded_Datasets.rst

@@ -0,0 +1,5 @@
+Gridded Datasets
+________________
+
+.. notebook:: holoviews ../../examples/getting_started/4-Gridded_Datasets.ipynb
+    :offset: 1

doc/getting_started/Introduction.rst

@@ -0,0 +1,5 @@
+Introduction
+____________
+
+.. notebook:: holoviews ../../examples/getting_started/1-Introduction.ipynb
+    :offset: 1

doc/getting_started/Live_Data.rst

@@ -0,0 +1,6 @@
+Live Data
+_________
+
+.. notebook:: holoviews ../../examples/getting_started/5-Live_Data.ipynb
+    :skip_output: When run live, this cell's output should match the behavior of the GIF below
+    :offset: 1

doc/getting_started/Tabular_Datasets.rst

@@ -0,0 +1,5 @@
+Tabular Datasets
+________________
+
+.. notebook:: holoviews ../../examples/getting_started/3-Tabular_Datasets.ipynb
+    :offset: 1

doc/getting_started/index.rst

@@ -0,0 +1,21 @@
+Welcome to HoloViews!
+_____________________
+
+This 'Getting Started' guide aims to get you using HoloViews productively as quickly as possible. It is designed as an entrypoint for new users that will introduce the core concepts necessary to get you working productively with your own data. We recommend reading this guide in order if you wish to get an overview of what is offered by HoloViews. For detailed documentation, please consult our `User Guide <../user_guide/index.html>`_ which we will link to from the appropriate sections of this guide.
+
+* `Introduction <Introduction.html>`_
+* `Customization <Customization.html>`_
+* `Tabular Datasets <Tabular_Datasets.html>`_
+* `Gridded Datasets <Gridded_Datasets.html>`_
+* `Live Data <Live_Data>`_
+
+.. toctree::
+    :titlesonly:
+    :hidden:
+    :maxdepth: 2
+
+    Introduction <Introduction>
+    Customization <Customization>
+    Tabular Datasets <Tabular_Datasets>
+    Gridded Datasets <Gridded_Datasets>
+    Live Data <Live_Data>

doc/index.rst

@@ -139,6 +139,8 @@ showing how to fix the bug or implement the feature!
    :maxdepth: 2
 
    Home <self>
+   Getting Started <getting_started/index>
+   User Guide <user_guide/index>
    Features <features>
    Tutorials <Tutorials/index>
    Examples <Examples/index>

doc/user_guide/Building_Composite_Objects.rst

@@ -0,0 +1,5 @@
+Building Composite Objects
+__________________________
+
+.. notebook:: holoviews ../../examples/user_guide/05-Building_Composite_Objects.ipynb
+    :offset: 1

doc/user_guide/Continuous_Coordinates.rst

@@ -0,0 +1,5 @@
+Continuous Coordinates
+______________________
+
+.. notebook:: holoviews ../../examples/user_guide/Continuous_Coordinates.ipynb
+    :offset: 1

doc/user_guide/Custom_Interactivity.rst

@@ -0,0 +1,5 @@
+Custom Interactivity
+____________________
+
+.. notebook:: holoviews ../../examples/user_guide/12-Custom_Interactivity.ipynb
+    :offset: 1

doc/user_guide/Customizing_Plots.rst

@@ -0,0 +1,5 @@
+Customizing Plots
+_________________
+
+.. notebook:: holoviews ../../examples/user_guide/03-Customizing_Plots.ipynb
+    :offset: 1

doc/user_guide/Deploying_Bokeh_Apps.rst

@@ -0,0 +1,6 @@
+Deploying Bokeh Apps
+____________________
+
+.. notebook:: holoviews ../../examples/user_guide/Deploying_Bokeh_Apps.ipynb
+    :skip_execute: True
+    :offset: 1

doc/user_guide/Exporting_and_Archiving.rst

@@ -0,0 +1,5 @@
+Exporting and Archiving
+_______________________
+
+.. notebook:: holoviews ../../examples/user_guide/Exporting_and_Archiving.ipynb
+    :offset: 1

doc/user_guide/Gridded_Datasets.rst

@@ -0,0 +1,5 @@
+Gridded Datasets
+________________
+
+.. notebook:: holoviews ../../examples/user_guide/08-Gridded_Datasets.ipynb
+    :offset: 1

doc/user_guide/Indexing_and_Selecting_Data.rst

@@ -0,0 +1,5 @@
+Indexing and Selecting Data
+___________________________
+
+.. notebook:: holoviews ../../examples/user_guide/09-Indexing_and_Selecting_Data.ipynb
+    :offset: 1

doc/user_guide/Large_Data.rst

@@ -0,0 +1,5 @@
+Working with large data using datashader
+________________________________________
+
+.. notebook:: holoviews ../../examples/user_guide/14-Large_Data.ipynb
+    :offset: 1

doc/user_guide/Live_Data.rst

@@ -0,0 +1,5 @@
+Live Data
+_________
+
+.. notebook:: holoviews ../../examples/user_guide/06-Live_Data.ipynb
+    :offset: 1

doc/user_guide/Plotting_with_Bokeh.rst

@@ -0,0 +1,5 @@
+Plotting with Bokeh
+___________________
+
+.. notebook:: holoviews ../../examples/user_guide/Plotting_with_Bokeh.ipynb
+    :offset: 1

doc/user_guide/Responding_to_Events.rst

@@ -0,0 +1,5 @@
+Responding to Events
+____________________
+
+.. notebook:: holoviews ../../examples/user_guide/11-Responding_to_Events.ipynb
+    :offset: 1

doc/user_guide/Tabular_Datasets.rst

@@ -0,0 +1,5 @@
+Tabular Datasets
+________________
+
+.. notebook:: holoviews ../../examples/user_guide/07-Tabular_Datasets.ipynb
+    :offset: 1

doc/user_guide/Transforming_Elements.rst

@@ -0,0 +1,5 @@
+Transforming Elements
+_____________________
+
+.. notebook:: holoviews ../../examples/user_guide/10-Transforming_Elements.ipynb
+    :offset: 1

doc/user_guide/index.rst

@@ -0,0 +1,137 @@
+User Guide
+__________
+
+
+Core guides
+-----------
+
+These user guides provide detailed explanation of some of the core
+concepts in HoloViews:
+
+* `Annotating your Data <Annotating_Data.html>`_
+  How to wrap your data in Element and annotate it with additional
+  metadata to explore and visualize it effectively.
+
+* `Composition of Elements <Composing_Elements.html>`_
+  Composing your wrapped data into ``Overlay`` and ``Layout``
+  collections with the ``+`` and ``*`` operators.
+
+* `Customizing Plots <Customizing_Plots.html>`_
+  Applying plot, style and normalization options to control the look
+  and feel of the plotting.
+
+* `Dimensioned Containers <Dimensioned_Containers.html>`_
+  Declaring multi-dimensional containers to animate and facet your
+  data flexibly. Learn about ``HoloMap``, ``NdOverlay``, ``GridSpace``
+  and ``NdLayout`` types and how to use them effectively with the
+  corresponding ``.layout``, ``.overlay`` and ``.grid`` method.
+
+* `Building Composite Objects <Building_Composite_Objects.html>`_
+  How to build and work with complex composite objects.
+
+* `Live Data <Live_Data.html>`_
+  Introducing ``DynamicMap`` to lazily declare data and generate
+  complex interactive visualizations.
+
+* `Tabular Datasets <Tabular_Datasets.html>`_
+  Loading and wrapping tabular datasets in HoloViews using NumPy,
+  pandas and dask and flexibly exploring the dataset using selection,
+  grouping and aggregation.
+
+* `Gridded Datasets <Gridded_Datasets.html>`_
+  Loading and wrapping gridded dataset in HoloViews using NumPy and
+  XArray to flexibly explore and visualize labelled n-dimensional
+  arrays.
+
+* `Indexing and Selecting Data <Indexing_and_Selecting_Data.html>`_
+  Effectively indexing and selecting subsets of the data on the
+  different HoloViews datastructures.
+
+* `Transforming Elements <Transforming_Elements.html>`_
+  Applying and declaring ``Operations`` that transform your allowing
+  you to define the building blocks of a data analysis pipeline and
+  quickly explore and visualize the effect of different parameters on
+  your data.
+
+* `Responding to Events <Responding_to_Events.html>`_
+  Effectively using ``Streams`` to dynamically control and drive your
+  visualizations by responding to user defined events such as custom
+  widgets or from the commandline or notebook.
+
+* `Custom Interactivity <Custom_Interactivity.html>`_
+  Using linked ``Streams`` to respond to events generated by
+  interacting with a bokeh plot, e.g. by responding to mouse position,
+  mouse taps, selections or the current axis range.
+
+* `Data Transformation Pipelines <Data_Pipelines.html>`_
+  Chaining different operations to build complex and lazy data
+  analysis pipelines, which can drive interactive plots in a notebook
+  or in a deployed dashboard.
+
+* `Working with large data <Large_Data.html>`_
+  Leveraging datashader support in HoloViews to effectively and
+  interactively explore and visualize millions or even billions of
+  datapoints.
+
+
+Supplementary guides
+--------------------
+
+These guides provide detail about specific additional features in HoloViews:
+
+* `Plotting with Bokeh <Plotting_with_Bokeh.html>`_
+  The basics of plotting with bokeh including details about plot tools
+  and backend specific styling options and working with bokeh models
+  more directly.
+
+* `Deploying Bokeh Apps <Deploying_Bokeh_Apps.html>`_
+  Instructions on how to declare and deploy bokeh apps using HoloViews
+  in various scenarios, e.g. from scripts, from the commandline and
+  within the notebook.
+
+* `Plotting with matplotlib <Plotting_with_Matplotlib.html>`_
+  The basics of plotting with matplotlib highlighting core differences
+  in styling and controlling the layout of matplotlib figures.
+
+* `Plotting with plotly <Plotting_with_Plotly.html>`_
+  The basics of plotting with plotly focusing on 3D plotting, one of
+  the main strengths of plotly.
+
+* `Working with renderers and plots <Plots_and_Renderers.html>`_
+  Using HoloViews Renderer and Plot classes directly to access and
+  manipulate your visualizations directly.
+
+* `Exporting and Archiving <Exporting_and_Archiving.html>`_
+  Using HoloViews to archive both your data and visualization from the
+  notebook.
+
+* `Continuous Coordinates <Continuous_Coordinates.html>`_ Details on
+  how continuous coordinates are handled in HoloViews specifically
+  focusing on the difference between ``Image`` and other ``Raster`` types.
+
+
+.. toctree::
+    :titlesonly:
+    :hidden:
+    :maxdepth: 2
+
+    Annotating your Data <Annotating_Data>
+    Composition of Elements <Composing_Elements>
+    Customizing Plots <Customizing_Plots>
+    Dimensioned Containers <Dimensioned_Containers>
+    Building Composite Objects <Building_Composite_Objects>
+    Live Data <Live_Data>
+    Tabular Datasets <Tabular_Datasets>
+    Gridded Datasets <Gridded_Datasets>
+    Indexing and Selecting Data <Indexing_and_Selecting_Data>
+    Transforming Elements <Transforming_Elements>
+    Responding to Events <Responding_to_Events>
+    Custom Interactivity <Custom_Interactivity>
+    Working with large data <Large_Data>
+    Plotting with Bokeh <Plotting_with_Bokeh>
+    Deploying Bokeh Apps <Deploying_Bokeh_Apps>
+    Plotting with matplotlib <Plotting_with_Matplotlib>
+    Plotting with plotly <Plotting_with_Plotly>
+    Working with Plot and Renderers <Plots_and_Renderers>
+    Exporting and Archiving <Exporting_and_Archiving>
+    Continuous Coordinates <Continuous_Coordinates>

examples/README.rst

@@ -1,7 +1,7 @@
 
 When working on a notebook in examples/ make sure to run ``python
 examples.py reference Example.ipynb`` to locate any references to that
-notebook in the documenation.
+notebook in the documentation.
 
 If there are any such references, please check that the content of those
 pages is still correct.

examples/assets/penguins.png

@@ -0,0 +1 @@
+../../examples/elements/assets/penguins.png

examples/assets/station_info.csv

@@ -0,0 +1,61 @@
+name,lat,lon,opened,services,service_names,ridership
+First Avenue,40.730953,-73.981628,1924,1,['L'],7.70211
+Second Avenue,40.723402,-73.989938,1936,1,['F'],5.84771
+Third Avenue,40.732849,-73.986122,1924,1,['L'],2.386533
+Fifth Avenue,40.753821,-73.981963,1920,6,"['7', 'E', 'M', 'N', 'R', 'W']",16.220605
+Sixth Avenue,40.737335,-73.996786,1924,1,['L'],16.121318
+Seventh Avenue,40.762862,-73.981637,1919,7,"['B', 'D', 'E', 'N', 'Q', 'R', 'W']",12.013107
+Eighth Street,40.730328,-73.992629,1917,4,"['N', 'Q', 'R', 'W']",5.894747
+14th Street,40.737826,-74.000201,1918,8,"['1', '2', '3', 'A', 'C', 'E', 'F', 'M']",30.885045
+14th Street–Union Square,40.734673,-73.989951,1904,8,"['4', '5', '6', 'L', 'N', 'Q', 'R', 'W']",35.320623
+18th Street,40.74104,-73.997871,1918,2,"['1', '2']",2.676304
+23rd Street,40.739864,-73.986599,1904,13,"['1', '2', '4', '6', 'A', 'C', 'E', 'F', 'M', 'N', 'Q', 'R', 'W']",38.264231
+28th Street,40.74307,-73.984264,1904,8,"['1', '2', '4', '6', 'N', 'Q', 'R', 'W']",15.962813
+33rd Street,40.746081,-73.982076,1904,2,"['4', '6']",9.701723
+34th Street,40.750373,-73.991057,1917,15,"['1', '2', '3', '7', 'A', 'B', 'C', 'D', 'E', 'F', 'M', 'N', 'Q', 'R', 'W']",54.456594
+42nd Street,40.757308,-73.989735,1932,7,"['A', 'B', 'C', 'D', 'E', 'F', 'M']",66.359208
+49th Street,40.759901,-73.984139,1919,4,"['N', 'Q', 'R', 'W']",8.029988
+51st Street,40.757107,-73.97192,1918,2,"['4', '6']",20.479923
+57th Street,40.764664,-73.980658,1968,1,['F'],4.720245
+59th Street,40.762526,-73.967967,1918,3,"['4', '5', '6']",25.566655
+59th Street–Columbus Circle,40.768247,-73.981929,1904,6,"['1', '2', 'A', 'B', 'C', 'D']",23.299666
+66th Street–Lincoln Center,40.77344,-73.982209,1904,2,"['1', '2']",7.790234
+68th Street–Hunter College,40.768141,-73.96387,1918,2,"['4', '6']",10.237854
+72nd Street,40.778453,-73.98197,1904,8,"['1', '2', '3', 'A', 'B', 'C', 'N', 'Q']",16.320597
+77th Street,40.77362,-73.959874,1918,2,"['4', '6']",12.738039
+81st Street–Museum of Natural History,40.781433,-73.972143,1932,3,"['A', 'B', 'C']",4.584041
+96th Street,40.785672,-73.95107,1904,10,"['1', '2', '3', '4', '6', 'A', 'B', 'C', 'N', 'Q']",24.38848
+103rd Street,40.7906,-73.947478,1904,6,"['1', '4', '6', 'A', 'B', 'C']",9.810965
+110th Street,40.79502,-73.94425,1904,4,"['2', '3', '4', '6']",4.209449
+116th Street,40.798629,-73.941617,1904,7,"['2', '3', '4', '6', 'A', 'B', 'C']",11.518755
+Astor Place,40.730054,-73.99107,1904,2,"['4', '6']",5.447655
+Bleecker Street,40.725915,-73.994659,1904,2,"['4', '6']",12.666868
+Bowery,40.72028,-73.993915,1913,2,"['J', 'Z']",1.18492
+Bowling Green,40.704817,-74.014065,1905,2,"['4', '5']",9.153462
+Broad Street,40.706476,-74.011056,1931,2,"['J', 'Z']",1.83478
+Broadway–Lafayette Street,40.725297,-73.996204,1936,4,"['B', 'D', 'F', 'M']",12.666868
+Brooklyn Bridge–City Hall,40.713065,-74.004131,1904,3,"['4', '5', '6']",10.481576
+Canal Street,40.718092,-73.999892,1904,13,"['1', '2', '4', '6', 'A', 'C', 'E', 'J', 'N', 'Q', 'R', 'W', 'Z']",22.936298
+Chambers Street,40.71419,-74.003199,1913,7,"['1', '2', '3', 'A', 'C', 'J', 'Z']",34.446431
+Christopher Street,40.733422,-74.002906,1918,2,"['1', '2']",3.363949
+City Hall,40.713282,-74.006978,1918,3,"['N', 'R', 'W']",1.828806
+Cortlandt Street,40.710668,-74.011029,1918,3,"['N', 'R', 'W']",2.713532
+Delancey Street,40.718611,-73.988114,1936,1,['F'],8.226975
+East Broadway,40.713715,-73.990173,1936,1,['F'],4.576662
+Essex Street,40.718315,-73.987437,1908,3,"['J', 'M', 'Z']",8.226975
+Franklin Street,40.719318,-74.006886,1918,2,"['1', '2']",1.731354
+Fulton Street,40.710374,-74.007582,1905,8,"['2', '3', '4', '5', 'A', 'C', 'J', 'Z']",23.315037
+Grand Central–42nd Street,40.751776,-73.976848,1904,5,"['4', '5', '6', '7', 'S']",46.737564
+Grand Street,40.711926,-73.94067,1967,2,"['B', 'D']",10.253621
+Houston Street,40.728251,-74.005367,1918,2,"['1', '2']",4.377409
+Lexington Avenue,40.76266,-73.967258,1920,7,"['E', 'F', 'M', 'N', 'Q', 'R', 'W']",21.407792
+Prince Street,40.724329,-73.997702,1917,4,"['N', 'Q', 'R', 'W']",5.386641
+Rector Street,40.707513,-74.013783,1918,4,"['1', 'N', 'R', 'W']",4.939783
+Roosevelt Island,40.759145,-73.95326,1989,1,['F'],1.966493
+South Ferry,40.702068,-74.013664,2009,1,['1'],8.750364
+Spring Street,40.722301,-73.997141,1904,5,"['4', '6', 'A', 'C', 'E']",7.586717
+Times Square–42nd Street,40.754672,-73.986754,1917,7,"['1', '2', '3', 'N', 'Q', 'R', 'W']",66.359208
+Wall Street,40.707557,-74.011862,1905,4,"['2', '3', '4', '5']",14.359598
+West Fourth Street,40.732338,-74.000495,1932,7,"['A', 'B', 'C', 'D', 'E', 'F', 'M']",14.147148
+Whitehall Street,40.703087,-74.012994,1918,3,"['N', 'R', 'W']",8.750364
+World Trade Center,40.712582,-74.009781,1932,1,['E'],16.910084