====== Jupyter/IPython documentation/usage tips (work in progress) ======

===== Introduction =====


{{:jupyter.svg|}}

The [[http://www.jupyter.org | Jupyter project]] provides open source, interactive data science and scientific computing across over 40 programming languages. It used to be called IPython (just changed its name recently to reflect the fact that it now supports other programming languages other than python)


The Jupyter notebook is a web application that allows you to create and share documents that contain live code, equations, visualizations and explanatory text. Uses include: data cleaning and transformation, numerical simulation, statistical modeling, machine learning and much more.

We will use the Jupyter notebook for most of our Python Problem Sets.


==== Getting started with the Jupyter/IPython notebook (work in progress) ====

In the Virtual Machine, open the Jupyter Notebook desktop shortcut. That will open Firefox with a list of the directories/files that Jupyter can access. Select ''example_notebooks'' and then ''intro_to_jupyter_notebook.ipynb''.

Follow the instructions in the example notebook.
Our first recitation (Friday 09/09) will cover how to get started with the course VM and the Jupyter notebook.

==== Interesting example Jupyter notebooks ====

  * Official IPython example notebooks. You can find these in your VM in ''example_notebooks/Learning/Official_IPython_examples/Notebook/Index.ipynb''. This is a good resource to learn how to use the Jupyter notebook
  * [[http://nbviewer.ipython.org/|Nbviewer]]: Nbviewer renders Jupyter notebooks (.ipynb files) as static web pages that you can see online (although you lose the ability to execute the code). It can display .ipynb notebooks online from people's Github repositories and other places. 
  * [[https://github.com/ipython/ipython/wiki/A-gallery-of-interesting-IPython-Notebooks|The official gallery of interesting IPython Notebooks]] contains hundreds of interesting examples
  * Peter Norvig's IPython notebooks

=== Peter Norvig's IPython notebooks ===

Peter Norvig has created many cool IPython notebooks over the years. The are all very interesting. Try [[http://nbviewer.ipython.org/url/norvig.com/ipython/Fred%20Buns.ipynb|Fred Buns.ipynb]], [[http://nbviewer.ipython.org/url/norvig.com/ipython/Cheryl.ipynb|Cheryl.ipynb]] or [[http://nbviewer.ipython.org/url/norvig.com/ipython/TSPv3.ipynb|TSPv3.ipynb]], for example.


  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Cheryl-and-Eve.ipynb|Cheryl-and-Eve.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Cheryl.ipynb|Cheryl.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Convex%20Hull.ipynb|Convex Hull.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Economics.ipynb|Economics.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Fred%20Buns.ipynb|Fred Buns.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Gesture%20Typing.ipynb|Gesture Typing.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/Golomb-Puzzle.ipynb|Golomb-Puzzle.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/How%20to%20Do%20Things%20with%20Words.ipynb|How to Do Things with Words.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/TSPv3.ipynb|TSPv3.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/xkcd1313-original.ipynb|xkcd1313-original.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/xkcd1313-part2.ipynb|xkcd1313-part2.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/xkcd1313-part2c.ipynb|xkcd1313-part2c.ipynb]]
  * [[http://nbviewer.ipython.org/url/norvig.com/ipython/xkcd1313.ipynb|xkcd1313.ipynb]]