deploy: c753c60

_sources/docs/howto/jupyterlab_1.ipynb

@@ -35,47 +35,52 @@
     "\n",
     "### Step 1: Open JupyterLab\n",
     "\n",
-    "1. **Using Terminal**:\n",
-    "   - **Open Terminal**:\n",
-    "     - You can find Terminal by using Spotlight Search (press `Cmd + Space` and type \"Terminal\") or by navigating to **Applications → Utilities → Terminal**.\n",
-    "\n",
-    "   - **Navigate to your project directory** (Optional):\n",
-    "     - If you want to start JupyterLab in a specific directory, use the `cd` command to navigate there. For example:\n",
-    "       ```bash\n",
-    "       cd path/to/your/project\n",
-    "       ```\n",
-    "     - If you are unsure of the path, you can drag the folder directly into the Terminal window, and it will automatically input the correct path.\n",
-    "\n",
-    "2. **Using Finder** (Alternative Method):\n",
-    "   - **Open the desired folder in Finder**:\n",
-    "     - Navigate to the folder where you want to start JupyterLab.\n",
-    "\n",
-    "   - **Open Terminal from Finder**:\n",
-    "     - Right-click on the folder while holding the `Control` key (or use a two-finger tap on a trackpad) and select \"New Terminal at Folder\".\n",
-    "     - If you do not see this option, you might need to enable the \"New Terminal at Folder\" service. To do this:\n",
-    "       - Go to **<i class=\"fab fa-apple\" aria-hidden=\"true\"></i> → System Settings... → Keyboard → Keyboard Shortcuts... → Services**.\n",
-    "       - Check the box next to \"New Terminal at Folder\" under the \"Files and Folders\" section.\n",
-    "\n",
-    "3. **Starting JupyterLab**:\n",
-    "   - In Terminal, type the following command and press `Enter`:\n",
-    "     ```bash\n",
-    "     jupyter lab\n",
-    "     ```\n",
-    "   - JupyterLab will open in your default web browser. If it does not, copy the URL provided in the Terminal and paste it into your browser.\n",
+    "#### Using the Terminal\n",
+    "* **Open Terminal**\n",
+    "   You can find Terminal by using Spotlight Search (press `Cmd + Space` and type \"Terminal\") or by navigating to **Applications → Utilities → Terminal**.\n",
+    "\n",
+    "* If you want to start JupyterLab in a specific directory, use the `cd` command to navigate there. For example:\n",
+    "\n",
+    "```bash\n",
+    "cd path/to/your/project\n",
+    "```\n",
+    "    \n",
+    "If you are unsure of the path, you can drag the folder directly into the Terminal window, and it will automatically input the correct path.\n",
+    "\n",
+    "```{admonition} Using Finder(Alternative Method)\n",
+    ":class: tip dropdown\n",
+    "Navigate to the folder where you want to start JupyterLab.\n",
+    "\n",
+    "Open Terminal from Finder:\n",
+    "- Right-click on the folder while holding the `Control` key (or use a two-finger tap on a trackpad) and select \"New Terminal at Folder\".\n",
+    "\n",
+    "If you do not see this option, you might need to enable the \"New Terminal at Folder\" service. To do this:\n",
+    "\n",
+    "  - Go to **<i class=\"fab fa-apple\" aria-hidden=\"true\"></i> → System Settings... → Keyboard → Keyboard Shortcuts... → Services**.\n",
+    "  - Check the box next to \"New Terminal at Folder\" under the \"Files and Folders\" section.\n",
+    "```\n",
+    "\n",
+    "#### Starting JupyterLab:\n",
+    "In Terminal, type the following command and press `Enter`:\n",
+    "\n",
+    " ```bash\n",
+    "jupyter lab\n",
+    " ```\n",
+    "JupyterLab will open in your default web browser. If it does not, copy the URL provided in the Terminal and paste it into your browser.\n",
     "\n",
     "### Step 2: Navigate the File/Directory System\n",
     "\n",
-    "1. **File Browser**:\n",
+    "**File Browser**:\n",
     "   - On the left sidebar of JupyterLab, you will see the **File Browser**. This shows the directory contents of the folder where JupyterLab was started.\n",
     "   - You can open folders by clicking on them. Files (e.g., notebooks, Python scripts) can be opened by clicking on them.\n",
     "\n",
