Merge pull request #7 from ibdafna/04_widget_libraries

Add revised notebooks for 'Additional Widget Libraries'

Author: mwcraig

README.md

@@ -1,42 +1,7 @@
-# JupyterCon Tutorial
+# Tools for managing a collection of notebooks
 
-[JupyterCon](https://jupytercon.com) will use this template to create a new repository for each tutorial, with speakers added as collaborators. 
+## Credit and license
 
-We also include here [instructions for tutorial speakers](https://github.com/jupytercon/tutorial2020/blob/master/Tutorial_Speakers_Guide.md). 
-Please follow these instructions carefully, and email us if you have questions: [[email protected]](mailto:[email protected])
+Some of these tools (and all of the idea for them) is from [Jake VanerPlas](https://jakevdp.github.io/)'s [Python Data Science Handbook](https://github.com/jakevdp/PythonDataScienceHandbook).
 
-You can delete this file (or rename it) and replace it by a README file that targets the contents of this repository, populated with your tutorial materials.
-
-## Tutorial Chairs for 2020
-
-- Tania Allard, Microsoft
-- Gerard Gorman, University College London
-
-## General information
-
-JupyterCon 2020 is an online event that places heavy emphasis on providing learning opportunities for all participants. 
-It is a project of [NumFOCUS](https://numfocus.org), with a fully volunteer team of organizers.
-
-### What is NumFOCUS?
-
-> NumFOCUS is a 501(c)-3 non-profit in the United States. 
-Its mission is to promote open practices in research, data, and scientific computing by serving as a fiscal sponsor for open source projects and organizing community-driven educational programs. 
-NumFOCUS envisions an inclusive scientific and research community that utilizes actively supported open source software to make impactful discoveries for a better world.
-
-## Format for tutorials
-
-Tutorials will consist of on-demand video presentations, and written materials presented in Jupyter notebooks. 
-The notebooks should be complete and polished, amply narrated worked-out examples and exercises for participants. 
-
-Tutorial basic format:
-
-- Three or four Jupyter notebooks (at minimum), each notebook corresponding to "one lesson" – printed, estimate between 10–20 pages, or 17 to 35 min to read, per notebook.
-- Estimate for the material to be 1.5 to 3 hours to work through interactively.
-- The notebooks are complemented with videos, 25–30 min in length (not longer); at least one video per notebook.
-- Optional exercises for participants, instrumented for auto-grading.
-- One full tutorial may add up to total-time-on-task by the learners of about 4.5 hours.
-
-## License
-
-The source materials for JupyterCon tutorials are copyright of their authors. 
-We ask that materials be shared under standard public licenses. We recommend code be under BSD-3 or MIT license, and other materials be under a CC-BY Creative Commons Attribution license.
+The files `add_navigation.py`  and `generate_contents.py` are modified from the same files in the Handbook, whose code license, a copy of which is in [licenses/LICENSE-CODE](licenses/LICENSE-CODE).

notebooks/04.Widget-libraries/04.00-widget_libraries.ipynb

@@ -0,0 +1,71 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<!--NAVIGATION-->\n",
+    "| [Contents](00.00-index.ipynb) | [ipyleaflet: Interactive maps](04.01-ipyleaflet.ipynb) >"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# More widget libraries"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "There are several widget libraries beyond the core `ipywidgets`. This non-exhaustive list includes a variety of plotting, data analysis, mapping and 3d rendering packages. We will explore some of them in this section.\n",
+    "\n",
+    "### Author your own widgets library\n",
+    "\n",
+    " * [ipywidgets: Building a Custom Widget - Email Widget](https://ipywidgets.readthedocs.io/en/stable/examples/Widget%20Custom.html)\n",
+    " * [medium: Authoring Custom Jupyter Widgets](https://blog.jupyter.org/authoring-custom-jupyter-widgets-2884a462e724)\n",
+    " * cookiecutters:\n",
+    "    * https://github.com/jupyter-widgets/widget-cookiecutter\n",
+    "    * https://github.com/jupyter-widgets/widget-ts-cookiecutter\n",
+    "    \n",
+    "### Widgets libraries presented in this tutorial\n",
+    "\n",
+    "01. [ipyleaflet: Interactive maps](04.01-ipyleaflet.ipynb)\n",
+    "02. [ipympl: The Matplotlib Jupyter Widget Backend](04.02-ipympl.ipynb)\n",
+    "03. [bqplot: complex interactive visualizations](04.03-bqplot.ipynb)\n",
+    "04. [ipycanvas: Interactive Canvas](04.04-ipycanvas.ipynb)\n",
+    "05. [ipyvolume: 3D plotting in the notebook](04.05-ipyvolume.ipynb)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<!--NAVIGATION-->\n",
+    "| [Contents](00.00-index.ipynb) | [ipyleaflet: Interactive maps](04.01-ipyleaflet.ipynb) >"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "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.8.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}