Merge pull request #193 from cecilehannay/main

Prerequisites and resources: made some additions
NCAR · Jun 27, 2024 · 95d3d49 · 95d3d49
2 parents 8e51ff6 + 790de8b
commit 95d3d49
Show file tree

Hide file tree

Showing 4 changed files with 99 additions and 10 deletions.
diff --git a/notebooks/prereqs/exercises.ipynb b/notebooks/prereqs/exercises.ipynb
@@ -40,7 +40,9 @@
     "\n",
     "</div>\n",
     "\n",
-    "Where `username` is replaced with your tutorial username. Your derecho login will be used through out the tutorial. If you have difficulty getting this to work please ask for help. If you are in the in person tutorial there will be helpers available. If you are doing this outside of the tutorial then you can contact the user support from the NCAR Computational and Information Systems Laboratory (CISL)."
+    "Where `username` is replaced with your tutorial username. Your derecho login will be used through out the tutorial. If you have difficulty getting this to work please ask for help. \n",
+    "- If you are in the in-person tutorial at NCAR, there will be helpers available.\n",
+    "- If you are doing this outside of the tutorial then you can contact the user support from the NCAR Computational and Information Systems Laboratory (CISL)."
    ]
   },
   {
@@ -129,7 +131,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.12"
+   "version": "3.10.13"
   }
  },
  "nbformat": 4,

diff --git a/notebooks/prereqs/prereqs_overview.ipynb b/notebooks/prereqs/prereqs_overview.ipynb
@@ -16,12 +16,12 @@
     "NOTE: Although the materials and notebooks in this tutorial are published as a Jupyter Book, **you will need to use a terminal window to actually run the commands presented in this tutorial.**\n",
     "\n",
     "To successfully complete this tutorial you will:\n",
-    "- Utilize a terminal window\n",
-    "- Issue commands at the command line using UNIX\n",
-    "- Need to be able to access and run on the NCAR HPC assets (HPC = High Performance Computing)\n",
-    "- Use JupyterHub for some basic diagnostic plotting\n",
+    "- Utilize a **terminal** window\n",
+    "- Issue commands at the **command line** using **UNIX**\n",
+    "- Need to be able to access and run on the **NCAR HPC systems** (HPC = High Performance Computing)\n",
+    "- Use **JupyterHub** for some basic diagnostic plotting\n",
     "\n",
-    "The links below provide more information about these topics. If you are not familiar any of the four topics above, we strongly recommend that you read through the following sections."
+    "The links below provide more information about these topics. **If you are not familiar any of the four topics above, we strongly recommend that you read through the following sections.**"
    ]
   },
   {

diff --git a/notebooks/resources/terminals.ipynb b/notebooks/resources/terminals.ipynb
@@ -47,7 +47,7 @@
     "\n",
     "- `Terminal` is automatically built into the MacOS and clicking on it will open a terminal window.\n",
     "\n",
-    "- `iTerm` is software that was installed by the user on their laptop and is another option for opening a terminal."
+    "- `iTerm` is software that was installed by the user on their laptop and is another option for opening a terminal. (*Recommanded*)"
    ]
   },
   {
@@ -156,7 +156,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.12"
+   "version": "3.10.13"
   }
  },
  "nbformat": 4,

diff --git a/notebooks/resources/unix.ipynb b/notebooks/resources/unix.ipynb
@@ -37,6 +37,93 @@
     "\n",
     "</div>"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "770789d3-867e-41e8-8b3c-9a25cbfab417",
+   "metadata": {},
+   "source": [
+    "## Unix cheatsheet\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "76bc874f-270c-4a05-8fe9-eac874cb0db7",
+   "metadata": {},
+   "source": [
+    "<table border=\"1\" cellpadding=\"5\" cellspacing=\"0\">\n",
+    "  <tr>\n",
+    "    <th>Command</th>\n",
+    "    <th>Description</th>\n",
+    "    <th>Options</th>\n",
+    "    <th>Examples</th>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>ls</b></td>\n",
+    "    <td>List files and directories.</td>\n",
+    "    <td><b>-l</b>: Long format listing.<br><b>-a</b>: Include hidden files.</td>\n",
+    "    <td><b>ls -l</b> <br> displays files and directories with detailed information.<br><br> <b>ls -a</b> shows all files and directories, including hidden ones.<br></td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>cd</b></td>\n",
+    "    <td>Change directory.</td>\n",
+    "    <td>N/A</td>\n",
+    "    <td><b>cd /path/to/directory</b> <br>  changes the current directory to the specified path.</td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>pwd</b></td>\n",
+    "    <td>Print current working directory.</td>\n",
+    "    <td>N/A</td>\n",
+    "    <td><b>pwd</b> <br> displays the current working directory.</td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>mkdir</b></td>\n",
+    "    <td>Create a new directory.</td>\n",
+    "    <td>N/A</td>\n",
+    "    <td><b>mkdir my_directory</b> <br> creates a new directory named \"my_directory\".</td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>rm</b></td>\n",
+    "    <td>Remove files and directories.</td>\n",
+    "    <td><b>-r</b>: Remove directories recursively.<br><b>-f</b>: Force removal without confirmation.</td>\n",
+    "    <td><b>rm file.txt</b> <br> deletes the file named \"file.txt\".<br><b>rm -r my_directory</b> <br> deletes the directory \"my_directory\" and its contents.<br><b>rm -f file.txt</b> <br> forcefully deletes the file \"file.txt\" without confirmation.</td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>cp</b></td>\n",
+    "    <td>Copy files and directories.</td>\n",
+    "    <td><b>-r</b>: Copy directories recursively.</td>\n",
+    "    <td><b>cp -r directory destination</b> <br> copies the directory \"directory\" and its contents to the specified destination.<br><b>cp file.txt destination</b> <br> copies the file \"file.txt\" to the specified destination.</td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>mv</b></td>\n",
+    "    <td>Move/rename files and directories.</td>\n",
+    "    <td>N/A</td>\n",
+    "    <td><b>mv file.txt new_name.txt</b> <br> renames the file \"file.txt\" to \"new_name.txt\".<br><b>mv file.txt directory</b> <br> moves the file \"file.txt\" to the specified directory.</td>\n",
+    "  </tr>\n",
+    "  <tr>\n",
+    "    <td><b>find</b></td>\n",
+    "    <td>Search for files and directories.</td>\n",
+    "    <td><b>-name</b>: Search by filename.</td>\n",
+    "    <td><b>find /path/to/search -name “*.txt”</b> <br> searches for all files with the extension “.txt” in the specified directory.</td>\n",
+    "  </tr>\n",
+    "  </tr>"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "805c8473-8106-4ba6-9d8e-c27cee7fcd7d",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "96f010ce-2005-4a69-9081-7ced219e66ea",
+   "metadata": {},
+   "outputs": [],
+   "source": []
   }
  ],
  "metadata": {
@@ -55,7 +142,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.12"
+   "version": "3.10.13"
   }
  },
  "nbformat": 4,