-    "2. **Create new files and folders**:\n",
+    "**Create new files and folders**:\n",
     "   - To create a new file or folder, right-click anywhere in the File Browser and select \"New Folder\" or \"New File\". You can also click the `+` icon at the top of the File Browser.\n",
     "\n",
-    "3. **Upload files**:\n",
+    "**Upload files**:\n",
     "   - You can drag and drop files from your Finder directly into the File Browser in JupyterLab.\n",
     "\n",
-    "4. **Navigate between folders**:\n",
+    "**Navigate between folders**:\n",
     "   - Use the arrows next to folders to expand and collapse them.\n",
     "   - You can also use the breadcrumbs at the top of the File Browser to navigate back to parent directories.\n"
    ]
@@ -97,44 +102,48 @@
     "\n",
     "### Step 1: Open JupyterLab\n",
     "\n",
-    "1. **Using Command Prompt**:\n",
-    "   - **Open Command Prompt**:\n",
-    "     - You can find it by searching \"cmd\" in the Start menu.\n",
+    "#### Using Command Prompt:\n",
+    "* **Open Command Prompt**\n",
+    "  You can find it by searching \"cmd\" in the Start menu.\n",
+    "\n",
+    "* **Navigate to your project directory** (Optional)\n",
+    "  Use the `cd` command to navigate to your desired directory. For example:\n",
     "\n",
-    "   - **Navigate to your project directory** (Optional):\n",
-    "     - Use the `cd` command to navigate to your desired directory. For example:\n",
-    "       ```bash\n",
-    "       cd C:\\path\\to\\your\\project\n",
-    "       ```\n",
+    "  \n",
+    "```bash\n",
+    "cd C:\\path\\to\\your\\project\n",
+    "```\n",
+    "\n",
+    "```{admonition} Using File Explorer(Alternative Method)\n",
+    ":class: tip dropdown\n",
+    "Navigate to the folder where you want to start JupyterLab.\n",
+    "Open Command Prompt from File Explorer:\n",
+    "- Right-click on the folder while holding the `Shift` key and select \"Open command window here\" or \"Open PowerShell window here\". This depends on your Windows version.\n",
+    "- On newer versions of Windows 10 and 11, this option might be replaced with \"Open in Terminal\".\n",
+    "```\n",
     "\n",
-    "2. **Using File Explorer** (Alternative Method):\n",
-    "   - **Open the desired folder in File Explorer**:\n",
-    "     - Navigate to the folder where you want to start JupyterLab.\n",
+    "#### Starting JupyterLab:\n",
+    "In the Command Prompt, PowerShell, or Terminal window that opens, type the following command and press `Enter`:\n",
     "\n",
-    "   - **Open Command Prompt from File Explorer**:\n",
-    "     - Right-click on the folder while holding the `Shift` key and select \"Open command window here\" or \"Open PowerShell window here\". This depends on your Windows version.\n",
-    "     - On newer versions of Windows 10 and 11, this option might be replaced with \"Open in Terminal\".\n",
+    "```bash\n",
+    " jupyter lab\n",
+    "```\n",
     "\n",
-    "3. **Starting JupyterLab**:\n",
-    "   - In the Command Prompt, PowerShell, or Terminal window that opens, type the following command and press `Enter`:\n",
-    "     ```bash\n",
-    "     jupyter lab\n",
-    "     ```\n",
-    "   - JupyterLab will open in your default web browser. If it does not, copy the URL provided in the command prompt and paste it into your browser.\n",
+    "JupyterLab will open in your default web browser. If it does not, copy the URL provided in the command prompt and paste it into your browser.\n",
     "\n",
     "### Step 2: Navigate the File/Directory System\n",
     "\n",
-    "1. **File Browser**:\n",
+    "**File Browser**:\n",
     "   - On the left sidebar of JupyterLab, you will see the **File Browser**. This displays the contents of the directory where JupyterLab was started.\n",
     "   - Click on folders to open them and view their contents. Click on files (e.g., notebooks, Python scripts) to open them in JupyterLab.\n",
     "\n",
-    "2. **Create new files and folders**:\n",
+    "**Create new files and folders**:\n",
     "   - Right-click in the File Browser to create a new file or folder. Alternatively, click the `+` icon at the top of the File Browser.\n",
     "\n",
-    "3. **Upload files**:\n",
+    "**Upload files**:\n",
     "   - Drag and drop files from File Explorer directly into the JupyterLab File Browser.\n",
     "\n",
