
Gallery of Notebook Examples
==============================

Demo Examples
------------------
The following notebooks demonstrates how Lux can be used with a variety of different datasets and analysis

- Basic walkthrough of Lux with the Cars dataset [`Source <https://github.com/lux-org/lux-binder/blob/master/demo/cars_demo.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/demo/cars_demo.ipynb>`_]
- Basic walkthrough of Lux with the College dataset [`Source <https://github.com/lux-org/lux-binder/blob/master/demo/college_demo.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/demo/college_demo.ipynb>`_]
- Understanding Global COVID-19 intervention levels [`Source <https://github.com/lux-org/lux-binder/blob/master/demo/hpi_covid_demo.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/demo/hpi_covid_demo.ipynb>`_]
- Understanding factors leading to Employee attrition [`Source <https://github.com/lux-org/lux-binder/blob/master/demo/employee_demo.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/demo/employee_demo.ipynb>`_]

If you would like to try out Lux on your own, we provide a `notebook environment <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/demo/exercise/4-Data-Playground.ipynb>`_ for you to play around with several provided example datasets.

Tutorials
---------

The following tutorials cover the most basic to advanced features in Lux. The first five tutorials introduces the core features in Lux:

- Overview of Features in Lux [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/0-overview.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/0-overview.ipynb>`_]
- Specifying user analysis intent in Lux [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/1-specifying-intent.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/1-specifying-intent.ipynb>`_]
- Creating quick-and-dirty visualizations with :code:`Vis` and :code:`VisList` [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/2-constructing-vis-and-vislist.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/2-constructing-vis-and-vislist.ipynb>`_]
- Seamless export of :code:`Vis` from notebook to downstream tasks [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/3-widget-vis-export.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/3-widget-vis-export.ipynb>`_]
- Customizing plot styling with :code:`lux.config.plotting_style` [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/4-chart-settings.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/4-chart-settings.ipynb>`_]

The following notebooks covers more advanced topics in Lux: 

- Understanding data types in Lux [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/9-datatype.ipynb?>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/9-datatype.ipynb?raw=true>`_]
- Working with datetime columns [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/tutorial/5-datetime.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/5-datetime.ipynb>`_] 
- Working with geographic columns [`ReadTheDocs <https://lux-api.readthedocs.io/en/latest/source/advanced/map.html>`_] 
- Working with dataframe indexes [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/tutorial/6-index-group.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/6-index-group.ipynb>`_]
- Registering custom recommendation actions [`Source <https://github.com/lux-org/lux-binder/blob/master/tutorial/8-custom-action.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/tutorial/8-custom-action.ipynb>`_]
- Using Lux with a SQL Database [`Source <https://github.com/lux-org/lux-binder-sql/blob/master/notebooks/Using%20Lux%20with%20SQL%20Databases.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder-sql/HEAD>`_]


Exercise
---------

Here are some teaching resources on Lux. The materials are suited for a 1-1.5 hour industry bootcamp or lecture for a data visualization or data science course. Here is a `video <https://www.youtube.com/watch?v=YANIids_Nkk>`_ that walks through these hands-on exercise on Lux. To follow along, check out the instructions `here <https://github.com/lux-org/lux-binder>`_.

1. How to specify your analysis interests as `intents` in Lux? [`Source <https://github.com/lux-org/lux-binder/blob/master/exercise/1-Specify-Intent.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/exercise/1-Specify-Intent.ipynb>`_]

2. How to create visualizations using :code:`Vis` and :code:`VisList`? [`Source <https://github.com/lux-org/lux-binder/blob/master/exercise/2-Quick-Vis.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/exercise/2-Quick-Vis.ipynb>`_]

3. How to export selected visualization for downstream sharing? [`Source <https://github.com/lux-org/lux-binder/blob/master/exercise/3-Export-Widget.ipynb>`_] [`Live Notebook <https://mybinder.org/v2/gh/lux-org/lux-binder/master?urlpath=tree/exercise/3-Export-Widget.ipynb>`_]

Here are the `solutions <https://github.com/lux-org/lux-binder/blob/master/exercise/solution.txt>`_ to the notebook exercises.


Community Contributions
-------------------------
Here are some awesome articles and tutorials written by the Lux community: 

- `Exploring the Penguins dataset with Lux by Parul Pandey <https://towardsdatascience.com/intelligent-visual-data-discovery-with-lux-a-python-library-dc36a5742b2f>`_
- `Analysis of the Wine dataset by Domino Data Lab <https://blog.dominodatalab.com/faster-data-exploration-in-jupyter-through-the-lux-widget/>`_
- `Quick Recommendation-Based Data Exploration with Lux by Cornellius Yudha Wijaya <https://towardsdatascience.com/quick-recommendation-based-data-exploration-with-lux-f4d0ccb68133>`_
- `Analyzing the Graduate Admissions dataset with Lux by Pranavi Duvva <https://pub.towardsai.net/speed-up-eda-with-the-intelligent-lux-37f96542527b>`_


If you would like your notebook or articles to be featured here, please submit a pull request `here <https://github.com/lux-org/lux-binder>`_ to let us know!