Add weekly summaries for weeks 3 to 8; update resistance measurement section; enhance CSS for admonitions; fix notebook for aliasing example

Author: zamkorus

AGENTS.md

@@ -0,0 +1,48 @@
+# Repository instructions for AI agents
+
+These rules apply to any AI assistant (Claude Code, Cursor, Copilot, Codex, etc.) when generating, editing, or reviewing prose in this repository (notebooks, README, comments, docstrings, commit messages, PR descriptions).
+
+## Punctuation: no em or en dashes
+
+**Do not use em dashes (`—`, U+2014) or en dashes (`–`, U+2013) anywhere in prose.**
+
+When you would naturally reach for one, choose one of:
+
+1. A comma, when the inserted clause is parenthetical.
+2. A colon, when introducing a list, definition, or explanation.
+3. A semicolon, when joining two related independent clauses.
+4. A period, splitting into two sentences.
+5. Parentheses, for asides.
+
+**Do not substitute a regular hyphen (`-`) for an em or en dash either.** A hyphen is only correct in:
+
+- Compound modifiers and compound nouns: `current-correct`, `voltage-correct`, `2-wire`, `5-1/2-digit`, `BNC-to-banana`, `Y-Δ`, `cross-check`.
+- Markdown bullet lists (`- item`).
+- Markdown horizontal rules (`---`).
+- YAML separators inside MyST/Jupyter Book figure directives (`---`).
+- Math expressions and identifiers (minus signs, negative exponents).
+
+### Replacements for common dash idioms
+
+| Dash usage | Replace with |
+|---|---|
+| `1–2 %`, `Tasks I1–I5`, `pages 10–14` | `1 to 2 %`, `Tasks I1 to I5`, `pages 10 to 14` |
+| `voltmeter–ammeter`, `series–parallel` | `voltmeter and ammeter`, `series-parallel` (regular hyphen, since these are compound modifiers) |
+| `... briefly — keep ...` | `... briefly. Keep ...` |
+| `... node N — having a name ...` | `... node N. Having a name ...` |
+| `e.g. — about 0.43 V` | `e.g., about 0.43 V` |
+
+### Quick self-check before saving
+
+Before writing or committing a file, search your output for the literal characters `—` and `–`. If either appears outside of a code block, math, or a quoted external source, rewrite that sentence.
+
+## Other writing conventions
+
+- Use straight quotes (`"`, `'`), not typographic quotes (`"`, `"`, `'`, `'`).
+- Use `e.g.` and `i.e.` followed by a comma.
+- Prefer short sentences over long ones connected by stacked clauses; this also makes it easier to avoid dashes.
+- In notebooks, keep the existing voice: instructional, second-person ("you"), present tense.
+
+## Scope
+
+These rules govern *all* prose. They do require rewriting historical content the user has not asked to touch. If you are already editing a paragraph, fix any dashes you encounter in it. Only leave these untouched if user strictly requested that.

CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE.md
+
+See [AGENTS.md](AGENTS.md) for the repository-wide instructions that apply to all AI assistants, including the strict rule against em (`—`) and en (`–`) dashes in prose.

book/_config.yml

@@ -1,9 +1,32 @@
 # Book Settings
 title: "NB2420 practical manuals"
-author: Margreet Docter, Jeroen Bastemeijer, Ashley Jacobi, Krzysztof Zabłocki <a href="https://creativecommons.org/licenses/by/4.0/" target="_blank" rel="license noopener noreferrer"">CC BY 4.0<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/cc.svg" alt=""><img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/by.svg" alt=""></a>
+author: Margreet Docter, Jeroen Bastemeijer <a href="https://creativecommons.org/licenses/by/4.0/" target="_blank" rel="license noopener noreferrer"">CC BY 4.0<img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/cc.svg" alt=""><img style="height:22px!important;margin-left:3px;vertical-align:text-bottom;" src="https://mirrors.creativecommons.org/presskit/icons/by.svg" alt=""></a>
 description: "Collection of practical manuals for the NB2420 course"
 copyright: "Delft University of Technology, CC BY 4.0"