-    "4. **Navigate between folders**:\n",
+    "**Navigate between folders**:\n",
     "   - Use the arrows next to folders to expand and collapse them.\n",
     "   - The breadcrumbs at the top of the File Browser allow you to navigate back to parent directories."
    ]
@@ -152,12 +161,16 @@
    "id": "030487df-aa1b-4ebf-99c8-780e92d1d4a2",
    "metadata": {},
    "source": [
-    "## <i class=\"fab fa-apple\" aria-hidden=\"true\"></i> <i class=\"fab fa-windows\" aria-hidden=\"true\"></i> Common tips for both macOS and Windows users\n",
+    "## <i class=\"fab fa-apple\" aria-hidden=\"true\"></i> <i class=\"fab fa-windows\" aria-hidden=\"true\"></i> Common tips: Opening, renaming, and closing notebooks\n",
     "\n",
     "- **Opening files**: Double-click on any file in the File Browser to open it. Jupyter Notebooks will open in a new tab, and text files, Python scripts, and other file types will open in their respective editors.\n",
+    "\n",
+    "\n",
     "  \n",
     "- **Renaming files and folders**: Right-click on a file or folder in the File Browser and select \"Rename\" to change its name.\n",
     "\n",
+    "\n",
+    "\n",
     "- **Saving and reverting notebooks**:\n",
     "\n",
     "    - **Manual save**: You can manually save your notebook at any time by clicking the save icon <i class=\"fas fa-save\" aria-hidden=\"true\"></i> in the toolbar or by pressing `Ctrl + S` (Windows) or `Cmd + S` (macOS). (This will automatically create a Checkpoint. See \"Creating Checkpoints\" and \"Reverting to Checkpoints\" further down.)\n",
@@ -169,9 +182,13 @@
     "    - **Create checkpoint**: In JupyterLab, a single checkpoint is automatically created each time you manually save the notebook. You can manually save your notebook by clicking the save icon <i class=\"fas fa-save\" aria-hidden=\"true\"></i> in the toolbar, by pressing `Ctrl + S` (Windows) or `Cmd + S` (macOS), or by selecting \"Save Notebook\" from the File menu.\n",
     "\n",
     "    - **Revert notebook to checkpoint**: If you need to revert to the last manually saved state of your notebook, you can do so by selecting \"Revert Notebook to Checkpoint\" in the File menu. This allows you to go back to the state of the notebook at the last manual save, effectively undoing changes made by any subsequent autosaves. However, JupyterLab only maintains the most recent checkpoint, so you cannot revert to multiple earlier states.\n",
+    " \n",
+    "\n",
     "\n",
     "- **Terminal in JupyterLab**: You can open a Terminal within JupyterLab by clicking on the terminal icon in the Launcher (the tab with the `+` icon). This can be useful for running additional commands directly from within JupyterLab.\n",
     "\n",
+    "\n",
+    "\n",
     "- **Shutting down JupyterLab**: To stop the JupyterLab server, go back to your Terminal, Command Prompt, or PowerShell window where JupyterLab was started, and press `Ctrl + C`. Confirm the shutdown if prompted."
    ]
   },
@@ -204,7 +221,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.5"
+   "version": "3.11.4"
   }
  },
  "nbformat": 4,

_sources/docs/howto/jupyterlab_2.ipynb

@@ -35,9 +35,9 @@
     "\n",
     "JupyterLab allows you to run individual code cells in your notebook. Here are the different methods to run a code cell:\n",
     "\n",
-    "- **Mouse click**: Click on the run icon <i class=\"fas fa-play\" aria-hidden=\"true\"></i> in the toolbar to run the currently selected cell.\n",
+    "**Mouse click**: Click on the run icon <i class=\"fas fa-play\" aria-hidden=\"true\"></i> in the toolbar to run the currently selected cell.\n",
     "\n",
-    "- **Keyboard shortcuts**:\n",
+    "**Keyboard shortcuts**:\n",
     "  - **`Shift + Enter`**: Run the current cell and move to the next cell. If the current cell is the last one, a new cell will be automatically created below.\n",
     "  - **`Cmd + Enter`** (macOS) / **`Ctrl + Enter`** (Windows/Linux): Run the current cell without moving to the next cell.\n",
     "  - **`Option + Enter`** (macOS) / **`Alt + Enter`** (Windows/Linux): Run the current cell, insert a new cell below, and move to the new cell, regardless of whether the current cell is the last one in the notebook.\n",
