So far, many of the readings and all of the labs you have been working with have been interactive. You are working in an environment that allows us to both display text and run Python code. In this lesson, we explore Jupyter, the software powering these interactive documents.
Jupyter is a web application that allows someone to create and work with documents that have live code. It's a very popular tool among data scientists, as it allows for both explanation of thinking behind code as well as the code itself.
The notebook itself consists of cells. Double click on this content to see what I mean. Once we double click on a cell, we are in insert mode. This means that we are able to edit the cells, just as you would if this were a word document. We can tell that we are in insert mode because of the green border around the cell.
After entering insert mode for this cell, change some content. Don't worry about what you change as we can always undo it. We can revert our changes to a cell by making sure that we are still in insert mode and by pressing
command + z on a mac or
control + z on windows.
To get out of insert mode and see the effect of our changes, press
shift + enter.
We have already seen, to alter the contents of a cell we simply double click on that cell, bringing us into insert mode, and then change the contents. Now let's see how to add, and delete cells from escape mode.
If we wish to quickly add a new cell we can do so with the following steps:
bto create a new cell.
To delete a cell we once again should be in escape mode, and then press the
Of course, we'll want a way to undo our deletion. From escape mode, you can press
z to undo deletion of a cell. Note that this is different from
cmd + z. Pressing
cmd + z while in insert mode undoes any changes inside of a cell while, whether these changes be deletions or text insertions. Pressing
z from escape mode undoes the deletion a cell.
Go to escape mode and press
x. This cell disappears!
Then bring it back with
The current cell and every other cell in this lesson has been a markdown cell, meaning that it allows us to write text and stylize that text. For example, if you surround some text with stars on either side the text becomes bold. That's markdown.
Cells can also have a type of code. If we are writing in a cell that is for Python code, everything in that cell must be valid Python or we will see an error.
This is a python cell without valid Python so we will see an error
So, a cell must either be of type markdown or of type code, in which case all of the contents must be valid Python. It cannot be both. We can quickly change a cell from markdown to code with some keyboard shortcuts.
From escape mode, we change a cell to type code by pressing the letter
Anytime we create a new cell, say with the shortcut key
b, the new cell will default to code mode. We can switch to escape mode and press the letter
m to change the cell from code to markdown.
Press the key
h while in escape mode to view the menu for all of Jupyter's shortcuts.
Ok, now that we know a little bit about adding and deleting cells, as well as changing cell types from markdown to code, let's focus on working with Python in Jupyter. We'll go into a large amount of detail about working with a Jupyter notebook in Python, but the main takeaway is this: if we see a Python cell, we should press
shift + enter on that cell.
The major gotcha in working with Python code is that we must execute the cells in order for Python to register the code in them. So for example, just seeing the cell where we define
'bob' below does not write that cell to memory.
name = 'bob'
If we try to reference that variable later on without having executed the cell, Python will tell us that it is not defined.
--------------------------------------------------------------------------- NameError Traceback (most recent call last) <ipython-input-4-9bc0cb2ed6de> in <module>() ----> 1 name NameError: name 'name' is not defined
To execute or run a cell, we must press
shift + enter from escape mode on that cell. Upon running a cell, Python will show the the last line of the cell's return value underneath. Let's run the cell below to see this:
age = 14 age
As you can see the variable
age is set to 14, so when the cell is run
14 is displayed underneath.
One tricky thing to note is that assignment, the action of assigning a variable, does not have a return a value. So, even though the cell is run, if the last line of cell is the assigning of a variable, nothing is displayed underneath.
hometown = 'NYC'
Notice, even after pressing shift + enter on the code above, nothing is displayed below. But if we reference the variable
hometown, we see that the cell was run as the variable was defined.
Yes, it's pretty confusing, but the important thing to take away is that we need to run our cells with Python code by pressing
shift + enterif we want Python to read our variables and functions and remember them later on. Remember, in the case of assignment, the return value is
None, which does not show an output. We can see this more concretely below by running the cell below:
As you read through labs we encourage you to press shift + enter on each of the Python cells. Often in labs, we will assign variables to data early on. Then we will ask you to work with data stored in those variables. To avoid going to the top of the lab to press
shift + enter, it's best just to press that while reading along.
The same thing goes for working through a Readme. The Readmes will often assign data to variables, and it may be nice to work with data stored in those variables later on. So it's a good idea to press
shift + enter, and now that you know how to work with Jupyter notebooks, you can always modify the notebooks with new code to test your understanding.
In this lesson, we learned about Jupyter notebooks. We saw that in Jupyter notebooks, we can either be in insert mode or escape mode. While in insert mode, we can edit the cells and undo changes within that cell with
cmd + z on a mac or
ctl + z on windows. In escape mode, we can add cells with
b, delete a cell with
x, and undo deletion of a cell with
z. We can also change the type of a cell to markdown with
m and to Python code with
Then we saw how to work with Python code in Jupyter notebooks. We saw that to have our code in a cell executed, we need to press
shift + enter. If we do not do this, then our variables that we assigned in Python are not going to be recognized by Python later on in our Jupyter notebook.