A brief tour of the IPython notebook

This document will give you a brief tour of the capabilities of the IPython notebook.
@@ -1831,8 +1202,8 @@ system.

The rest of the notebooks in this directory illustrate various other aspects and capabilities of the IPython notebook; some of them may require additional libraries to be executed.

+ -

+ +

In [1]:

@@ -1852,15 +1223,11 @@ so things like shell aliases and magic commands still work:

Out[1]:

- +

Out[1]:

u'/Users/minrk/dev/ip/mine/docs/examples/notebooks'

@@ -1876,14 +1243,11 @@ so things like shell aliases and magic commands still work:

00_notebook_tour.ipynb          callbacks.ipynb                 python-logo.svg
 01_notebook_introduction.ipynb  cython_extension.ipynb          rmagic_extension.ipynb
 Animations_and_Progress.ipynb   display_protocol.ipynb          sympy.ipynb
@@ -1907,29 +1271,26 @@ animation.m4v                   progbar.ipynb

The IPython notebook is great!

Plots with matplotlib

IPython adds an 'inline' matplotlib backend, which embeds any matplotlib figures into the notebook.

@@ -1943,14 +1304,11 @@ which embeds any matplotlib figures into the notebook.

 Welcome to pylab, a matplotlib-based Python environment [backend: module://IPython.zmq.pylab.backend_inline].
 For more information, type 'help(pylab)'.
@@ -1971,15 +1329,11 @@ For more information, type 'help(pylab)'.

- +

You can paste blocks of input with prompt markers, such as those from the official Python tutorial

@@ -2355,21 +1710,19 @@ kL6BgYHBGML/B3suibfww4xPAAAAAElFTkSuQmCC

Be careful not to fall off!

+ +

Errors are shown in informative ways:

@@ -2382,14 +1735,11 @@ kL6BgYHBGML/B3suibfww4xPAAAAAElFTkSuQmCC -

ERROR: File `u'non_existent_file.py'` not found.

@@ -2407,16 +1757,12 @@ kL6BgYHBGML/B3suibfww4xPAAAAAElFTkSuQmCC

----------------------------------------------------------------------------
+
+
+---------------------------------------------------------------------------
 ZeroDivisionError                         Traceback (most recent call last)
 <ipython-input-8-dc39888fd1d2> in <module>()
       1 x = 1
@@ -2428,13 +1774,13 @@ kL6BgYHBGML/B3suibfww4xPAAAAAElFTkSuQmCC

+ +

When IPython needs to display additional information (such as providing details on an object via x? it will automatically invoke a pager at the bottom of the screen:

- -

In [18]:

@@ -2444,9 +1790,9 @@ it will automatically invoke a pager at the bottom of the screen:

+ +

Markdown cells can contain formatted text and code

You can italicize, boldface

@@ -2520,14 +1864,17 @@ ctypes to segfault the Python interpreter:

x += 4; } -

+ +

Courtesy of MathJax, you can include mathematical expressions both inline: $e^{i\pi} + 1 = 0$ and displayed:

$$e^x=\sum_{i=0}^\infty \frac{1}{i!}x^i$$

+ +

Rich displays: include anyting a browser can show

Note that we have an actual protocol for this, see the display_protocol notebook for further details.

@@ -2543,15 +1890,11 @@ $e^{i\pi} + 1 = 0$ and displayed:

Out[1]:

- +

Out[1]:

An image can also be displayed from raw data or a url

@@ -2732,29 +2076,21 @@ HMRRca/E5hVINNIVwI2B56z6/3ExLRI31pXNAAAAAElFTkSuQmCC

Out[2]:

Embedded vs Non-embedded Images

@@ -2864,7 +2198,8 @@ HMRRca/E5hVINNIVwI2B56z6/3ExLRI31pXNAAAAAElFTkSuQmCC -

+ +

Today's image from a webcam at Berkeley, (at the time I created this notebook). This should also work in the Qtconsole. Drawback is that the saved notebook will be larger, but the image will still be present offline.

@@ -2878,15 +2213,11 @@ Drawback is that the saved notebook will be larger, but the image will still be

Out[5]:

- +

Out[5]:

Today's image from same webcam at Berkeley, (refreshed every minutes, if you reload the notebook), visible only with an active internet connexion, that should be different from the previous one. This will not work on Qtconsole. Notebook saved with this kind of image will be lighter and always reflect the current version of the source, but the image won't display offline.

@@ -4099,29 +3431,23 @@ Notebook saved with this kind of image will be lighter and always reflect the cu

Out[6]:

Video

@@ -4143,15 +3469,11 @@ hosted content is trivial):

Out[7]:

Mathematics

And we also support the display of mathematical expressions typeset in LaTeX, which is rendered @@ -4619,21 +3916,18 @@ renders it. The Math object will add the needed LaTeX delimiters (

Out[10]:

- +

Out[10]:

$$F(k) = \int_{-\infty}^{\infty} f(x) e^{2\pi i k} dx$$

+ +

With the Latex class, you have to include the delimiters yourself. This allows you to use other LaTeX modes such as eqnarray:

@@ -4652,15 +3946,11 @@ $$F(k) = \int_{-\infty}^{\infty} f(x) e^{2\pi i k} dx$$ -

Out[11]:

- +

Out[11]:

\begin{eqnarray} \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\ \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\ @@ -4671,7 +3961,8 @@ $$F(k) = \int_{-\infty}^{\infty} f(x) e^{2\pi i k} dx$$

+ +

Or you can enter latex directly with the %%latex cell magic:

@@ -4690,15 +3981,11 @@ $$F(k) = \int_{-\infty}^{\infty} f(x) e^{2\pi i k} dx$$ -

- +

\begin{aligned} \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\ \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\ @@ -4709,15 +3996,15 @@ $$F(k) = \int_{-\infty}^{\infty} f(x) e^{2\pi i k} dx$$

Loading external codes

%%svg

In this notebook we've kept the output saved so you can see the result, but you should run the next cell yourself (with an active internet connection).

+ +

Let's make sure we have pylab again, in case we have restarted the kernel due to the crash demo above

- -

In [12]:

@@ -4740,14 +4027,11 @@ cell yourself (with an active internet connection).

 Welcome to pylab, a matplotlib-based Python environment [backend: module://IPython.zmq.pylab.backend_inline].
 For more information, type 'help(pylab)'.
@@ -4757,9 +4041,7 @@ For more information, type 'help(pylab)'.

- -

In [15]:

@@ -4769,9 +4051,7 @@ For more information, type 'help(pylab)'.

A brief tour of the IPython notebook

Plots with matplotlib

Non-blocking output of kernel

Clean crash and restart

Markdown cells can contain formatted text and code

Rich displays: include anyting a browser can show

Embedded vs Non-embedded Images

Video

Mathematics

Loading external codes