@@ -56,7 +56,7 @@
     "\n",
     "You can easily create or delete cells in your notebook. Here is how:\n",
     "\n",
-    "- **Creating cells**:\n",
+    "**Creating cells**:\n",
     "\n",
     "  - **Mouse click**:\n",
     "    - **Add cell below**: Click on the plus icon <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> in the toolbar to create a new cell below the currently selected cell.\n",
@@ -67,7 +67,7 @@
     "    - **`A`**: Press `A` to create a new cell above the current cell.\n",
     "    - **`B`**: Press `B` to create a new cell below the current cell.\n",
     "\n",
-    "- **Deleting cells**:\n",
+    "**Deleting cells**:\n",
     "\n",
     "  - **Mouse click**: Select the cell you want to delete, then click the scissors icon <i class=\"fas fa-cut\" aria-hidden=\"true\"></i> in the toolbar.\n",
     "\n",
@@ -157,7 +157,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.5"
+   "version": "3.11.8"
   }
  },
  "nbformat": 4,

_sources/docs/howto/setup.ipynb

@@ -1122,7 +1122,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.5"
+   "version": "3.11.8"
   }
  },
  "nbformat": 4,

_sources/docs/pandas/01_pandas_dataframe.ipynb

@@ -378,7 +378,7 @@
    },
    "source": [
     "We can use the `shape` attribute to determine the dimensions of the `DataFrame`.\\\n",
-    "It returns a tuple representing the number of rows and columns (rows, columns)."
+    "It returns a tuple representing the number of rows and columns (rows, columns). This can be helpful especially if you have not created the `DataFrame`yourself. "
    ]
   },
   {
@@ -418,7 +418,7 @@
    },
    "source": [
     "And we can use the `dtypes` attribute to view the data types of each column in the `DataFrame`.\\\n",
-    "This command provides information about the data type of each column, such as integer, float, or object (string)."
+    "This command provides information about the data type of each column, such as integer, float, or object (string). This is useful knowledge to have when you start working more in-depth with your data."
    ]
   },
   {
@@ -1307,7 +1307,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.5"
+   "version": "3.11.4"
   }
  },
  "nbformat": 4,

_sources/docs/pandas/02_Pandas_tabular_data.ipynb

@@ -583,7 +583,9 @@
     "tags": []
    },
    "source": [
-    "## Getting information on the `DataFrame`"
+    "## Getting information on the `DataFrame`\n",
+    "\n",
+    "Besides displaying the the first and last rows of your `DataFrame`there are a few other attributes which can be useful for getting to know your data. "
    ]
   },
   {
@@ -1043,12 +1045,12 @@
    },
    "source": [
     "The `dtypes` attribute can be used to view the data types of each column in the 'titanic' `DataFrame`.\\\n",
-    "This command provides information about the data type of each column, such as integer, float, or object (string)."
+    "This command provides information about the data type of each column, such as integer, float, or object (string). The data type in each colum is useful to know especially if you are working with data that you did not create yourself. Moreover, this is important for performing statistics and calculations later on, as this can only be done on integers and floats. "
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 3,
    "id": "dabf2a0e-1149-4a5a-9111-20698ff12e80",
    "metadata": {
     "editable": true,
@@ -1061,26 +1063,15 @@
    },
    "outputs": [
     {
-     "data": {
-      "text/plain": [
-       "PassengerId      int64\n",
-       "Survived         int64\n",
-       "Pclass           int64\n",
-       "Name            object\n",
-       "Sex             object\n",
-       "Age            float64\n",
-       "SibSp            int64\n",
-       "Parch            int64\n",
-       "Ticket          object\n",
-       "Fare           float64\n",
-       "Cabin           object\n",
-       "Embarked        object\n",
-       "dtype: object"
-      ]
-     },
-     "execution_count": 9,
-     "metadata": {},
-     "output_type": "execute_result"
+     "ename": "NameError",
+     "evalue": "name 'titanic' is not defined",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+      "\u001b[0;31mNameError\u001b[0m                                 Traceback (most recent call last)",
+      "Cell \u001b[0;32mIn[3], line 1\u001b[0m\n\u001b[0;32m----> 1\u001b[0m titanic\u001b[38;5;241m.\u001b[39mdtypes\n",
+      "\u001b[0;31mNameError\u001b[0m: name 'titanic' is not defined"
+     ]
     }
    ],
    "source": [
@@ -2401,7 +2392,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.5"
+   "version": "3.11.8"
   }
  },
  "nbformat": 4,