Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 7 additions & 18 deletions 01_intro_to_jupyter.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -27,17 +27,13 @@
"\n",
"Jupyter notebooks have two main types of cells: **Markdown** and **Code**.\n",
"\n",
"**Markdown** cells allow you to use symbols that are then rendered into nicely formatted text, tables, images, etc. [Markdown](https://en.wikipedia.org/wiki/Markdown) was created in 2004 as a plain text languge for generating formatted text that was itself readable in plain text. It is now widely used across many platforms. While there is a base standard, implementations can differ in some details. The official [Jupyter Notebook markdown](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html) documentation provides a good overview. You will mostly not need to create markdown for the *Practicum AI* courses, but it will be used to provide the explanatory information for you as you run the code.\n",
"**Markdown** cells allow you to use symbols that are then rendered into nicely formatted text, tables, images, etc. [Markdown](https://en.wikipedia.org/wiki/Markdown) was created in 2004 as a plain text language for generating formatted text that was itself readable in plain text. It is now widely used across many platforms. While there is a base standard, implementations can differ in some details. The official [Jupyter Notebook markdown](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html) documentation provides a good overview. You will mostly not need to create markdown for the *Practicum AI* courses, but it will be used to provide the explanatory information for you as you run the code.\n",
"\n",
"### To do\n",
"\n",
"* **Double click on this cell to see the raw Markdown text that is rendered to create the formatted text.**\n",
"* **For Jupyter on an HPC cluster**: \n",
"* **Double-click on this cell to see the raw Markdown text that is rendered to create the formatted text.**\n",
" * When you are done, either click the play button in the top row, or type Shift-Enter on your keyboard.\n",
" ![Screenshot showing the play button in Jupyter to run code cells or render Markdown cells](https://github.com/magitz/computing-for-ai/blob/main/images/Jupyter_play.png?raw=1)\n",
"* **For Google Colab**:\n",
" * Google Colab has a slightly different Markdown editor view that splits the screen. Markdown is shown on the left, and formatted text on the right. You can even use the text formatting tools on the right to auto-generate the markdown. Rather than using the play button to render Markdown, simply click out of the cell and the split will return to the rendered view.\n",
" ![Screenshot showing the split screen Markdown editor in Google Colab](https://github.com/magitz/computing-for-ai/blob/main/images/Colab_Markdown.png?raw=1)"
" ![Screenshot showing the play button in Jupyter to run code cells or render Markdown cells](https://github.com/practicumai/computing-for-ai-ars/blob/main/images/Jupyter_play.png?raw=1)\n"
]
},
{
Expand All @@ -47,14 +43,7 @@
"id": "6fd0f4e0-26ef-463c-a341-94b279ca2208"
},
"source": [
"## Now run the code cell below\n",
"\n",
"<div style=\"padding: 10px;margin-bottom: 20px;border: thin solid #30335D;border-left-width: 10px;background-color: #fff\">\n",
" <p><strong>Note:</strong> <strong>For Google Colab</strong>: When you run the first cell in a notebook, you will see a warning that the notebook is not authored by Google. You will need to click the <strong>Run anyway</strong> button to run the notebook.<br>\n",
" \n",
" <img src='https://github.com/magitz/computing-for-ai/blob/main/images/Colab_Run_anyway.png?raw=1' height=100 alt='Screenshot of the Google Colab warning that the notebook is not authored by Google. Click the Run anyway button.'>\n",
" </p>\n",
" </div>"
"## Now run the code cell below\n"
]
},
{
Expand Down Expand Up @@ -89,12 +78,12 @@
"\n",
"The image below highlights the expected output from the code cell above. \n",
"\n",
"![Screenshot of the cell after execution highlighting the parts described in the text below](https://github.com/magitz/computing-for-ai/blob/main/images/Jupyter_Code_Cell.png?raw=1)\n",
"![Screenshot of the cell after execution highlighting the parts described in the text below](https://github.com/practicumai/computing-for-ai-ars/blob/main/images/Jupyter_Code_Cell.png?raw=1)\n",
"\n",
"* The cell execution counter to the left of the cell will have a number in square brackets. That helps you keep track of which cells have been run and in what order. \n",
" * If a cell has not been run, it will not have a number. \n",
" * Cells in a notebook can be run in any order, and the order does matter. Keep that in mind and check the numbers if you get unexpected results. Typically, it is best to start at the top and work your way down, but sometimes you will skip around--just be careful when you do that.\n",
" * While a cell is running, the square brackets will have an asterisk ([\\*]). Some cells, especially model training cells, can take some time to run. While one cell is running, all other cells will be blocked from running. In a notebook, only one cell can run at a time.\n",
" * While a cell is running, the square brackets will have an asterisk (`[*]`). Some cells, especially model training cells, can take some time to run. While one cell is running, all other cells will be blocked from running. In a notebook, only one cell can run at a time.\n",
"* Code cells can have text comments on lines that start with a hashtag (#). Comments can also end a line of code; anything after the hashtag is a comment.\n",
" * Comments are one way of documenting your code and make it easier for you and others to know what each cell or line of code is doing.\n",
"* Code in the cells is what will be run when you execute the cell. Jupyter applies contextual coloring to the code to help enhance readability and help you catch typos--if you forget to close the quoted text for example, the red color continues past where you wanted to stop."
Expand Down Expand Up @@ -138,7 +127,7 @@
"source": [
"## Add your notes\n",
"\n",
"Use this cell to add some notes to yourself on Jupyter notebooks (remember, you will need to double click to edit the contents of a markdown cell).\n",
"Use this cell to add some notes to yourself on Jupyter notebooks (remember, you will need to double-click to edit the contents of a markdown cell).\n",
"\n",
"* Notebooks have two types of cells:\n",
" * Markdown cells where I can use Markdown to create formatted text.\n",
Expand Down
108 changes: 0 additions & 108 deletions 02_git_configuration_Google_Colab.ipynb

This file was deleted.

Loading