Python in Jupyter: Difference between revisions

Latest revision as of 20:46, 27 March 2023

We are going to practice writing and running Python programs (often called "scripts").

Download a Jupyter Notebook[edit]

Save the file CDSW_Jupyter_test_notebook.ipynb from the following link to your desktop: CDSW Jupter test notebook (To save, (on Windows) right click the link and choose "save link as..." On a Mac, Option + click will do the same).

If you're using a new Mac, it may change the name of your file from ending in .ipynb to ending in .txt. If this happens, these steps should fix the problem:

Type COMMAND-i (get info) and then click on the "type" section.
Remove the .txt at the end of the file name and hit TAB.
When your Mac asks you if you want to do this, say yes.
Save it as a .ipynb file (rename it if you forget).

Make sure you save it on the CDSW folder you've created on your desktop. (Or drag it into that folder).

Open the Notebook in Jupyter Web Browser[edit]

Start Jupyter as you were instructed to in a previous step. In the Jupyter tab in your browser, navigate to your desktop in the list of folders and click on CDSW_Jupyter_test_notebook.ipynb.

Test the notebook[edit]

Following the instructions in the notebook, run the cell (by clicking the "run" button in the tool bar or press "ENTER + SHIFT") that says:

 print("hello world")

You should see "hello world" output right below. If that works you have a working setup for Python and Jupyter. If that doesn't work, you should ask for assistance!

Feel free to play around in the notebook. Try it out and explore!

P.S. Feel free to try out Python commands in this notebook. It's for you to play with!

Success! You have a working Python and Jupyter setup![edit]

@@ Line 1: / Line 1: @@
 We are going to practice writing and running Python programs (often called "scripts").
-TODO:
-* Download a sample notebook
-* Make sure the notebook is in your desktop (this keeps things simple)
-* Open the notebook in jupyter tab in browser.
-* Notebook itself should encourage them to run some cells.
-* Terminal navigation instructions below should be updated to work for MacOS and Windows
-* [[Windows terminal navigation|terminal navigation on Windows]] and [[MacOS_terminal_navigation|terminal navigation on Mac]] instructions should be checked/updated, too.
 === Download a Jupyter Notebook ===
-Save the file at the following link and then open it.
-[https://communitydata.science/~groceryheist/CDSW_Jupyter_test_notebook%20.ipynb CDSW Jupter test notebook]
-===Download and start your text editor ===
-[[File:Anaconda home window.png|frameless|400px]]
-# Launch Anaconda Navigator
-# Find the '''"VSCode"''' application in the Anaconda Navigator '''"Home"''' window. If it is not yet installed, click "Install" (this may take a few minutes)
-# Launch the VSCode text editor.
-===Write and save a short Python script===
+Save the file <code>CDSW_Jupyter_test_notebook.ipynb</code> from the following link to your desktop: [https://communitydata.science/~groceryheist/CDSW_Jupyter_test_notebook.ipynb CDSW Jupter test notebook]
+(To save, (on Windows) right click the link and choose "save link as..." On a Mac, Option + click will do the same).
-# Click "New file" to start a new, blank text file.
+If you're using a new Mac, it may change the name of your file from ending in <code>.ipynb</code> to ending in .txt. If this happens, these steps should fix the problem:
-# Add the following line to your new text file:
-<pre>
+* Type COMMAND-i (get info) and then click on the "type" section.
-print("Hello World!")
+* Remove the <code>.txt</code> at the end of the file name and hit TAB.
-</pre>
+* When your Mac asks you if you want to do this, say yes.
+* Save it as a <code>.ipynb</code> file (rename it if you forget).
-# Save the script as <code>hello.py</code> in your Desktop directory. The <code>.py</code> extension indicates that this file contains Python code.
+Make sure you save it on the CDSW folder you've created on your desktop. (Or drag it into that folder).
-=== Navigate to the script in your terminal ===
+=== Open the Notebook in Jupyter Web Browser ===
-# Start a new terminal prompt. See the [[Windows terminal navigation|terminal navigation on Windows]] or [[MacOS_terminal_navigation|terminal navigation on Mac]] instructions for the steps to do this. Recall that on Windows a terminal prompt will look like <code>C:\</code> and a Python prompt will look like <code>>>></code>. Make sure you are at a terminal prompt and not a Python prompt; if you are at a Python prompt, you can type <code>exit()</code> on a line by itself and then press enter to exit Python and return to a terminal prompt.
+Start Jupyter as you were instructed to in a previous step.
-# Navigate to your Desktop directory from a PowerShell terminal prompt, using the <code>ls</code> and <code>cd</code> commands. See the [[Windows terminal navigation|terminal navigation on Windows]] or [[MacOS_terminal_navigation|terminal navigation on Mac]] instructions for a refresher on using these commands. Don't hesitate to get help from a mentor on this step if you need it -- it's a new way of navigating around your computer, so it may be unintuitive at first!
+In the Jupyter tab in your browser, navigate to your desktop in the list of folders and click on <code>CDSW_Jupyter_test_notebook.ipynb</code>.
-=== Run the script ===
-# Once you are in your Desktop directory, you'll see <code>hello.py</code> in the output of <code>ls</code>.
-# Type
-<pre>
+=== Test the notebook ===
-python hello.py
-</pre>
-and press enter. Doing this will cause Python to execute the contents of that script -- it should print "Hello World!" to the screen. What you've done here is run the Python application with an argument -- the name of a file, in this case "hello.py". Python knows that when you give it a file name as an argument, it should execute the contents of the provided file. You get the same result as if you typed
+Following the instructions in the notebook, run the cell (by clicking the "run" button in the tool bar or press "ENTER + SHIFT") that says:
+  print("hello world")
-<pre>
+You should see "hello world" output right below. If that works you have a working setup for Python and Jupyter. If that doesn't work, you should ask for assistance!
-print("Hello World!")
-</pre>
-at a Python prompt and press enter.
+Feel free to play around in the notebook. Try it out and explore!
-=== Success ===
+P.S. Feel free to try out Python commands in this notebook. It's for you to play with!
-You created and ran your first Python script!
-* When you run the <code>python</code> command by itself, you start a Python prompt. You can execute Python code interactively at that prompt.
+=== Success! You have a working Python and Jupyter setup! ===
-* When you run the <code>python</code> command with a file name as an argument, Python executes the Python code in that file.
 [[File:Champagne.png|100px]][[File:Party.png|125px]]
 [[Category:CDSW]][[Category:Shared Pages]]