Merge branch 'Module1' into 'main'

better structure

See merge request ee2l1/2025-2026/A.K.03!1

.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

.idea/A.K.03.iml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.13 (A.K.03)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="PyDocumentationSettings">
+    <option name="format" value="PLAIN" />
+    <option name="myDocStringFormat" value="Plain" />
+  </component>
+</module>

.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.13 (A.K.03)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.13 (A.K.03)" project-jdk-type="Python SDK" />
+</project>

.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/A.K.03.iml" filepath="$PROJECT_DIR$/.idea/A.K.03.iml" />
+    </modules>
+  </component>
+</project>

.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

Manual/0_Table_of_Contents.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "# Table of Contents\n",
     "\n",
     "\n",
@@ -28,7 +28,7 @@
     "\n",
     "Appendix B: [Serial Communication with Windows](appendix/Appendix_B.md)\n",
     "\n",
-    "Appendix C: [TDOA Localization Algorithm](appendix/Appendix_C.ipynb)\n"
+    "Appendix C: [TDOA Localization Algorithm](../appendix/Appendix_C.ipynb)\n"
    ]
   },
   {

Manual/1_Introduction.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)"
    ]

Manual/2_Module_0.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)"
    ]
   },
@@ -30,8 +30,8 @@
     "## Initial software Installation\n",
     "Before we can start doing anything, you need to set up your programming environment in Python. We have provided a step by step guide that walks you through installing Python, Visual Studio Code, and all the necessary dependencies for your project. You can find them here:\n",
     "\n",
-    "1. [Installation Mac](appendix/0_Installation_Mac.ipynb)\n",
+    "1. [Installation Mac](../appendix/0_Installation_Mac.ipynb)\n",
-    "2. [Installation Windows](appendix/0_Installation_Windows.ipynb)"
+    "2. [Installation Windows](../appendix/0_Installation_Windows.ipynb)"
    ]
   },
   {

Manual/3_Module_1.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)\n",
     "\n",

Manual/4_Module_2.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)\n",
     "\n",

Manual/5_Module_3.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)\n",
     "\n",
@@ -314,7 +314,7 @@
     "### Student Version ###\n",
     "\n",
     "# Load and normalize the reference signal\n",
-    "Fs_ref, ref_signal = wavfile.read(\"Files/Student Recordings/reference.wav\")\n",
+    "Fs_ref, ref_signal = wavfile.read(\"../files/Student Recordings/reference.wav\")\n",
     "ref_signal = ref_signal[221000:222500, 0]  # Use only one channel\n",
     "# TODO: Normalize the reference signal\n",
     "\n",
@@ -638,7 +638,7 @@
     "\n",
     "We offer two approaches for this:\n",
     "\n",
-    "1. **Linear Algebra Approach:** Study [Appendix C](appendix/Appendix_C.ipynb), which shows a basic algorithm to solve for $(x, y)$ using linear algebra. This algorithm is sub-optimal but should be relatively fast, and is a nice illustration of the use of linear algebra (for those who appreciate this).\n",
+    "1. **Linear Algebra Approach:** Study [Appendix C](../appendix/Appendix_C.ipynb), which shows a basic algorithm to solve for $(x, y)$ using linear algebra. This algorithm is sub-optimal but should be relatively fast, and is a nice illustration of the use of linear algebra (for those who appreciate this).\n",
     "\n",
     "2. **Grid Search Method:** Perform a grid search over possible $(x, y)$ positions and evaluate which position best matches the estimated TDOAs. This method can be accurate but may be slower depending on implementation. Consider e.g. iterative grid refinement.\n",
     "\n",

Manual/6_Module_4.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)\n",
     "\n",

Manual/7_Midterm_Report.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)"
    ]
   },

Manual/8_Module_5.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "![book header](pictures/header.png)\n",
+    "![book header](../pictures/header.png)\n",
     "\n",
     "[Table of Contents](0_Table_of_Contents.ipynb)\n",
     "\n",
@@ -283,7 +283,7 @@
     "\n",
     "The figure below is a example depiction of the Challenges (*On the old television series, KARR is the archenemy of KITT*)\n",
     "\n",
-    "![alt text](pictures/FinalChallenge.png)\n",
+    "![alt text](../pictures/FinalChallenge.png)\n",
     "\n",
     "\n"
    ]

README.md

@@ -1 +0,0 @@
-# Book

student-code

@@ -1 +0,0 @@
-Subproject commit eb982ad8ab46ed773d72e1e79597b23fc5e2ebba