-exclude_patterns: [_build, Thumbs.db, .DS_Store, "**.ipynb_checkpoints", .conda/**, .mamba/**, .venv/**]
+exclude_patterns:
+  # Build outputs and editor / OS junk
+  - _build
+  - "**/Thumbs.db"
+  - "**/.DS_Store"
+  - "**/.ipynb_checkpoints"
+  - "**/*.bak"
+  - "**/*.tmp"
+  - "**/*~"
+  - "**/*.swp"
+  - "**/*.swo"
+  # Python helper / extension files (kept on disk for Sphinx, never rendered as content)
+  - "**/__pycache__"
+  - "**/*.pyc"
+  - "**/no_content_admonition.py"
+  # Environment directories
+  - .conda/**
+  - .mamba/**
+  - .venv/**
+  # Legacy material that lives outside book/ but listed here defensively in case build root changes
+  - "../old/**"
+  - "../AGENTS.md"
+  - "../CLAUDE.md"
+  - "../README.md"
 
 # Only build files in the ToC to avoid building README, etc.
 only_build_toc_files: true
@@ -102,7 +125,25 @@ sphinx:
     iframe_background:     "#ffffff" # default value
     iframe_width:          calc(100% - 2.8rem) # default value
     iframe_aspectratio:    auto 2 / 1 # default value
-    exclude_patterns: [.conda/**, .mamba/**, _build/**, "**/.ipynb_checkpoints", .venv/**]
+    exclude_patterns:
+      - .conda/**
+      - .mamba/**
+      - _build/**
+      - "**/.ipynb_checkpoints"
+      - "**/__pycache__"
+      - "**/*.pyc"
+      - "**/*.bak"
+      - "**/*.tmp"
+      - "**/*~"
+      - "**/*.swp"
+      - "**/*.swo"
+      - "**/Thumbs.db"
+      - "**/.DS_Store"
+      - .venv/**
+      - "../old/**"
+      - "../AGENTS.md"
+      - "../CLAUDE.md"
+      - "../README.md"
     html_extra_path: []
     language: en  # To identify the language.
     html_js_files: 

book/_toc.yml

@@ -4,13 +4,13 @@ root: miscellaneous/intro.md
 parts:
   - caption: Instrument introductions
     chapters:
-      - file: manuals/intros/intro_testboards.ipynb
-      - file: manuals/intros/intro_power_supply_Siglent.ipynb
-      - file: manuals/intros/intro_DMM_Siglent+handheld.ipynb
-      - file: manuals/intros/intro_function_generator_Siglent.ipynb
-      - file: manuals/intros/intro_scope_Siglent.ipynb
-      - file: manuals/intros/intro_LTSpice.ipynb
-      - file: manuals/intros/intro_ALPACA.ipynb
+      - file: manuals/intros/testboards.ipynb
+      - file: manuals/intros/power_supply.ipynb
+      - file: manuals/intros/digital_multimeter.ipynb
+      - file: manuals/intros/function_generator.ipynb
+      - file: manuals/intros/oscilloscope.ipynb
+      - file: manuals/intros/ltspice.ipynb
+      - file: manuals/intros/alpaca.ipynb
       - file: manuals/intros/breadboard.ipynb
 
   - caption: Lab manuals
@@ -24,6 +24,12 @@ parts:
         sections:
           - file: manuals/week2/2.1_Whack_a_mole.ipynb
           - file: manuals/week2/2.2_Timed_acquisitions.ipynb
+      - file: manuals/week3/_summary.ipynb
+      - file: manuals/week4/_summary.ipynb
+      - file: manuals/week5/_summary.ipynb
+      - file: manuals/week6/_summary.ipynb
+      - file: manuals/week7/_summary.ipynb
+      - file: manuals/week8/_summary.ipynb
 
 
   - caption: Miscellaneous

book/manuals/intros/_summary.ipynb

@@ -11,12 +11,13 @@
     "\n",
     "The topics are as follows:\n",
     "\n",
-    "- intro testboards\n",
-    "- intro power supply\n",
-    "- intro DMM\n",
-    "- intro scope & triggering\n",
-    "- intro LTSpice\n",
-    "- intro ALPACA\n"
+    "- Testboards\n",
+    "- Power supply\n",
+    "- Digital multimeter\n",
+    "- Oscilloscope\n",
+    "- LTSpice\n",
+    "- ALPACA\n",
+    "- Breadboard\n"
    ]
   }
  ],

book/manuals/intros/intro_ALPACA.ipynb book/manuals/intros/alpaca.ipynbbook/manuals/intros/intro_ALPACA.ipynb renamed to book/manuals/intros/alpaca.ipynb

@@ -5,8 +5,9 @@
    "id": "5a75e4a4",
    "metadata": {},
    "source": [
-    "# intro ALPACA\n",
-    "This intro supports manuals 2C, 12B, 13C, voltammetry\n",
+    "# ALPACA\n",
+    "\n",
+    "This intro supports manuals 2C, 12B, 13C, voltammetry.\n",
     "\n",
     "In this course ALPACA means **Advanced Learning Platform for Analog Circuits and Automation** (https://zenodo.org/record/5615137) which is developed specifically for this course by Jeroen Bastemeijer. In short: the ALPACA is a \"pocket Studio Classroom\" with devices on board you can use to do experiments. \n",
     "The ALPACA has (among others):\n",
@@ -122,7 +123,7 @@
     "1. Download the firmware for the Alpaca (`Alpaca_firmware.uf2`) from <a href=\"https://brightspace.tudelft.nl/d2l/le/content/775335/viewContent/4586102/View\" target=\"_blank\">Brightspace</a>  (hyperlink). \n",
     "2. Remove the USB-B connector (AKA printer cable/power cable) from the ALPACA board.\n",
     "3. Unplug the micro-USB cable that attaches to the ALPACA from your PC.\n",
-    "4. While pressing the “BOOTSEL” button on the ALPACA, reinsert the USB cable into the PC. Let go of the “BOOTSEL” button after a few seconds. The white, small round \"BOOTSEL\" button is located on the larger green rectangular Raspberry Pi Pico.\n",
+    "4. While pressing the \"BOOTSEL\" button on the ALPACA, reinsert the USB cable into the PC. Let go of the \"BOOTSEL\" button after a few seconds. The white, small round \"BOOTSEL\" button is located on the larger green rectangular Raspberry Pi Pico.\n",
     "5. When everything is okay, the ALPACA will appear as an flash drive in File Explorer (Windows)/Finder (MacOS)\n",
     "\n",
     "6. The `Alpaca_firmware.utf` downloaded file must be stored on the ALPACA by dragging and dropping it (or copy it in another way).\n",
@@ -522,7 +523,7 @@
     "\n",
     "The potentiometer above AMP0 IN can now be used to regulate the DC offset that is added to the signal. <br>\n",
     "Regulate the DC offset of the signal such that the entire output signal can now be visualized. To make it easy to find the right setting for the potentiometer, you can use a special plotting mode unique to NB2211 that allows you to plot the data live. <br>\n",
-    "This function is called `plt.liveplot`. When a number is put into `plt.liveplot`, e.g. `plt.liveplot(x)`, the value `x` will be added as a point on the plot. Note: this only works if the cell containing `plt.liveplot` starts with the \"magic command\" `%plot --mode live`\n",
+    "This function is called `plt.liveplot`. When a number is put into `plt.liveplot`, e.g., `plt.liveplot(x)`, the value `x` will be added as a point on the plot. Note: this only works if the cell containing `plt.liveplot` starts with the \"magic command\" `%plot --mode live`\n",
     "    \n",
     "> <font size=6>🔥</font>  \n",
     ">\n",

…/intros/intro_DMM_Siglent+handheld.ipynb …/manuals/intros/digital_multimeter.ipynbbook/manuals/intros/intro_DMM_Siglent+handheld.ipynb renamed to book/manuals/intros/digital_multimeter.ipynb book/manuals/intros/intro_DMM_Siglent+handheld.ipynb renamed to book/manuals/intros/digital_multimeter.ipynb

@@ -4,8 +4,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Intro Digital multimeter \n",
-    "This intro supports labmanual 1A\n",
+    "# Digital multimeter\n",
+    "\n",
+    "This intro supports labmanual 1A.\n",
     "\n",
     "There are two digital multimeters: a handheld one, and one in the caddie.\n",
     "\n",

…s/intro_function_generator_Siglent.ipynb …/manuals/intros/function_generator.ipynbbook/manuals/intros/intro_function_generator_Siglent.ipynb renamed to book/manuals/intros/function_generator.ipynb book/manuals/intros/intro_function_generator_Siglent.ipynb renamed to book/manuals/intros/function_generator.ipynb

@@ -4,8 +4,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Introduction to the function generator \n",
-    "A function generator is an electronic instrument that generates electrical signals of different waveforms. It is an important complement to the [power supply](intro_power_supply_Siglent.ipynb). While the power supply can provide a constant (DC) voltage, the function generator is capable of producing time-varying (AC) signals. The most common signals produced are the sine, triangle, square and sawtooth waves. \n",
+    "# Function generator\n",
+    "\n",
+    "A function generator is an electronic instrument that generates electrical signals of different waveforms. It is an important complement to the [power supply](power_supply.ipynb). While the power supply can provide a constant (DC) voltage, the function generator is capable of producing time-varying (AC) signals. The most common signals produced are the sine, triangle, square and sawtooth waves. \n",
     "\n",
     "The function generator allows you to select a waveform and adjust the amplitude and frequency of the signal to any value in the operation range of the generator. The function generator we will be using in this course is the *Siglent SDG1000X Series*, as seen in the image below:\n",
     "\n",
@@ -113,7 +114,7 @@
     "### Utility - Output Setup\n",
     "\n",
     "Under Utility - Output Setup - Load, you find two options:\n",
-    "- HighZ:  default (e.g. upon startup), the function generator assumes an infinite load resistance (for example a DMM, or scope)\n",
+    "- HighZ:  default (e.g., upon startup), the function generator assumes an infinite load resistance (for example a DMM, or scope)\n",
     "- 50 $\\Omega$: the generator assumes that the load resistance is 50 Ω (for example the rotary switch)\n",
     "\n",
     "If the wrong load is selected, you might be off by a **factor of 2** in the output signal.\n",
@@ -146,7 +147,7 @@
  "metadata": {
   "celltoolbar": "Create Assignment",
   "kernelspec": {
-   "display_name": "electronic-instrumentation (3.13.12)",
+   "display_name": "electronic-instrumentation (3.14.4)",
    "language": "python",
    "name": "python3"
   },
@@ -160,7 +161,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.13.12"
+   "version": "3.14.4"
   },
   "latex_envs": {
    "LaTeX_envs_menu_present": true,

book/manuals/intros/intro_LTSpice.ipynb book/manuals/intros/ltspice.ipynbbook/manuals/intros/intro_LTSpice.ipynb renamed to book/manuals/intros/ltspice.ipynb

@@ -4,8 +4,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# intro LTSpice\n",
-    "This intro supports labmanual 1C, and 3A (freq. analysis)"
+    "# LTSpice\n",
+    "\n",
+    "This intro supports labmanual 1C, and 3A (freq. analysis)."
    ]
   },
   {
@@ -53,7 +54,7 @@
     "<img src=\"https://gitlab.tudelft.nl/mwdocter/nb2214-images/-/raw/main/LTS24/LTS0_topmenu_LTSpice-121.JPG\" width=30%></img> \n",
     "\n",
     "You need ___components___: \n",
-    "* Press “R” or Left-click the resistor icon \n",
+    "* Press \"R\" or Left-click the resistor icon \n",
     "* move the resistor symbol to the drawing area\n",
     "* left click again to create R1\n",
     "\n",
@@ -66,15 +67,15 @@
     "<img src=\"https://gitlab.tudelft.nl/mwdocter/nb2214-images/-/raw/main/LTS24/LTS0_rightclick_value_resistor.JPG\" width=40%></img> \n",
     "\n",
     "___Edit___ the component's value by:\n",
-    "* Move the mouse over a resistor until the cursor changes into a “hand” symbol. \n",
+    "* Move the mouse over a resistor until the cursor changes into a \"hand\" symbol. \n",
     "* Then right-click to open the edit menu. \n",
     "* Set/Change the resistor value\n",
     "\n",
     "Note: You can use the following prefixes: f/F (femto), p/P (pico), n/N (nano), u/U (micro), m/M (milli), k/K (kilo), meg/MEG (mega), g/G (giga), t/T (terra). So for a 1 kΩ resistor type 1k, and for 1Ω simply 1.\n",
     "\n",
     "___Moving___ components\n",
     "* left-click the move icon. \n",
-    "* Position the “hand” cursor over the component and left-click. Now the component can be moved. \n",
+    "* Position the \"hand\" cursor over the component and left-click. Now the component can be moved. \n",
     "* Click again to fix the new position. \n",
     "* Press ESC/right-click to stop moving components.\n",
     "\n",
@@ -94,7 +95,7 @@
     "Note: to change the polarity or the orientation of the source, left-click the rotation icon one or more times before placement.\n",
     "* Press ESC to stop placing voltage sources.\n",
     "Setting voltage source values\n",
-    "* Hover the cursor over the voltage source until the “hand” cursor appears. Then click right to open the edit menu.  Set:  DC-value to 0 V and the series-resistance to 0.\n",
+    "* Hover the cursor over the voltage source until the \"hand\" cursor appears. Then click right to open the edit menu.  Set:  DC-value to 0 V and the series-resistance to 0.\n",
     "\n",
     "#### AC Voltage source (for transient analysis)\n",
     "Right-click on the voltage source and make the following (advanced) settings:\n",
@@ -153,7 +154,7 @@
     "<img src=\"https://gitlab.tudelft.nl/mwdocter/nb2214-images/-/raw/main/LTS24/LTS0_topmenu_LTSpice-125.jpg\" width=30%></img> \n",
     "\n",
     "In order to help interpretation of results it is good practice to label the important nodes in the network. Otherwise LTspice does automatic naming, which is often unclear.\n",
-    "* Right-Click on each of the blue lines on top and choose  “Label Net” from the pop-up menu.\n",
+    "* Right-Click on each of the blue lines on top and choose  \"Label Net\" from the pop-up menu.\n",
     "* Name them VA, VB respectively and connect the text-symbol that appears to the line.\n",
     "\n",
     "**Note: do not use duplicate names, LTSpice will not be able to distinguish these labels (and identical names on components will return an error)**\n"
@@ -174,7 +175,7 @@
    "metadata": {},
    "source": [
     "### Saving graphics\n",
-    "You can save your LTspice schematics and graphic results as graphics by selecting the corresponding windows and follow the menu: “Tools” > “Write image to .emf file”. Or use Windows snipping tools, or just print screen. \n",
+    "You can save your LTspice schematics and graphic results as graphics by selecting the corresponding windows and follow the menu: \"Tools\" > \"Write image to .emf file\". Or use Windows snipping tools, or just print screen. \n",
     "<img src=\"https://gitlab.tudelft.nl/mwdocter/nb2214-images/-/raw/main/LTS24/LTS0-color_palette_background.JPG\" width=25%></img> \n",
     "Tip: Normally the graphs have a black background which is OK on screen but inconvenient on paper. You can change the background to white by setting the Color preferences:\n",
     "* Choose from the menu: Tools > Color Preferences \n",
@@ -204,8 +205,8 @@
     "### DC-Analysis\n",
     "<img src=\"https://gitlab.tudelft.nl/mwdocter/nb2214-images/-/raw/main/LTS24/DC_op_pnt.JPG\" width=60%></img> \n",
     "* Follow the menu: Simulate > Edit Simulation Cmd. \n",
-    "* In the pop-menu select the tab “DC op pnt” (DC at point) and click OK. \n",
-    "* Left-click in the drawing area to drop the command “.op” \n",
+    "* In the pop-menu select the tab \"DC op pnt\" (DC at point) and click OK. \n",
+    "* Left-click in the drawing area to drop the command \".op\" \n",
     " \n",
     "* Click the RUN icon to start the simulation, the solution (currents and voltages) are shown in a pop-up window, similar to the above one\n",
     "* From the currents and the nodes you can derive the total current, total voltage and therefore total resistance. \n",
@@ -223,8 +224,8 @@
     "#### Transient simulation\n",
     "Change the simulation settings through: Simulate > Edit Simulation Cmd\n",
     "* Select the Transient tab (leasing to an intensity vs. time display)\n",
-    "* set the total simulation time to e.g. 100 us; \n",
-    "* and the maximum steps to make to a large value, e.g. 1000 (see figure)\n",
+    "* set the total simulation time to e.g., 100 us; \n",
+    "* and the maximum steps to make to a large value, e.g., 1000 (see figure)\n",
     "<img src=\"https://gitlab.tudelft.nl/mwdocter/nb2214-images/-/raw/main/LTS24/LTS2-RL_transient_simulation.JPG\" width=60%></img>\n",
     "\n",
     "**For Mac-users**, the Spice objective to use is: **.tran 0 100u 0 1000** <br>\n",

…manuals/intros/intro_scope_Siglent.ipynb book/manuals/intros/oscilloscope.ipynbbook/manuals/intros/intro_scope_Siglent.ipynb renamed to book/manuals/intros/oscilloscope.ipynb book/manuals/intros/intro_scope_Siglent.ipynb renamed to book/manuals/intros/oscilloscope.ipynb

@@ -4,7 +4,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Introduction to the oscilloscope (scope)\n",
+    "# Oscilloscope\n",
+    "\n",
     "The oscilloscope is an indispensable device to test electronic circuits and is an important complement to the DMM. \n",
     "\n",
     "The DMM provides a reading of a circuit at a single point in time. This means that if you are trying to measure a signal that is changing over time, the DMM won't be able to visualise it. When you measure an alternating current (AC) signal such as a sine wave using the DMM, the reading will only show the $U_{rms}$ of the signal. \n",