From 8eb5ccc1e298fb2f39aae9f29e5a67f7a4dd5db5 Mon Sep 17 00:00:00 2001
From: Morten Hjorth-Jensen
Date: Tue, 2 Sep 2025 06:25:20 +0200
Subject: [PATCH] update
---
doc/LectureNotes/project1.ipynb | 641 ++++++++++++++++++
.../2025/Project1/html/._Project1-bs000.html | 16 +-
.../2025/Project1/html/._Project1-bs001.html | 95 +--
.../2025/Project1/html/Project1-bs.html | 16 +-
doc/Projects/2025/Project1/html/Project1.html | 111 +--
.../Project1-checkpoint.ipynb | 233 ++++---
.../2025/Project1/ipynb/Project1.ipynb | 198 +++---
.../Project1/ipynb/ipynb-Project1-src.tar.gz | Bin 194 -> 193 bytes
doc/Projects/2025/Project1/pdf/Project1.p.tex | 109 +--
doc/Projects/2025/Project1/pdf/Project1.tex | 109 +--
.../2025/Project1/._Project1-bs000.html | 238 +++++++
.../2025/Project1/._Project1-bs001.html | 503 ++++++++++++++
.../Projects/2025/Project1/Project1-bs.html | 238 +++++++
.../Projects/2025/Project1/Project1.do.txt | 113 +--
doc/src/Projects/2025/Project1/Project1.html | 588 ++++++++++++++++
doc/src/Projects/2025/Project1/Project1.ipynb | 641 ++++++++++++++++++
doc/src/Projects/2025/Project1/Project1.p.tex | 504 ++++++++++++++
doc/src/Projects/2025/Project1/Project1.tex | 476 +++++++++++++
doc/src/Projects/2025/Project1/README.txt | 2 +
.../2025/Project1/ipynb-Project1-src.tar.gz | Bin 0 -> 193 bytes
20 files changed, 4404 insertions(+), 427 deletions(-)
create mode 100644 doc/LectureNotes/project1.ipynb
create mode 100644 doc/src/Projects/2025/Project1/._Project1-bs000.html
create mode 100644 doc/src/Projects/2025/Project1/._Project1-bs001.html
create mode 100644 doc/src/Projects/2025/Project1/Project1-bs.html
create mode 100644 doc/src/Projects/2025/Project1/Project1.html
create mode 100644 doc/src/Projects/2025/Project1/Project1.ipynb
create mode 100644 doc/src/Projects/2025/Project1/Project1.p.tex
create mode 100644 doc/src/Projects/2025/Project1/Project1.tex
create mode 100644 doc/src/Projects/2025/Project1/README.txt
create mode 100644 doc/src/Projects/2025/Project1/ipynb-Project1-src.tar.gz
diff --git a/doc/LectureNotes/project1.ipynb b/doc/LectureNotes/project1.ipynb
new file mode 100644
index 000000000..1dd18f760
--- /dev/null
+++ b/doc/LectureNotes/project1.ipynb
@@ -0,0 +1,641 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "b209e219",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "\n",
+ ""
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6fa4c4bc",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "# Project 1 on Machine Learning, deadline October 6 (midnight), 2025\n",
+ "**Data Analysis and Machine Learning FYS-STK3155/FYS4155**, University of Oslo, Norway\n",
+ "\n",
+ "Date: **September 2**"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "735b16c4",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Preamble: Note on writing reports, using reference material, AI and other tools\n",
+ "\n",
+ "We want you to answer the three different projects by handing in\n",
+ "reports written like a standard scientific/technical report. The\n",
+ "links at\n",
+ "\n",
+ "contain more information. There you can find examples of previous\n",
+ "reports, the projects themselves, how we rade reports etc. How to\n",
+ "write reports will also be discussed during the various lab\n",
+ "sessions. Please do ask us if you are in doubt.\n",
+ "\n",
+ "When using codes and material from other sources, you should refer to\n",
+ "these in the bibliography of your report, indicating wherefrom you for\n",
+ "example got the code, whether this is from the lecture notes,\n",
+ "softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources\n",
+ "should always be cited correctly. How to cite some\n",
+ "of the libraries is often indicated from their corresponding GitHub\n",
+ "sites or websites, see for example how to cite Scikit-Learn at\n",
+ ".\n",
+ "\n",
+ "We enocurage you to use tools like\n",
+ "[ChatGPT](https://openai.com/chatgpt/) or similar in writing the report. If you use for example ChatGPT,\n",
+ "please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can\n",
+ "be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.\n",
+ "\n",
+ "If you would like to study other data sets, feel free to propose other\n",
+ "sets. What we have proposed here are mere suggestions from our\n",
+ "side. If you opt for another data set, consider using a set which has\n",
+ "been studied in the scientific literature. This makes it easier for\n",
+ "you to compare and analyze your results. Comparing with existing\n",
+ "results from the scientific literature is also an essential element of\n",
+ "the scientific discussion. The University of California at Irvine\n",
+ "with its Machine Learning repository at\n",
+ " is an excellent site to\n",
+ "look up for examples and\n",
+ "inspiration. [Kaggle.com](https://www.kaggle.com/) is an equally\n",
+ "interesting site. Feel free to explore these sites. When selecting\n",
+ "other data sets, make sure these are sets used for regression problems\n",
+ "(not classification)."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0b7956ca",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Regression analysis and resampling methods\n",
+ "\n",
+ "The main aim of this project is to study in more detail various\n",
+ "regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.\n",
+ "In addition to the scientific part, in this course we want also to\n",
+ "give you an experience in writing scientific reports.\n",
+ "\n",
+ "We will study how to fit polynomials to specific\n",
+ "one-dimensional functions (feel free to replace the suggested function with more complicated ones).\n",
+ "\n",
+ "We will use Runge's function (see for a discussion). The one-dimensional function we will study is"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "28ba3d22",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "f(x) = \\frac{1}{1+25x^2}.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9a3e10ba",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Our first step will be to perform an OLS regression analysis of this\n",
+ "function, trying out a polynomial fit with an $x$ dependence of the\n",
+ "form $[x,x^2,\\dots]$. You can use a uniform distribution to set up the\n",
+ "arrays of values for $x \\in [-1,1]$, or alternatively use a fixed step size.\n",
+ "Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,\n",
+ "introducing thereby a dependence on the hyperparameter (penalty) $\\lambda$.\n",
+ "\n",
+ "We will also include bootstrap as a resampling technique in order to\n",
+ "study the so-called **bias-variance tradeoff**. After that we will\n",
+ "include the so-called cross-validation technique."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8aa547a5",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part a : Ordinary Least Square (OLS) for the Runge function\n",
+ "\n",
+ "We will generate our own dataset for abovementioned function\n",
+ "$\\mathrm{Runge}(x)$ function with $x\\in [-1,1]$. You should explore also the addition\n",
+ "of an added stochastic noise to this function using the normal\n",
+ "distribution $N(0,1)$.\n",
+ "\n",
+ "*Write your own code* (using for example the pseudoinverse function **pinv** from **Numpy** ) and perform a standard **ordinary least square regression**\n",
+ "analysis using polynomials in $x$ up to order $15$ or higher. Explore the dependence on the number of data points and the polynomial degree.\n",
+ "\n",
+ "Evaluate the mean Squared error (MSE)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "68fbf03d",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "MSE(\\boldsymbol{y},\\tilde{\\boldsymbol{y}}) = \\frac{1}{n}\n",
+ "\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b49509bc",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "and the $R^2$ score function. If $\\tilde{\\boldsymbol{y}}_i$ is the predicted\n",
+ "value of the $i-th$ sample and $y_i$ is the corresponding true value,\n",
+ "then the score $R^2$ is defined as"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0fa4ffc6",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "R^2(\\boldsymbol{y}, \\tilde{\\boldsymbol{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "ce462b32",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "where we have defined the mean value of $\\boldsymbol{y}$ as"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a5fbef36",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a6afe9cb",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).\n",
+ "Plot also the parameters $\\theta$ as you increase the order of the polynomial. Comment your results.\n",
+ "\n",
+ "Your code has to include a scaling/centering of the data (for example by\n",
+ "subtracting the mean value), and\n",
+ "a split of the data in training and test data. For the scaling you can\n",
+ "either write your own code or use for example the function for\n",
+ "splitting training data provided by the library **Scikit-Learn** (make\n",
+ "sure you have installed it). This function is called\n",
+ "$train\\_test\\_split$. **You should present a critical discussion of why and how you have scaled or not scaled the data**.\n",
+ "\n",
+ "It is normal in essentially all Machine Learning studies to split the\n",
+ "data in a training set and a test set (eventually also an additional\n",
+ "validation set). There\n",
+ "is no explicit recipe for how much data should be included as training\n",
+ "data and say test data. An accepted rule of thumb is to use\n",
+ "approximately $2/3$ to $4/5$ of the data as training data.\n",
+ "\n",
+ "You can easily reuse the solutions to your exercises from week 35.\n",
+ "See also the lecture slides from week 35 and week 36.\n",
+ "\n",
+ "On scaling, we recommend reading the following section from the scikit-learn software description, see ."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3be10f68",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part b: Adding Ridge regression for the Runge function\n",
+ "\n",
+ "Write your own code for the Ridge method as done in the previous\n",
+ "exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.\n",
+ "\n",
+ "Perform the same analysis as you did in the previous exercise but now for different values of $\\lambda$. Compare and\n",
+ "analyze your results with those obtained in part a) with the OLS method. Study the\n",
+ "dependence on $\\lambda$."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "caa7909c",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part c: Writing your own gradient descent code\n",
+ "\n",
+ "Replace now the analytical expressions for the optimal parameters\n",
+ "$\\boldsymbol{\\theta}$ with your own gradient descent code. In this exercise we\n",
+ "focus only on the simplest gradient descent approach with a fixed\n",
+ "learning rate (see the exercises from week 37 and the lecture notes\n",
+ "from week 36).\n",
+ "\n",
+ "Study and compare your results from parts a) and b) with your gradient\n",
+ "descent approch. Discuss in particular the role of the learning rate."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3aac4df1",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part d: Including momentum and more advanced ways to update the learning the rate\n",
+ "\n",
+ "We keep our focus on OLS and Ridge regression and update our code for\n",
+ "the gradient descent method by including **momentum**, **ADAgrad**,\n",
+ "**RMSprop** and **ADAM** as methods fro iteratively updating your learning\n",
+ "rate. Discuss the results and compare the different methods applied to\n",
+ "the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d0862a53",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part e: Writing our own code for Lasso regression\n",
+ "\n",
+ "LASSO regression (see lecture slides from week 36 and week 37)\n",
+ "represents our first encounter with a machine learning method which\n",
+ "cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient\n",
+ "descent methods you developed in parts c) and d) to solve the LASSO\n",
+ "optimization problem. You can compare your results with \n",
+ "the functionalities of **Scikit-Learn**.\n",
+ "\n",
+ "Discuss (critically) your results for the Runge function from OLS,\n",
+ "Ridge and LASSO regression using the various gradient descent\n",
+ "approaches."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9170032e",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part f: Stochastic gradient descent\n",
+ "\n",
+ "Our last gradient step is to include stochastic gradient descent using\n",
+ "the same methods to update the learning rates as in parts c-e).\n",
+ "Compare and discuss your results with and without stochastic gradient\n",
+ "and give a critical assessment of the various methods."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bacd1035",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part g: Bias-variance trade-off and resampling techniques\n",
+ "\n",
+ "Our aim here is to study the bias-variance trade-off by implementing\n",
+ "the **bootstrap** resampling technique. **We will only use the simpler\n",
+ "ordinary least squares here**.\n",
+ "\n",
+ "With a code which does OLS and includes resampling techniques, \n",
+ "we will now discuss the bias-variance trade-off in the context of\n",
+ "continuous predictions such as regression. However, many of the\n",
+ "intuitions and ideas discussed here also carry over to classification\n",
+ "tasks and basically all Machine Learning algorithms. \n",
+ "\n",
+ "Before you perform an analysis of the bias-variance trade-off on your\n",
+ "test data, make first a figure similar to Fig. 2.11 of Hastie,\n",
+ "Tibshirani, and Friedman. Figure 2.11 of this reference displays only\n",
+ "the test and training MSEs. The test MSE can be used to indicate\n",
+ "possible regions of low/high bias and variance. You will most likely\n",
+ "not get an equally smooth curve! You may also need to increase the\n",
+ "polynomial order and play around with the number of data points as\n",
+ "well (see also the exercise set from week 35).\n",
+ "\n",
+ "With this result we move on to the bias-variance trade-off analysis.\n",
+ "\n",
+ "Consider a\n",
+ "dataset $\\mathcal{L}$ consisting of the data\n",
+ "$\\mathbf{X}_\\mathcal{L}=\\{(y_j, \\boldsymbol{x}_j), j=0\\ldots n-1\\}$.\n",
+ "\n",
+ "We assume that the true data is generated from a noisy model"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b871ec69",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\boldsymbol{y}=f(\\boldsymbol{x}) + \\boldsymbol{\\epsilon}.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b47c19bc",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Here $\\epsilon$ is normally distributed with mean zero and standard\n",
+ "deviation $\\sigma^2$.\n",
+ "\n",
+ "In our derivation of the ordinary least squares method we defined then\n",
+ "an approximation to the function $f$ in terms of the parameters\n",
+ "$\\boldsymbol{\\theta}$ and the design matrix $\\boldsymbol{X}$ which embody our model,\n",
+ "that is $\\boldsymbol{\\tilde{y}}=\\boldsymbol{X}\\boldsymbol{\\theta}$.\n",
+ "\n",
+ "The parameters $\\boldsymbol{\\theta}$ are in turn found by optimizing the mean\n",
+ "squared error via the so-called cost function"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6db622c2",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "C(\\boldsymbol{X},\\boldsymbol{\\theta}) =\\frac{1}{n}\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2=\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right].\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5a7eb70d",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Here the expected value $\\mathbb{E}$ is the sample value. \n",
+ "\n",
+ "Show that you can rewrite this in terms of a term which contains the\n",
+ "variance of the model itself (the so-called variance term), a term\n",
+ "which measures the deviation from the true data and the mean value of\n",
+ "the model (the bias term) and finally the variance of the noise.\n",
+ "\n",
+ "That is, show that"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d50292fe",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathrm{Bias}[\\tilde{y}]+\\mathrm{var}[\\tilde{y}]+\\sigma^2,\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "50fa641f",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "with (we approximate $f(\\boldsymbol{x})\\approx \\boldsymbol{y}$)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2bd429c9",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\mathrm{Bias}[\\tilde{y}]=\\mathbb{E}\\left[\\left(\\boldsymbol{y}-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]\\right)^2\\right],\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "737c2819",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "and"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "41ef92ef",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\mathrm{var}[\\tilde{y}]=\\mathbb{E}\\left[\\left(\\tilde{\\boldsymbol{y}}-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]\\right)^2\\right]=\\frac{1}{n}\\sum_i(\\tilde{y}_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b948dab0",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "**Important note**: Since the function $f(x)$ is unknown, in order to be able to evalute the bias, we replace $f(\\boldsymbol{x})$ in the expression for the bias with $\\boldsymbol{y}$. \n",
+ "\n",
+ "The answer to this exercise should be included in the theory part of\n",
+ "the report. This exercise is also part of the weekly exercises of\n",
+ "week 38. Explain what the terms mean and discuss their\n",
+ "interpretations.\n",
+ "\n",
+ "Perform then a bias-variance analysis of the Runge function by\n",
+ "studying the MSE value as function of the complexity of your model.\n",
+ "\n",
+ "Discuss the bias and variance trade-off as function\n",
+ "of your model complexity (the degree of the polynomial) and the number\n",
+ "of data points, and possibly also your training and test data using the **bootstrap** resampling method.\n",
+ "You can follow the code example in the jupyter-book at ."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6a0548bf",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part h): Cross-validation as resampling techniques, adding more complexity\n",
+ "\n",
+ "The aim here is to implement another widely popular\n",
+ "resampling technique, the so-called cross-validation method. \n",
+ "\n",
+ "Implement the $k$-fold cross-validation algorithm (feel free to use\n",
+ "the functionality of **Scikit-Learn** or write your own code) and\n",
+ "evaluate again the MSE function resulting from the test folds.\n",
+ "\n",
+ "Compare the MSE you get from your cross-validation code with the one\n",
+ "you got from your **bootstrap** code from the previous exercise. Comment and interpret your results. \n",
+ "\n",
+ "In addition to using the ordinary least squares method, you should\n",
+ "include both Ridge and Lasso regression in the final analysis."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "df9845cb",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Background literature\n",
+ "\n",
+ "1. For a discussion and derivation of the variances and mean squared errors using linear regression, see the [Lecture notes on ridge regression by Wessel N. van Wieringen](https://arxiv.org/abs/1509.09169)\n",
+ "\n",
+ "2. The textbook of [Trevor Hastie, Robert Tibshirani, Jerome H. Friedman, The Elements of Statistical Learning, Springer](https://www.springer.com/gp/book/9780387848570), chapters 3 and 7 are the most relevant ones for the analysis here."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b9e04791",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Introduction to numerical projects\n",
+ "\n",
+ "Here follows a brief recipe and recommendation on how to answer the various questions when preparing your answers. \n",
+ "\n",
+ " * Give a short description of the nature of the problem and the eventual numerical methods you have used.\n",
+ "\n",
+ " * Describe the algorithm you have used and/or developed. Here you may find it convenient to use pseudocoding. In many cases you can describe the algorithm in the program itself.\n",
+ "\n",
+ " * Include the source code of your program. Comment your program properly. You should have the code at your GitHub/GitLab link. You can also place the code in an appendix of your report.\n",
+ "\n",
+ " * If possible, try to find analytic solutions, or known limits in order to test your program when developing the code.\n",
+ "\n",
+ " * Include your results either in figure form or in a table. Remember to label your results. All tables and figures should have relevant captions and labels on the axes.\n",
+ "\n",
+ " * Try to evaluate the reliabilty and numerical stability/precision of your results. If possible, include a qualitative and/or quantitative discussion of the numerical stability, eventual loss of precision etc.\n",
+ "\n",
+ " * Try to give an interpretation of you results in your answers to the problems.\n",
+ "\n",
+ " * Critique: if possible include your comments and reflections about the exercise, whether you felt you learnt something, ideas for improvements and other thoughts you've made when solving the exercise. We wish to keep this course at the interactive level and your comments can help us improve it.\n",
+ "\n",
+ " * Try to establish a practice where you log your work at the computerlab. You may find such a logbook very handy at later stages in your work, especially when you don't properly remember what a previous test version of your program did. Here you could also record the time spent on solving the exercise, various algorithms you may have tested or other topics which you feel worthy of mentioning."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3fab6237",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Format for electronic delivery of report and programs\n",
+ "\n",
+ "The preferred format for the report is a PDF file. You can also use DOC or postscript formats or as an ipython notebook file. As programming language we prefer that you choose between C/C++, Fortran2008, Julia or Python. The following prescription should be followed when preparing the report:\n",
+ "\n",
+ " * Use Canvas to hand in your projects, log in at with your normal UiO username and password.\n",
+ "\n",
+ " * Upload **only** the report file or the link to your GitHub/GitLab or similar typo of repos! For the source code file(s) you have developed please provide us with your link to your GitHub/GitLab or similar domain. The report file should include all of your discussions and a list of the codes you have developed. Do not include library files which are available at the course homepage, unless you have made specific changes to them.\n",
+ "\n",
+ " * In your GitHub/GitLab or similar repository, please include a folder which contains selected results. These can be in the form of output from your code for a selected set of runs and input parameters.\n",
+ "\n",
+ "Finally, \n",
+ "we encourage you to collaborate. Optimal working groups consist of \n",
+ "2-3 students. You can then hand in a common report."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3388eb60",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Software and needed installations\n",
+ "\n",
+ "If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages, \n",
+ "we recommend that you install the following Python packages via **pip** as\n",
+ "1. pip install numpy scipy matplotlib ipython scikit-learn tensorflow sympy pandas pillow\n",
+ "\n",
+ "For Python3, replace **pip** with **pip3**.\n",
+ "\n",
+ "See below for a discussion of **tensorflow** and **scikit-learn**. \n",
+ "\n",
+ "For OSX users we recommend also, after having installed Xcode, to install **brew**. Brew allows \n",
+ "for a seamless installation of additional software via for example\n",
+ "1. brew install python3\n",
+ "\n",
+ "For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution\n",
+ "you can use **pip** as well and simply install Python as \n",
+ "1. sudo apt-get install python3 (or python for python2.7)\n",
+ "\n",
+ "etc etc. \n",
+ "\n",
+ "If you don't want to install various Python packages with their dependencies separately, we recommend two widely used distrubutions which set up all relevant dependencies for Python, namely\n",
+ "1. [Anaconda](https://docs.anaconda.com/) Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system **conda**\n",
+ "\n",
+ "2. [Enthought canopy](https://www.enthought.com/product/canopy/) is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.\n",
+ "\n",
+ "Popular software packages written in Python for ML are\n",
+ "\n",
+ "* [Scikit-learn](http://scikit-learn.org/stable/), \n",
+ "\n",
+ "* [Tensorflow](https://www.tensorflow.org/),\n",
+ "\n",
+ "* [PyTorch](http://pytorch.org/) and \n",
+ "\n",
+ "* [Keras](https://keras.io/).\n",
+ "\n",
+ "These are all freely available at their respective GitHub sites. They \n",
+ "encompass communities of developers in the thousands or more. And the number\n",
+ "of code developers and contributors keeps increasing."
+ ]
+ }
+ ],
+ "metadata": {},
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/doc/Projects/2025/Project1/html/._Project1-bs000.html b/doc/Projects/2025/Project1/html/._Project1-bs000.html
index 01cf3ff7c..bfb4c4ae3 100644
--- a/doc/Projects/2025/Project1/html/._Project1-bs000.html
+++ b/doc/Projects/2025/Project1/html/._Project1-bs000.html
@@ -175,18 +175,20 @@ MathJax.Hub.Config({
Preamble: Note on writing reports, using reference material, AI and other tools
We want you to answer the three different projects by handing in
-reports written like a standard scientific/technical report. The links
-at https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
-Furthermore, at the same link,
-you can find examples of previous reports. How to write reports will
-also be discussed during the various lab sessions. Please do ask us if you are in doubt.
+reports written like a standard scientific/technical report. The
+links at
+https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
When using codes and material from other sources, you should refer to
these in the bibliography of your report, indicating wherefrom you for
example got the code, whether this is from the lecture notes,
-softwares like Scikit-Learn, TensorFlow, PyTorch or other sources such
-AI software. These should always be cited correctly. How to cite some
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
of the libraries is often indicated from their corresponding GitHub
sites or websites, see for example how to cite Scikit-Learn at
https://scikit-learn.org/dev/about.html.
diff --git a/doc/Projects/2025/Project1/html/._Project1-bs001.html b/doc/Projects/2025/Project1/html/._Project1-bs001.html
index 1cb8d459c..6f71c9733 100644
--- a/doc/Projects/2025/Project1/html/._Project1-bs001.html
+++ b/doc/Projects/2025/Project1/html/._Project1-bs001.html
@@ -154,7 +154,7 @@ MathJax.Hub.Config({
Regression analysis and resampling methods
The main aim of this project is to study in more detail various
-regression methods, including the Ordinary Least Squares (OLS) method.
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
In addition to the scientific part, in this course we want also to
give you an experience in writing scientific reports.
@@ -170,27 +170,26 @@ $$
Our first step will be to perform an OLS regression analysis of this
function, trying out a polynomial fit with an \( x \) dependence of the
-form \( [x,x^2,\dots] \). We can use a uniform distribution to set up the
+form \( [x,x^2,\dots] \). You can use a uniform distribution to set up the
arrays of values for \( x \in [-1,1] \), or alternatively use a fixed step size.
-Thereafter we will repeat much of the
-same procedure using the Ridge and Lasso regression methods,
-introducing thus a dependence on the hyperparameter (penalty) \( \lambda \).
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) \( \lambda \).
We will also include bootstrap as a resampling technique in order to
study the so-called bias-variance tradeoff. After that we will
-include the cross-validation technique.
+include the so-called cross-validation technique.
Part a : Ordinary Least Square (OLS) for the Runge function
-
We will generate our own dataset for a function
+
We will generate our own dataset for abovementioned function
\( \mathrm{Runge}(x) \) function with \( x\in [-1,1] \). You should explore also the addition
of an added stochastic noise to this function using the normal
distribution \( N(0,1) \).
Write your own code (using for example the pseudoinverse function pinv from Numpy ) and perform a standard ordinary least square regression
-analysis using polynomials in \( x \) up to order \( 15 \). Explore the dependence on the number of data points and the polynomial degree.
+analysis using polynomials in \( x \) up to order \( 15 \) or higher. Explore the dependence on the number of data points and the polynomial degree.
Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 20).
+
Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
Plot also the parameters \( \theta \) as you increase the order of the polynomial. Comment your results.
Your code has to include a scaling/centering of the data (for example by
subtracting the mean value), and
-a split of the data in training and test data. For this exercise you can
+a split of the data in training and test data. For the scaling you can
either write your own code or use for example the function for
splitting training data provided by the library Scikit-Learn (make
sure you have installed it). This function is called
@@ -243,11 +242,11 @@ See also the lecture slides from week 35 and week 36.
Part b: Adding Ridge regression for the Runge function
Write your own code for the Ridge method as done in the previous
-exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the exercise from week 36 is something you can reuse here.
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
Perform the same analysis as you did in the previous exercise but now for different values of \( \lambda \). Compare and
-analyze your results with those obtained in part a) with the ordinary least squares method. Study the
+analyze your results with those obtained in part a) with the OLS method. Study the
dependence on \( \lambda \).
Part c: Writing your own gradient descent code
@@ -268,15 +267,15 @@ descent approch. Discuss in particular the role of the learning rate.
the gradient descent method by including momentum, ADAgrad,
RMSprop and ADAM as methods fro iteratively updating your learning
rate. Discuss the results and compare the different methods applied to
-the one-dimensional Runge function.
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
Part e: Writing our own code for Lasso regression
LASSO regression (see lecture slides from week 36 and week 37)
represents our first encounter with a machine learning method which
-cannot be solved through analytical expressions. Use the gradient
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
descent methods you developed in parts c) and d) to solve the LASSO
-optimization problem. You can compare your results using
+optimization problem. You can compare your results with
the functionalities of Scikit-Learn.
@@ -286,14 +285,16 @@ approaches.
Part f: Stochastic gradient descent
-
Our last gradient step is to include stochastic gradient descent using the
-same methods to update the learning rates as in parts c-e).
-Compare and discuss your results with and without stochastic gradient and give a critical assessment of the various methods.
+
Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
Part g: Bias-variance trade-off and resampling techniques
-
Our aim here is to study the bias-variance trade-off by implementing the bootstrap resampling technique.
-We will only use the simpler ordinary least squares here.
+
Our aim here is to study the bias-variance trade-off by implementing
+the bootstrap resampling technique. We will only use the simpler
+ordinary least squares here.
With a code which does OLS and includes resampling techniques,
@@ -303,11 +304,14 @@ intuitions and ideas discussed here also carry over to classification
tasks and basically all Machine Learning algorithms.
-
Before you perform an analysis of the bias-variance trade-off on your test data, make
-first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and
-Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to
-indicate possible regions of low/high bias and variance. You will most likely not get an
-equally smooth curve!
+
Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig. 2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
With this result we move on to the bias-variance trade-off analysis.
@@ -317,7 +321,7 @@ dataset \( \mathcal{L} \) consisting of the data
\( \mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\} \).
-
As in part d), we assume that the true data is generated from a noisy model
+
We assume that the true data is generated from a noisy model
In our derivation of the ordinary least squares method we defined then
an approximation to the function \( f \) in terms of the parameters
-\( \boldsymbol{\beta} \) and the design matrix \( \boldsymbol{X} \) which embody our model,
-that is \( \boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\beta} \).
+\( \boldsymbol{\theta} \) and the design matrix \( \boldsymbol{X} \) which embody our model,
+that is \( \boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\theta} \).
-
The parameters \( \boldsymbol{\beta} \) are in turn found by optimizing the mean
+
The parameters \( \boldsymbol{\theta} \) are in turn found by optimizing the mean
squared error via the so-called cost function
Here the expected value \( \mathbb{E} \) is the sample value.
-
Show that you can rewrite this in terms of a term which contains the variance of the model itself (the so-called variance term), a
-term which measures the deviation from the true data and the mean value of the model (the bias term) and finally the variance of the noise.
-That is, show that
+
Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
The answer to this exercise should be included in the theory part of the report. This exercise is also part of the weekly exercises of week 38.
-Explain what the terms mean and discuss their interpretations.
+
Important note: Since the function \( f(x) \) is unknown, in order to be able to evalute the bias, we replace \( f(\boldsymbol{x}) \) in the expression for the bias with \( \boldsymbol{y} \).
+
+
The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
When using codes and material from other sources, you should refer to
these in the bibliography of your report, indicating wherefrom you for
example got the code, whether this is from the lecture notes,
-softwares like Scikit-Learn, TensorFlow, PyTorch or other sources such
-AI software. These should always be cited correctly. How to cite some
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
of the libraries is often indicated from their corresponding GitHub
sites or websites, see for example how to cite Scikit-Learn at
https://scikit-learn.org/dev/about.html.
diff --git a/doc/Projects/2025/Project1/html/Project1.html b/doc/Projects/2025/Project1/html/Project1.html
index 7df63b940..30ea4cd6e 100644
--- a/doc/Projects/2025/Project1/html/Project1.html
+++ b/doc/Projects/2025/Project1/html/Project1.html
@@ -210,18 +210,20 @@ MathJax.Hub.Config({
Preamble: Note on writing reports, using reference material, AI and other tools
We want you to answer the three different projects by handing in
-reports written like a standard scientific/technical report. The links
-at https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
-Furthermore, at the same link,
-you can find examples of previous reports. How to write reports will
-also be discussed during the various lab sessions. Please do ask us if you are in doubt.
+reports written like a standard scientific/technical report. The
+links at
+https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
When using codes and material from other sources, you should refer to
these in the bibliography of your report, indicating wherefrom you for
example got the code, whether this is from the lecture notes,
-softwares like Scikit-Learn, TensorFlow, PyTorch or other sources such
-AI software. These should always be cited correctly. How to cite some
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
of the libraries is often indicated from their corresponding GitHub
sites or websites, see for example how to cite Scikit-Learn at
https://scikit-learn.org/dev/about.html.
@@ -253,7 +255,7 @@ other data sets, make sure these are sets used for regression problems
Regression analysis and resampling methods
The main aim of this project is to study in more detail various
-regression methods, including the Ordinary Least Squares (OLS) method.
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
In addition to the scientific part, in this course we want also to
give you an experience in writing scientific reports.
@@ -269,27 +271,26 @@ $$
Our first step will be to perform an OLS regression analysis of this
function, trying out a polynomial fit with an \( x \) dependence of the
-form \( [x,x^2,\dots] \). We can use a uniform distribution to set up the
+form \( [x,x^2,\dots] \). You can use a uniform distribution to set up the
arrays of values for \( x \in [-1,1] \), or alternatively use a fixed step size.
-Thereafter we will repeat much of the
-same procedure using the Ridge and Lasso regression methods,
-introducing thus a dependence on the hyperparameter (penalty) \( \lambda \).
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) \( \lambda \).
We will also include bootstrap as a resampling technique in order to
study the so-called bias-variance tradeoff. After that we will
-include the cross-validation technique.
+include the so-called cross-validation technique.
Part a : Ordinary Least Square (OLS) for the Runge function
-
We will generate our own dataset for a function
+
We will generate our own dataset for abovementioned function
\( \mathrm{Runge}(x) \) function with \( x\in [-1,1] \). You should explore also the addition
of an added stochastic noise to this function using the normal
distribution \( N(0,1) \).
Write your own code (using for example the pseudoinverse function pinv from Numpy ) and perform a standard ordinary least square regression
-analysis using polynomials in \( x \) up to order \( 15 \). Explore the dependence on the number of data points and the polynomial degree.
+analysis using polynomials in \( x \) up to order \( 15 \) or higher. Explore the dependence on the number of data points and the polynomial degree.
Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 20).
+
Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
Plot also the parameters \( \theta \) as you increase the order of the polynomial. Comment your results.
Your code has to include a scaling/centering of the data (for example by
subtracting the mean value), and
-a split of the data in training and test data. For this exercise you can
+a split of the data in training and test data. For the scaling you can
either write your own code or use for example the function for
splitting training data provided by the library Scikit-Learn (make
sure you have installed it). This function is called
@@ -342,11 +343,11 @@ See also the lecture slides from week 35 and week 36.
Part b: Adding Ridge regression for the Runge function
Write your own code for the Ridge method as done in the previous
-exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the exercise from week 36 is something you can reuse here.
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
Perform the same analysis as you did in the previous exercise but now for different values of \( \lambda \). Compare and
-analyze your results with those obtained in part a) with the ordinary least squares method. Study the
+analyze your results with those obtained in part a) with the OLS method. Study the
dependence on \( \lambda \).
Part c: Writing your own gradient descent code
@@ -367,15 +368,15 @@ descent approch. Discuss in particular the role of the learning rate.
the gradient descent method by including momentum, ADAgrad,
RMSprop and ADAM as methods fro iteratively updating your learning
rate. Discuss the results and compare the different methods applied to
-the one-dimensional Runge function.
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
Part e: Writing our own code for Lasso regression
LASSO regression (see lecture slides from week 36 and week 37)
represents our first encounter with a machine learning method which
-cannot be solved through analytical expressions. Use the gradient
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
descent methods you developed in parts c) and d) to solve the LASSO
-optimization problem. You can compare your results using
+optimization problem. You can compare your results with
the functionalities of Scikit-Learn.
@@ -385,14 +386,16 @@ approaches.
Part f: Stochastic gradient descent
-
Our last gradient step is to include stochastic gradient descent using the
-same methods to update the learning rates as in parts c-e).
-Compare and discuss your results with and without stochastic gradient and give a critical assessment of the various methods.
+
Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
Part g: Bias-variance trade-off and resampling techniques
-
Our aim here is to study the bias-variance trade-off by implementing the bootstrap resampling technique.
-We will only use the simpler ordinary least squares here.
+
Our aim here is to study the bias-variance trade-off by implementing
+the bootstrap resampling technique. We will only use the simpler
+ordinary least squares here.
With a code which does OLS and includes resampling techniques,
@@ -402,11 +405,14 @@ intuitions and ideas discussed here also carry over to classification
tasks and basically all Machine Learning algorithms.
-
Before you perform an analysis of the bias-variance trade-off on your test data, make
-first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and
-Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to
-indicate possible regions of low/high bias and variance. You will most likely not get an
-equally smooth curve!
+
Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig. 2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
With this result we move on to the bias-variance trade-off analysis.
@@ -416,7 +422,7 @@ dataset \( \mathcal{L} \) consisting of the data
\( \mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\} \).
-
As in part d), we assume that the true data is generated from a noisy model
+
We assume that the true data is generated from a noisy model
In our derivation of the ordinary least squares method we defined then
an approximation to the function \( f \) in terms of the parameters
-\( \boldsymbol{\beta} \) and the design matrix \( \boldsymbol{X} \) which embody our model,
-that is \( \boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\beta} \).
+\( \boldsymbol{\theta} \) and the design matrix \( \boldsymbol{X} \) which embody our model,
+that is \( \boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\theta} \).
-
The parameters \( \boldsymbol{\beta} \) are in turn found by optimizing the mean
+
The parameters \( \boldsymbol{\theta} \) are in turn found by optimizing the mean
squared error via the so-called cost function
Here the expected value \( \mathbb{E} \) is the sample value.
-
Show that you can rewrite this in terms of a term which contains the variance of the model itself (the so-called variance term), a
-term which measures the deviation from the true data and the mean value of the model (the bias term) and finally the variance of the noise.
-That is, show that
+
Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
The answer to this exercise should be included in the theory part of the report. This exercise is also part of the weekly exercises of week 38.
-Explain what the terms mean and discuss their interpretations.
+
Important note: Since the function \( f(x) \) is unknown, in order to be able to evalute the bias, we replace \( f(\boldsymbol{x}) \) in the expression for the bias with \( \boldsymbol{y} \).
+
+
The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
Project 1 on Machine Learning, deadline October 6 (midnight), 2025
+
+
+
+
+Data Analysis and Machine Learning FYS-STK3155/FYS4155
+
+
+
+University of Oslo, Norway
+
+
+
+
September 2
+
+
+
+
+
+
Preamble: Note on writing reports, using reference material, AI and other tools
+
+
We want you to answer the three different projects by handing in
+reports written like a standard scientific/technical report. The
+links at
+https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
+
+
+
When using codes and material from other sources, you should refer to
+these in the bibliography of your report, indicating wherefrom you for
+example got the code, whether this is from the lecture notes,
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
+of the libraries is often indicated from their corresponding GitHub
+sites or websites, see for example how to cite Scikit-Learn at
+https://scikit-learn.org/dev/about.html.
+
+
+
We enocurage you to use tools like
+ChatGPT or similar in writing the report. If you use for example ChatGPT,
+please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can
+be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.
+
+
+
If you would like to study other data sets, feel free to propose other
+sets. What we have proposed here are mere suggestions from our
+side. If you opt for another data set, consider using a set which has
+been studied in the scientific literature. This makes it easier for
+you to compare and analyze your results. Comparing with existing
+results from the scientific literature is also an essential element of
+the scientific discussion. The University of California at Irvine
+with its Machine Learning repository at
+https://archive.ics.uci.edu/ml/index.php is an excellent site to
+look up for examples and
+inspiration. Kaggle.com is an equally
+interesting site. Feel free to explore these sites. When selecting
+other data sets, make sure these are sets used for regression problems
+(not classification).
+
The main aim of this project is to study in more detail various
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
+In addition to the scientific part, in this course we want also to
+give you an experience in writing scientific reports.
+
+
+
We will study how to fit polynomials to specific
+one-dimensional functions (feel free to replace the suggested function with more complicated ones).
+
Our first step will be to perform an OLS regression analysis of this
+function, trying out a polynomial fit with an \( x \) dependence of the
+form \( [x,x^2,\dots] \). You can use a uniform distribution to set up the
+arrays of values for \( x \in [-1,1] \), or alternatively use a fixed step size.
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) \( \lambda \).
+
+
+
We will also include bootstrap as a resampling technique in order to
+study the so-called bias-variance tradeoff. After that we will
+include the so-called cross-validation technique.
+
+
Part a : Ordinary Least Square (OLS) for the Runge function
+
+
We will generate our own dataset for abovementioned function
+\( \mathrm{Runge}(x) \) function with \( x\in [-1,1] \). You should explore also the addition
+of an added stochastic noise to this function using the normal
+distribution \( N(0,1) \).
+
+
+
Write your own code (using for example the pseudoinverse function pinv from Numpy ) and perform a standard ordinary least square regression
+analysis using polynomials in \( x \) up to order \( 15 \) or higher. Explore the dependence on the number of data points and the polynomial degree.
+
and the \( R^2 \) score function. If \( \tilde{\boldsymbol{y}}_i \) is the predicted
+value of the \( i-th \) sample and \( y_i \) is the corresponding true value,
+then the score \( R^2 \) is defined as
+
Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
+Plot also the parameters \( \theta \) as you increase the order of the polynomial. Comment your results.
+
+
+
Your code has to include a scaling/centering of the data (for example by
+subtracting the mean value), and
+a split of the data in training and test data. For the scaling you can
+either write your own code or use for example the function for
+splitting training data provided by the library Scikit-Learn (make
+sure you have installed it). This function is called
+\( train\_test\_split \). You should present a critical discussion of why and how you have scaled or not scaled the data.
+
+
+
It is normal in essentially all Machine Learning studies to split the
+data in a training set and a test set (eventually also an additional
+validation set). There
+is no explicit recipe for how much data should be included as training
+data and say test data. An accepted rule of thumb is to use
+approximately \( 2/3 \) to \( 4/5 \) of the data as training data.
+
+
+
You can easily reuse the solutions to your exercises from week 35.
+See also the lecture slides from week 35 and week 36.
+
Part b: Adding Ridge regression for the Runge function
+
+
Write your own code for the Ridge method as done in the previous
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
+
+
+
Perform the same analysis as you did in the previous exercise but now for different values of \( \lambda \). Compare and
+analyze your results with those obtained in part a) with the OLS method. Study the
+dependence on \( \lambda \).
+
+
Part c: Writing your own gradient descent code
+
+
Replace now the analytical expressions for the optimal parameters
+\( \boldsymbol{\theta} \) with your own gradient descent code. In this exercise we
+focus only on the simplest gradient descent approach with a fixed
+learning rate (see the exercises from week 37 and the lecture notes
+from week 36).
+
+
+
Study and compare your results from parts a) and b) with your gradient
+descent approch. Discuss in particular the role of the learning rate.
+
+
Part d: Including momentum and more advanced ways to update the learning the rate
+
+
We keep our focus on OLS and Ridge regression and update our code for
+the gradient descent method by including momentum, ADAgrad,
+RMSprop and ADAM as methods fro iteratively updating your learning
+rate. Discuss the results and compare the different methods applied to
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
+
+
Part e: Writing our own code for Lasso regression
+
+
LASSO regression (see lecture slides from week 36 and week 37)
+represents our first encounter with a machine learning method which
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
+descent methods you developed in parts c) and d) to solve the LASSO
+optimization problem. You can compare your results with
+the functionalities of Scikit-Learn.
+
+
+
Discuss (critically) your results for the Runge function from OLS,
+Ridge and LASSO regression using the various gradient descent
+approaches.
+
+
Part f: Stochastic gradient descent
+
+
Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
+
+
Part g: Bias-variance trade-off and resampling techniques
+
+
Our aim here is to study the bias-variance trade-off by implementing
+the bootstrap resampling technique. We will only use the simpler
+ordinary least squares here.
+
+
+
With a code which does OLS and includes resampling techniques,
+we will now discuss the bias-variance trade-off in the context of
+continuous predictions such as regression. However, many of the
+intuitions and ideas discussed here also carry over to classification
+tasks and basically all Machine Learning algorithms.
+
+
+
Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig. 2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
+
+
+
With this result we move on to the bias-variance trade-off analysis.
+
+
Consider a
+dataset \( \mathcal{L} \) consisting of the data
+\( \mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\} \).
+
+
+
We assume that the true data is generated from a noisy model
Here \( \epsilon \) is normally distributed with mean zero and standard
+deviation \( \sigma^2 \).
+
+
+
In our derivation of the ordinary least squares method we defined then
+an approximation to the function \( f \) in terms of the parameters
+\( \boldsymbol{\theta} \) and the design matrix \( \boldsymbol{X} \) which embody our model,
+that is \( \boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\theta} \).
+
+
+
The parameters \( \boldsymbol{\theta} \) are in turn found by optimizing the mean
+squared error via the so-called cost function
+
Here the expected value \( \mathbb{E} \) is the sample value.
+
+
Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
+
Important note: Since the function \( f(x) \) is unknown, in order to be able to evalute the bias, we replace \( f(\boldsymbol{x}) \) in the expression for the bias with \( \boldsymbol{y} \).
+
+
The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
+
+
+
Perform then a bias-variance analysis of the Runge function by
+studying the MSE value as function of the complexity of your model.
+
Part h): Cross-validation as resampling techniques, adding more complexity
+
+
The aim here is to implement another widely popular
+resampling technique, the so-called cross-validation method.
+
+
+
Implement the \( k \)-fold cross-validation algorithm (feel free to use
+the functionality of Scikit-Learn or write your own code) and
+evaluate again the MSE function resulting from the test folds.
+
+
+
Compare the MSE you get from your cross-validation code with the one
+you got from your bootstrap code from the previous exercise. Comment and interpret your results.
+
+
+
In addition to using the ordinary least squares method, you should
+include both Ridge and Lasso regression in the final analysis.
+
Here follows a brief recipe and recommendation on how to answer the various questions when preparing your answers.
+
+
+
Give a short description of the nature of the problem and the eventual numerical methods you have used.
+
Describe the algorithm you have used and/or developed. Here you may find it convenient to use pseudocoding. In many cases you can describe the algorithm in the program itself.
+
Include the source code of your program. Comment your program properly. You should have the code at your GitHub/GitLab link. You can also place the code in an appendix of your report.
+
If possible, try to find analytic solutions, or known limits in order to test your program when developing the code.
+
Include your results either in figure form or in a table. Remember to label your results. All tables and figures should have relevant captions and labels on the axes.
+
Try to evaluate the reliabilty and numerical stability/precision of your results. If possible, include a qualitative and/or quantitative discussion of the numerical stability, eventual loss of precision etc.
+
Try to give an interpretation of you results in your answers to the problems.
+
Critique: if possible include your comments and reflections about the exercise, whether you felt you learnt something, ideas for improvements and other thoughts you've made when solving the exercise. We wish to keep this course at the interactive level and your comments can help us improve it.
+
Try to establish a practice where you log your work at the computerlab. You may find such a logbook very handy at later stages in your work, especially when you don't properly remember what a previous test version of your program did. Here you could also record the time spent on solving the exercise, various algorithms you may have tested or other topics which you feel worthy of mentioning.
+
+
Format for electronic delivery of report and programs
+
+
The preferred format for the report is a PDF file. You can also use DOC or postscript formats or as an ipython notebook file. As programming language we prefer that you choose between C/C++, Fortran2008, Julia or Python. The following prescription should be followed when preparing the report:
Upload only the report file or the link to your GitHub/GitLab or similar typo of repos! For the source code file(s) you have developed please provide us with your link to your GitHub/GitLab or similar domain. The report file should include all of your discussions and a list of the codes you have developed. Do not include library files which are available at the course homepage, unless you have made specific changes to them.
+
In your GitHub/GitLab or similar repository, please include a folder which contains selected results. These can be in the form of output from your code for a selected set of runs and input parameters.
+
+
Finally,
+we encourage you to collaborate. Optimal working groups consist of
+2-3 students. You can then hand in a common report.
+
+
Software and needed installations
+
+
If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages,
+we recommend that you install the following Python packages via pip as
+
See below for a discussion of tensorflow and scikit-learn.
+
+
For OSX users we recommend also, after having installed Xcode, to install brew. Brew allows
+for a seamless installation of additional software via for example
+
+
+
brew install python3
+
+
For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution
+you can use pip as well and simply install Python as
+
+
+
sudo apt-get install python3 (or python for python2.7)
+
+
etc etc.
+
+
If you don't want to install various Python packages with their dependencies separately, we recommend two widely used distrubutions which set up all relevant dependencies for Python, namely
+
+
Anaconda Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system conda
+
Enthought canopy is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.
+
+
Popular software packages written in Python for ML are
These are all freely available at their respective GitHub sites. They
+encompass communities of developers in the thousands or more. And the number
+of code developers and contributors keeps increasing.
+
Project 1 on Machine Learning, deadline October 6 (midnight), 2025
+
+
+
+
+Data Analysis and Machine Learning FYS-STK3155/FYS4155
+
+
+
+University of Oslo, Norway
+
+
+
+
September 2
+
+
+
+
+
+
Preamble: Note on writing reports, using reference material, AI and other tools
+
+
We want you to answer the three different projects by handing in
+reports written like a standard scientific/technical report. The
+links at
+https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
+
+
+
When using codes and material from other sources, you should refer to
+these in the bibliography of your report, indicating wherefrom you for
+example got the code, whether this is from the lecture notes,
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
+of the libraries is often indicated from their corresponding GitHub
+sites or websites, see for example how to cite Scikit-Learn at
+https://scikit-learn.org/dev/about.html.
+
+
+
We enocurage you to use tools like
+ChatGPT or similar in writing the report. If you use for example ChatGPT,
+please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can
+be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.
+
+
+
If you would like to study other data sets, feel free to propose other
+sets. What we have proposed here are mere suggestions from our
+side. If you opt for another data set, consider using a set which has
+been studied in the scientific literature. This makes it easier for
+you to compare and analyze your results. Comparing with existing
+results from the scientific literature is also an essential element of
+the scientific discussion. The University of California at Irvine
+with its Machine Learning repository at
+https://archive.ics.uci.edu/ml/index.php is an excellent site to
+look up for examples and
+inspiration. Kaggle.com is an equally
+interesting site. Feel free to explore these sites. When selecting
+other data sets, make sure these are sets used for regression problems
+(not classification).
+
+
+
+
+
+
+
+
diff --git a/doc/src/Projects/2025/Project1/Project1.do.txt b/doc/src/Projects/2025/Project1/Project1.do.txt
index 2d538fb60..3eb4a3ec1 100644
--- a/doc/src/Projects/2025/Project1/Project1.do.txt
+++ b/doc/src/Projects/2025/Project1/Project1.do.txt
@@ -6,19 +6,21 @@ DATE: September 2
===== Preamble: Note on writing reports, using reference material, AI and other tools =====
We want you to answer the three different projects by handing in
-reports written like a standard scientific/technical report. The links
-at URL:"https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects"
-Furthermore, at the same link,
-you can find examples of previous reports. How to write reports will
-also be discussed during the various lab sessions. Please do ask us if you are in doubt.
+reports written like a standard scientific/technical report. The
+links at
+URL:"https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects"
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
When using codes and material from other sources, you should refer to
these in the bibliography of your report, indicating wherefrom you for
example got the code, whether this is from the lecture notes,
-softwares like Scikit-Learn, TensorFlow, PyTorch or other sources such
-AI software. These should always be cited correctly. How to cite some
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
of the libraries is often indicated from their corresponding GitHub
sites or websites, see for example how to cite Scikit-Learn at
URL:"https://scikit-learn.org/dev/about.html".
@@ -52,7 +54,7 @@ other data sets, make sure these are sets used for regression problems
The main aim of this project is to study in more detail various
-regression methods, including the Ordinary Least Squares (OLS) method.
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
In addition to the scientific part, in this course we want also to
give you an experience in writing scientific reports.
@@ -71,26 +73,25 @@ f(x) = \frac{1}{1+25x^2}.
Our first step will be to perform an OLS regression analysis of this
function, trying out a polynomial fit with an $x$ dependence of the
-form $[x,x^2,\dots]$. We can use a uniform distribution to set up the
+form $[x,x^2,\dots]$. You can use a uniform distribution to set up the
arrays of values for $x \in [-1,1]$, or alternatively use a fixed step size.
-Thereafter we will repeat much of the
-same procedure using the Ridge and Lasso regression methods,
-introducing thus a dependence on the hyperparameter (penalty) $\lambda$.
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) $\lambda$.
We will also include bootstrap as a resampling technique in order to
study the so-called _bias-variance tradeoff_. After that we will
-include the cross-validation technique.
+include the so-called cross-validation technique.
=== Part a : Ordinary Least Square (OLS) for the Runge function ===
-We will generate our own dataset for a function
+We will generate our own dataset for abovementioned function
$\mathrm{Runge}(x)$ function with $x\in [-1,1]$. You should explore also the addition
of an added stochastic noise to this function using the normal
distribution $N(0,1)$.
*Write your own code* (using for example the pseudoinverse function _pinv_ from _Numpy_ ) and perform a standard _ordinary least square regression_
-analysis using polynomials in $x$ up to order $15$. Explore the dependence on the number of data points and the polynomial degree.
+analysis using polynomials in $x$ up to order $15$ or higher. Explore the dependence on the number of data points and the polynomial degree.
Evaluate the mean Squared error (MSE)
@@ -119,12 +120,12 @@ where we have defined the mean value of $\bm{y}$ as
\]
!et
-Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 20).
+Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
Plot also the parameters $\theta$ as you increase the order of the polynomial. Comment your results.
Your code has to include a scaling/centering of the data (for example by
subtracting the mean value), and
-a split of the data in training and test data. For this exercise you can
+a split of the data in training and test data. For the scaling you can
either write your own code or use for example the function for
splitting training data provided by the library _Scikit-Learn_ (make
sure you have installed it). This function is called
@@ -149,10 +150,10 @@ On scaling, we recommend reading the following section from the scikit-learn sof
=== Part b: Adding Ridge regression for the Runge function ===
Write your own code for the Ridge method as done in the previous
-exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the exercise from week 36 is something you can reuse here.
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
Perform the same analysis as you did in the previous exercise but now for different values of $\lambda$. Compare and
-analyze your results with those obtained in part a) with the ordinary least squares method. Study the
+analyze your results with those obtained in part a) with the OLS method. Study the
dependence on $\lambda$.
@@ -174,16 +175,16 @@ We keep our focus on OLS and Ridge regression and update our code for
the gradient descent method by including _momentum_, _ADAgrad_,
_RMSprop_ and _ADAM_ as methods fro iteratively updating your learning
rate. Discuss the results and compare the different methods applied to
-the one-dimensional Runge function.
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
=== Part e: Writing our own code for Lasso regression ===
LASSO regression (see lecture slides from week 36 and week 37)
represents our first encounter with a machine learning method which
-cannot be solved through analytical expressions. Use the gradient
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
descent methods you developed in parts c) and d) to solve the LASSO
-optimization problem. You can compare your results using
+optimization problem. You can compare your results with
the functionalities of _Scikit-Learn_.
Discuss (critically) your results for the Runge function from OLS,
@@ -192,14 +193,16 @@ approaches.
=== Part f: Stochastic gradient descent ===
-Our last gradient step is to include stochastic gradient descent using the
-same methods to update the learning rates as in parts c-e).
-Compare and discuss your results with and without stochastic gradient and give a critical assessment of the various methods.
+Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
=== Part g: Bias-variance trade-off and resampling techniques ===
-Our aim here is to study the bias-variance trade-off by implementing the _bootstrap_ resampling technique.
-_We will only use the simpler ordinary least squares here_.
+Our aim here is to study the bias-variance trade-off by implementing
+the _bootstrap_ resampling technique. _We will only use the simpler
+ordinary least squares here_.
With a code which does OLS and includes resampling techniques,
@@ -208,11 +211,14 @@ continuous predictions such as regression. However, many of the
intuitions and ideas discussed here also carry over to classification
tasks and basically all Machine Learning algorithms.
-Before you perform an analysis of the bias-variance trade-off on your test data, make
-first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and
-Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to
-indicate possible regions of low/high bias and variance. You will most likely not get an
-equally smooth curve!
+Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig. 2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
With this result we move on to the bias-variance trade-off analysis.
@@ -220,7 +226,7 @@ Consider a
dataset $\mathcal{L}$ consisting of the data
$\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}$.
-As in part d), we assume that the true data is generated from a noisy model
+We assume that the true data is generated from a noisy model
!bt
\[
@@ -233,28 +239,32 @@ deviation $\sigma^2$.
In our derivation of the ordinary least squares method we defined then
an approximation to the function $f$ in terms of the parameters
-$\bm{\beta}$ and the design matrix $\bm{X}$ which embody our model,
-that is $\bm{\tilde{y}}=\bm{X}\bm{\beta}$.
+$\bm{\theta}$ and the design matrix $\bm{X}$ which embody our model,
+that is $\bm{\tilde{y}}=\bm{X}\bm{\theta}$.
-The parameters $\bm{\beta}$ are in turn found by optimizing the mean
+The parameters $\bm{\theta}$ are in turn found by optimizing the mean
squared error via the so-called cost function
!bt
\[
-C(\bm{X},\bm{\beta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right].
+C(\bm{X},\bm{\theta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right].
\]
!et
Here the expected value $\mathbb{E}$ is the sample value.
-Show that you can rewrite this in terms of a term which contains the variance of the model itself (the so-called variance term), a
-term which measures the deviation from the true data and the mean value of the model (the bias term) and finally the variance of the noise.
+Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
+
+
That is, show that
!bt
\[
\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\mathrm{Bias}[\tilde{y}]+\mathrm{var}[\tilde{y}]+\sigma^2,
\]
!et
-with
+with (we approximate $f(\bm{x})\approx \bm{y}$)
!bt
\[
\mathrm{Bias}[\tilde{y}]=\mathbb{E}\left[\left(\bm{y}-\mathbb{E}\left[\bm{\tilde{y}}\right]\right)^2\right],
@@ -266,8 +276,14 @@ and
\mathrm{var}[\tilde{y}]=\mathbb{E}\left[\left(\tilde{\bm{y}}-\mathbb{E}\left[\bm{\tilde{y}}\right]\right)^2\right]=\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\bm{\tilde{y}}\right])^2.
\]
!et
-The answer to this exercise should be included in the theory part of the report. This exercise is also part of the weekly exercises of week 38.
-Explain what the terms mean and discuss their interpretations.
+
+
+_Important note_: Since the function $f(x)$ is unknown, in order to be able to evalute the bias, we replace $f(\bm{x})$ in the expression for the bias with $\bm{y}$.
+
+The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
Perform then a bias-variance analysis of the Runge function by
studying the MSE value as function of the complexity of your model.
@@ -285,14 +301,17 @@ You can follow the code example in the jupyter-book at URL:"https://compphysics.
The aim here is to implement another widely popular
resampling technique, the so-called cross-validation method.
-Implement the $k$-fold cross-validation algorithm (feel free to use the functionality of _Scikit-Learn_ or write your own code) and evaluate again the MSE function resulting
-from the test folds.
+Implement the $k$-fold cross-validation algorithm (feel free to use
+the functionality of _Scikit-Learn_ or write your own code) and
+evaluate again the MSE function resulting from the test folds.
+
+
Compare the MSE you get from your cross-validation code with the one
-you got from your _bootstrap_ code. Comment your results. Try $5-10$
-folds.
+you got from your _bootstrap_ code from the previous exercise. Comment and interpret your results.
-In addition to using the ordinary least squares method, you should include both Ridge and Lasso regression in the analysis.
+In addition to using the ordinary least squares method, you should
+include both Ridge and Lasso regression in the final analysis.
diff --git a/doc/src/Projects/2025/Project1/Project1.html b/doc/src/Projects/2025/Project1/Project1.html
new file mode 100644
index 000000000..30ea4cd6e
--- /dev/null
+++ b/doc/src/Projects/2025/Project1/Project1.html
@@ -0,0 +1,588 @@
+
+
+
+
+
+
+
+Project 1 on Machine Learning, deadline October 6 (midnight), 2025
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Project 1 on Machine Learning, deadline October 6 (midnight), 2025
+
+
+
+
+Data Analysis and Machine Learning FYS-STK3155/FYS4155
+
+
+
+University of Oslo, Norway
+
+
+
+
September 2
+
+
+
Preamble: Note on writing reports, using reference material, AI and other tools
+
+
We want you to answer the three different projects by handing in
+reports written like a standard scientific/technical report. The
+links at
+https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
+
+
+
When using codes and material from other sources, you should refer to
+these in the bibliography of your report, indicating wherefrom you for
+example got the code, whether this is from the lecture notes,
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
+of the libraries is often indicated from their corresponding GitHub
+sites or websites, see for example how to cite Scikit-Learn at
+https://scikit-learn.org/dev/about.html.
+
+
+
We enocurage you to use tools like
+ChatGPT or similar in writing the report. If you use for example ChatGPT,
+please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can
+be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.
+
+
+
If you would like to study other data sets, feel free to propose other
+sets. What we have proposed here are mere suggestions from our
+side. If you opt for another data set, consider using a set which has
+been studied in the scientific literature. This makes it easier for
+you to compare and analyze your results. Comparing with existing
+results from the scientific literature is also an essential element of
+the scientific discussion. The University of California at Irvine
+with its Machine Learning repository at
+https://archive.ics.uci.edu/ml/index.php is an excellent site to
+look up for examples and
+inspiration. Kaggle.com is an equally
+interesting site. Feel free to explore these sites. When selecting
+other data sets, make sure these are sets used for regression problems
+(not classification).
+
+
+
+
Regression analysis and resampling methods
+
+
The main aim of this project is to study in more detail various
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
+In addition to the scientific part, in this course we want also to
+give you an experience in writing scientific reports.
+
+
+
We will study how to fit polynomials to specific
+one-dimensional functions (feel free to replace the suggested function with more complicated ones).
+
Our first step will be to perform an OLS regression analysis of this
+function, trying out a polynomial fit with an \( x \) dependence of the
+form \( [x,x^2,\dots] \). You can use a uniform distribution to set up the
+arrays of values for \( x \in [-1,1] \), or alternatively use a fixed step size.
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) \( \lambda \).
+
+
+
We will also include bootstrap as a resampling technique in order to
+study the so-called bias-variance tradeoff. After that we will
+include the so-called cross-validation technique.
+
+
Part a : Ordinary Least Square (OLS) for the Runge function
+
+
We will generate our own dataset for abovementioned function
+\( \mathrm{Runge}(x) \) function with \( x\in [-1,1] \). You should explore also the addition
+of an added stochastic noise to this function using the normal
+distribution \( N(0,1) \).
+
+
+
Write your own code (using for example the pseudoinverse function pinv from Numpy ) and perform a standard ordinary least square regression
+analysis using polynomials in \( x \) up to order \( 15 \) or higher. Explore the dependence on the number of data points and the polynomial degree.
+
and the \( R^2 \) score function. If \( \tilde{\boldsymbol{y}}_i \) is the predicted
+value of the \( i-th \) sample and \( y_i \) is the corresponding true value,
+then the score \( R^2 \) is defined as
+
Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
+Plot also the parameters \( \theta \) as you increase the order of the polynomial. Comment your results.
+
+
+
Your code has to include a scaling/centering of the data (for example by
+subtracting the mean value), and
+a split of the data in training and test data. For the scaling you can
+either write your own code or use for example the function for
+splitting training data provided by the library Scikit-Learn (make
+sure you have installed it). This function is called
+\( train\_test\_split \). You should present a critical discussion of why and how you have scaled or not scaled the data.
+
+
+
It is normal in essentially all Machine Learning studies to split the
+data in a training set and a test set (eventually also an additional
+validation set). There
+is no explicit recipe for how much data should be included as training
+data and say test data. An accepted rule of thumb is to use
+approximately \( 2/3 \) to \( 4/5 \) of the data as training data.
+
+
+
You can easily reuse the solutions to your exercises from week 35.
+See also the lecture slides from week 35 and week 36.
+
Part b: Adding Ridge regression for the Runge function
+
+
Write your own code for the Ridge method as done in the previous
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
+
+
+
Perform the same analysis as you did in the previous exercise but now for different values of \( \lambda \). Compare and
+analyze your results with those obtained in part a) with the OLS method. Study the
+dependence on \( \lambda \).
+
+
Part c: Writing your own gradient descent code
+
+
Replace now the analytical expressions for the optimal parameters
+\( \boldsymbol{\theta} \) with your own gradient descent code. In this exercise we
+focus only on the simplest gradient descent approach with a fixed
+learning rate (see the exercises from week 37 and the lecture notes
+from week 36).
+
+
+
Study and compare your results from parts a) and b) with your gradient
+descent approch. Discuss in particular the role of the learning rate.
+
+
Part d: Including momentum and more advanced ways to update the learning the rate
+
+
We keep our focus on OLS and Ridge regression and update our code for
+the gradient descent method by including momentum, ADAgrad,
+RMSprop and ADAM as methods fro iteratively updating your learning
+rate. Discuss the results and compare the different methods applied to
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
+
+
Part e: Writing our own code for Lasso regression
+
+
LASSO regression (see lecture slides from week 36 and week 37)
+represents our first encounter with a machine learning method which
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
+descent methods you developed in parts c) and d) to solve the LASSO
+optimization problem. You can compare your results with
+the functionalities of Scikit-Learn.
+
+
+
Discuss (critically) your results for the Runge function from OLS,
+Ridge and LASSO regression using the various gradient descent
+approaches.
+
+
Part f: Stochastic gradient descent
+
+
Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
+
+
Part g: Bias-variance trade-off and resampling techniques
+
+
Our aim here is to study the bias-variance trade-off by implementing
+the bootstrap resampling technique. We will only use the simpler
+ordinary least squares here.
+
+
+
With a code which does OLS and includes resampling techniques,
+we will now discuss the bias-variance trade-off in the context of
+continuous predictions such as regression. However, many of the
+intuitions and ideas discussed here also carry over to classification
+tasks and basically all Machine Learning algorithms.
+
+
+
Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig. 2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
+
+
+
With this result we move on to the bias-variance trade-off analysis.
+
+
Consider a
+dataset \( \mathcal{L} \) consisting of the data
+\( \mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\} \).
+
+
+
We assume that the true data is generated from a noisy model
Here \( \epsilon \) is normally distributed with mean zero and standard
+deviation \( \sigma^2 \).
+
+
+
In our derivation of the ordinary least squares method we defined then
+an approximation to the function \( f \) in terms of the parameters
+\( \boldsymbol{\theta} \) and the design matrix \( \boldsymbol{X} \) which embody our model,
+that is \( \boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\theta} \).
+
+
+
The parameters \( \boldsymbol{\theta} \) are in turn found by optimizing the mean
+squared error via the so-called cost function
+
Here the expected value \( \mathbb{E} \) is the sample value.
+
+
Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
+
Important note: Since the function \( f(x) \) is unknown, in order to be able to evalute the bias, we replace \( f(\boldsymbol{x}) \) in the expression for the bias with \( \boldsymbol{y} \).
+
+
The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
+
+
+
Perform then a bias-variance analysis of the Runge function by
+studying the MSE value as function of the complexity of your model.
+
Part h): Cross-validation as resampling techniques, adding more complexity
+
+
The aim here is to implement another widely popular
+resampling technique, the so-called cross-validation method.
+
+
+
Implement the \( k \)-fold cross-validation algorithm (feel free to use
+the functionality of Scikit-Learn or write your own code) and
+evaluate again the MSE function resulting from the test folds.
+
+
+
Compare the MSE you get from your cross-validation code with the one
+you got from your bootstrap code from the previous exercise. Comment and interpret your results.
+
+
+
In addition to using the ordinary least squares method, you should
+include both Ridge and Lasso regression in the final analysis.
+
Here follows a brief recipe and recommendation on how to answer the various questions when preparing your answers.
+
+
+
Give a short description of the nature of the problem and the eventual numerical methods you have used.
+
Describe the algorithm you have used and/or developed. Here you may find it convenient to use pseudocoding. In many cases you can describe the algorithm in the program itself.
+
Include the source code of your program. Comment your program properly. You should have the code at your GitHub/GitLab link. You can also place the code in an appendix of your report.
+
If possible, try to find analytic solutions, or known limits in order to test your program when developing the code.
+
Include your results either in figure form or in a table. Remember to label your results. All tables and figures should have relevant captions and labels on the axes.
+
Try to evaluate the reliabilty and numerical stability/precision of your results. If possible, include a qualitative and/or quantitative discussion of the numerical stability, eventual loss of precision etc.
+
Try to give an interpretation of you results in your answers to the problems.
+
Critique: if possible include your comments and reflections about the exercise, whether you felt you learnt something, ideas for improvements and other thoughts you've made when solving the exercise. We wish to keep this course at the interactive level and your comments can help us improve it.
+
Try to establish a practice where you log your work at the computerlab. You may find such a logbook very handy at later stages in your work, especially when you don't properly remember what a previous test version of your program did. Here you could also record the time spent on solving the exercise, various algorithms you may have tested or other topics which you feel worthy of mentioning.
+
+
Format for electronic delivery of report and programs
+
+
The preferred format for the report is a PDF file. You can also use DOC or postscript formats or as an ipython notebook file. As programming language we prefer that you choose between C/C++, Fortran2008, Julia or Python. The following prescription should be followed when preparing the report:
Upload only the report file or the link to your GitHub/GitLab or similar typo of repos! For the source code file(s) you have developed please provide us with your link to your GitHub/GitLab or similar domain. The report file should include all of your discussions and a list of the codes you have developed. Do not include library files which are available at the course homepage, unless you have made specific changes to them.
+
In your GitHub/GitLab or similar repository, please include a folder which contains selected results. These can be in the form of output from your code for a selected set of runs and input parameters.
+
+
Finally,
+we encourage you to collaborate. Optimal working groups consist of
+2-3 students. You can then hand in a common report.
+
+
Software and needed installations
+
+
If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages,
+we recommend that you install the following Python packages via pip as
+
See below for a discussion of tensorflow and scikit-learn.
+
+
For OSX users we recommend also, after having installed Xcode, to install brew. Brew allows
+for a seamless installation of additional software via for example
+
+
+
brew install python3
+
+
For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution
+you can use pip as well and simply install Python as
+
+
+
sudo apt-get install python3 (or python for python2.7)
+
+
etc etc.
+
+
If you don't want to install various Python packages with their dependencies separately, we recommend two widely used distrubutions which set up all relevant dependencies for Python, namely
+
+
Anaconda Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system conda
+
Enthought canopy is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.
+
+
Popular software packages written in Python for ML are
These are all freely available at their respective GitHub sites. They
+encompass communities of developers in the thousands or more. And the number
+of code developers and contributors keeps increasing.
+
+
+
+
+
+
diff --git a/doc/src/Projects/2025/Project1/Project1.ipynb b/doc/src/Projects/2025/Project1/Project1.ipynb
new file mode 100644
index 000000000..1dd18f760
--- /dev/null
+++ b/doc/src/Projects/2025/Project1/Project1.ipynb
@@ -0,0 +1,641 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "b209e219",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "\n",
+ ""
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6fa4c4bc",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "# Project 1 on Machine Learning, deadline October 6 (midnight), 2025\n",
+ "**Data Analysis and Machine Learning FYS-STK3155/FYS4155**, University of Oslo, Norway\n",
+ "\n",
+ "Date: **September 2**"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "735b16c4",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Preamble: Note on writing reports, using reference material, AI and other tools\n",
+ "\n",
+ "We want you to answer the three different projects by handing in\n",
+ "reports written like a standard scientific/technical report. The\n",
+ "links at\n",
+ "\n",
+ "contain more information. There you can find examples of previous\n",
+ "reports, the projects themselves, how we rade reports etc. How to\n",
+ "write reports will also be discussed during the various lab\n",
+ "sessions. Please do ask us if you are in doubt.\n",
+ "\n",
+ "When using codes and material from other sources, you should refer to\n",
+ "these in the bibliography of your report, indicating wherefrom you for\n",
+ "example got the code, whether this is from the lecture notes,\n",
+ "softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources\n",
+ "should always be cited correctly. How to cite some\n",
+ "of the libraries is often indicated from their corresponding GitHub\n",
+ "sites or websites, see for example how to cite Scikit-Learn at\n",
+ ".\n",
+ "\n",
+ "We enocurage you to use tools like\n",
+ "[ChatGPT](https://openai.com/chatgpt/) or similar in writing the report. If you use for example ChatGPT,\n",
+ "please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can\n",
+ "be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.\n",
+ "\n",
+ "If you would like to study other data sets, feel free to propose other\n",
+ "sets. What we have proposed here are mere suggestions from our\n",
+ "side. If you opt for another data set, consider using a set which has\n",
+ "been studied in the scientific literature. This makes it easier for\n",
+ "you to compare and analyze your results. Comparing with existing\n",
+ "results from the scientific literature is also an essential element of\n",
+ "the scientific discussion. The University of California at Irvine\n",
+ "with its Machine Learning repository at\n",
+ " is an excellent site to\n",
+ "look up for examples and\n",
+ "inspiration. [Kaggle.com](https://www.kaggle.com/) is an equally\n",
+ "interesting site. Feel free to explore these sites. When selecting\n",
+ "other data sets, make sure these are sets used for regression problems\n",
+ "(not classification)."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0b7956ca",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Regression analysis and resampling methods\n",
+ "\n",
+ "The main aim of this project is to study in more detail various\n",
+ "regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.\n",
+ "In addition to the scientific part, in this course we want also to\n",
+ "give you an experience in writing scientific reports.\n",
+ "\n",
+ "We will study how to fit polynomials to specific\n",
+ "one-dimensional functions (feel free to replace the suggested function with more complicated ones).\n",
+ "\n",
+ "We will use Runge's function (see for a discussion). The one-dimensional function we will study is"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "28ba3d22",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "f(x) = \\frac{1}{1+25x^2}.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9a3e10ba",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Our first step will be to perform an OLS regression analysis of this\n",
+ "function, trying out a polynomial fit with an $x$ dependence of the\n",
+ "form $[x,x^2,\\dots]$. You can use a uniform distribution to set up the\n",
+ "arrays of values for $x \\in [-1,1]$, or alternatively use a fixed step size.\n",
+ "Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,\n",
+ "introducing thereby a dependence on the hyperparameter (penalty) $\\lambda$.\n",
+ "\n",
+ "We will also include bootstrap as a resampling technique in order to\n",
+ "study the so-called **bias-variance tradeoff**. After that we will\n",
+ "include the so-called cross-validation technique."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8aa547a5",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part a : Ordinary Least Square (OLS) for the Runge function\n",
+ "\n",
+ "We will generate our own dataset for abovementioned function\n",
+ "$\\mathrm{Runge}(x)$ function with $x\\in [-1,1]$. You should explore also the addition\n",
+ "of an added stochastic noise to this function using the normal\n",
+ "distribution $N(0,1)$.\n",
+ "\n",
+ "*Write your own code* (using for example the pseudoinverse function **pinv** from **Numpy** ) and perform a standard **ordinary least square regression**\n",
+ "analysis using polynomials in $x$ up to order $15$ or higher. Explore the dependence on the number of data points and the polynomial degree.\n",
+ "\n",
+ "Evaluate the mean Squared error (MSE)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "68fbf03d",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "MSE(\\boldsymbol{y},\\tilde{\\boldsymbol{y}}) = \\frac{1}{n}\n",
+ "\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b49509bc",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "and the $R^2$ score function. If $\\tilde{\\boldsymbol{y}}_i$ is the predicted\n",
+ "value of the $i-th$ sample and $y_i$ is the corresponding true value,\n",
+ "then the score $R^2$ is defined as"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "0fa4ffc6",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "R^2(\\boldsymbol{y}, \\tilde{\\boldsymbol{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "ce462b32",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "where we have defined the mean value of $\\boldsymbol{y}$ as"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a5fbef36",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "a6afe9cb",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).\n",
+ "Plot also the parameters $\\theta$ as you increase the order of the polynomial. Comment your results.\n",
+ "\n",
+ "Your code has to include a scaling/centering of the data (for example by\n",
+ "subtracting the mean value), and\n",
+ "a split of the data in training and test data. For the scaling you can\n",
+ "either write your own code or use for example the function for\n",
+ "splitting training data provided by the library **Scikit-Learn** (make\n",
+ "sure you have installed it). This function is called\n",
+ "$train\\_test\\_split$. **You should present a critical discussion of why and how you have scaled or not scaled the data**.\n",
+ "\n",
+ "It is normal in essentially all Machine Learning studies to split the\n",
+ "data in a training set and a test set (eventually also an additional\n",
+ "validation set). There\n",
+ "is no explicit recipe for how much data should be included as training\n",
+ "data and say test data. An accepted rule of thumb is to use\n",
+ "approximately $2/3$ to $4/5$ of the data as training data.\n",
+ "\n",
+ "You can easily reuse the solutions to your exercises from week 35.\n",
+ "See also the lecture slides from week 35 and week 36.\n",
+ "\n",
+ "On scaling, we recommend reading the following section from the scikit-learn software description, see ."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3be10f68",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part b: Adding Ridge regression for the Runge function\n",
+ "\n",
+ "Write your own code for the Ridge method as done in the previous\n",
+ "exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.\n",
+ "\n",
+ "Perform the same analysis as you did in the previous exercise but now for different values of $\\lambda$. Compare and\n",
+ "analyze your results with those obtained in part a) with the OLS method. Study the\n",
+ "dependence on $\\lambda$."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "caa7909c",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part c: Writing your own gradient descent code\n",
+ "\n",
+ "Replace now the analytical expressions for the optimal parameters\n",
+ "$\\boldsymbol{\\theta}$ with your own gradient descent code. In this exercise we\n",
+ "focus only on the simplest gradient descent approach with a fixed\n",
+ "learning rate (see the exercises from week 37 and the lecture notes\n",
+ "from week 36).\n",
+ "\n",
+ "Study and compare your results from parts a) and b) with your gradient\n",
+ "descent approch. Discuss in particular the role of the learning rate."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3aac4df1",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part d: Including momentum and more advanced ways to update the learning the rate\n",
+ "\n",
+ "We keep our focus on OLS and Ridge regression and update our code for\n",
+ "the gradient descent method by including **momentum**, **ADAgrad**,\n",
+ "**RMSprop** and **ADAM** as methods fro iteratively updating your learning\n",
+ "rate. Discuss the results and compare the different methods applied to\n",
+ "the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d0862a53",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part e: Writing our own code for Lasso regression\n",
+ "\n",
+ "LASSO regression (see lecture slides from week 36 and week 37)\n",
+ "represents our first encounter with a machine learning method which\n",
+ "cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient\n",
+ "descent methods you developed in parts c) and d) to solve the LASSO\n",
+ "optimization problem. You can compare your results with \n",
+ "the functionalities of **Scikit-Learn**.\n",
+ "\n",
+ "Discuss (critically) your results for the Runge function from OLS,\n",
+ "Ridge and LASSO regression using the various gradient descent\n",
+ "approaches."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "9170032e",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part f: Stochastic gradient descent\n",
+ "\n",
+ "Our last gradient step is to include stochastic gradient descent using\n",
+ "the same methods to update the learning rates as in parts c-e).\n",
+ "Compare and discuss your results with and without stochastic gradient\n",
+ "and give a critical assessment of the various methods."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "bacd1035",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part g: Bias-variance trade-off and resampling techniques\n",
+ "\n",
+ "Our aim here is to study the bias-variance trade-off by implementing\n",
+ "the **bootstrap** resampling technique. **We will only use the simpler\n",
+ "ordinary least squares here**.\n",
+ "\n",
+ "With a code which does OLS and includes resampling techniques, \n",
+ "we will now discuss the bias-variance trade-off in the context of\n",
+ "continuous predictions such as regression. However, many of the\n",
+ "intuitions and ideas discussed here also carry over to classification\n",
+ "tasks and basically all Machine Learning algorithms. \n",
+ "\n",
+ "Before you perform an analysis of the bias-variance trade-off on your\n",
+ "test data, make first a figure similar to Fig. 2.11 of Hastie,\n",
+ "Tibshirani, and Friedman. Figure 2.11 of this reference displays only\n",
+ "the test and training MSEs. The test MSE can be used to indicate\n",
+ "possible regions of low/high bias and variance. You will most likely\n",
+ "not get an equally smooth curve! You may also need to increase the\n",
+ "polynomial order and play around with the number of data points as\n",
+ "well (see also the exercise set from week 35).\n",
+ "\n",
+ "With this result we move on to the bias-variance trade-off analysis.\n",
+ "\n",
+ "Consider a\n",
+ "dataset $\\mathcal{L}$ consisting of the data\n",
+ "$\\mathbf{X}_\\mathcal{L}=\\{(y_j, \\boldsymbol{x}_j), j=0\\ldots n-1\\}$.\n",
+ "\n",
+ "We assume that the true data is generated from a noisy model"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b871ec69",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\boldsymbol{y}=f(\\boldsymbol{x}) + \\boldsymbol{\\epsilon}.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b47c19bc",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Here $\\epsilon$ is normally distributed with mean zero and standard\n",
+ "deviation $\\sigma^2$.\n",
+ "\n",
+ "In our derivation of the ordinary least squares method we defined then\n",
+ "an approximation to the function $f$ in terms of the parameters\n",
+ "$\\boldsymbol{\\theta}$ and the design matrix $\\boldsymbol{X}$ which embody our model,\n",
+ "that is $\\boldsymbol{\\tilde{y}}=\\boldsymbol{X}\\boldsymbol{\\theta}$.\n",
+ "\n",
+ "The parameters $\\boldsymbol{\\theta}$ are in turn found by optimizing the mean\n",
+ "squared error via the so-called cost function"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6db622c2",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "C(\\boldsymbol{X},\\boldsymbol{\\theta}) =\\frac{1}{n}\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2=\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right].\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "5a7eb70d",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "Here the expected value $\\mathbb{E}$ is the sample value. \n",
+ "\n",
+ "Show that you can rewrite this in terms of a term which contains the\n",
+ "variance of the model itself (the so-called variance term), a term\n",
+ "which measures the deviation from the true data and the mean value of\n",
+ "the model (the bias term) and finally the variance of the noise.\n",
+ "\n",
+ "That is, show that"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d50292fe",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathrm{Bias}[\\tilde{y}]+\\mathrm{var}[\\tilde{y}]+\\sigma^2,\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "50fa641f",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "with (we approximate $f(\\boldsymbol{x})\\approx \\boldsymbol{y}$)"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2bd429c9",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\mathrm{Bias}[\\tilde{y}]=\\mathbb{E}\\left[\\left(\\boldsymbol{y}-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]\\right)^2\\right],\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "737c2819",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "and"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "41ef92ef",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "$$\n",
+ "\\mathrm{var}[\\tilde{y}]=\\mathbb{E}\\left[\\left(\\tilde{\\boldsymbol{y}}-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]\\right)^2\\right]=\\frac{1}{n}\\sum_i(\\tilde{y}_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2.\n",
+ "$$"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b948dab0",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "**Important note**: Since the function $f(x)$ is unknown, in order to be able to evalute the bias, we replace $f(\\boldsymbol{x})$ in the expression for the bias with $\\boldsymbol{y}$. \n",
+ "\n",
+ "The answer to this exercise should be included in the theory part of\n",
+ "the report. This exercise is also part of the weekly exercises of\n",
+ "week 38. Explain what the terms mean and discuss their\n",
+ "interpretations.\n",
+ "\n",
+ "Perform then a bias-variance analysis of the Runge function by\n",
+ "studying the MSE value as function of the complexity of your model.\n",
+ "\n",
+ "Discuss the bias and variance trade-off as function\n",
+ "of your model complexity (the degree of the polynomial) and the number\n",
+ "of data points, and possibly also your training and test data using the **bootstrap** resampling method.\n",
+ "You can follow the code example in the jupyter-book at ."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6a0548bf",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "### Part h): Cross-validation as resampling techniques, adding more complexity\n",
+ "\n",
+ "The aim here is to implement another widely popular\n",
+ "resampling technique, the so-called cross-validation method. \n",
+ "\n",
+ "Implement the $k$-fold cross-validation algorithm (feel free to use\n",
+ "the functionality of **Scikit-Learn** or write your own code) and\n",
+ "evaluate again the MSE function resulting from the test folds.\n",
+ "\n",
+ "Compare the MSE you get from your cross-validation code with the one\n",
+ "you got from your **bootstrap** code from the previous exercise. Comment and interpret your results. \n",
+ "\n",
+ "In addition to using the ordinary least squares method, you should\n",
+ "include both Ridge and Lasso regression in the final analysis."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "df9845cb",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Background literature\n",
+ "\n",
+ "1. For a discussion and derivation of the variances and mean squared errors using linear regression, see the [Lecture notes on ridge regression by Wessel N. van Wieringen](https://arxiv.org/abs/1509.09169)\n",
+ "\n",
+ "2. The textbook of [Trevor Hastie, Robert Tibshirani, Jerome H. Friedman, The Elements of Statistical Learning, Springer](https://www.springer.com/gp/book/9780387848570), chapters 3 and 7 are the most relevant ones for the analysis here."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "b9e04791",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Introduction to numerical projects\n",
+ "\n",
+ "Here follows a brief recipe and recommendation on how to answer the various questions when preparing your answers. \n",
+ "\n",
+ " * Give a short description of the nature of the problem and the eventual numerical methods you have used.\n",
+ "\n",
+ " * Describe the algorithm you have used and/or developed. Here you may find it convenient to use pseudocoding. In many cases you can describe the algorithm in the program itself.\n",
+ "\n",
+ " * Include the source code of your program. Comment your program properly. You should have the code at your GitHub/GitLab link. You can also place the code in an appendix of your report.\n",
+ "\n",
+ " * If possible, try to find analytic solutions, or known limits in order to test your program when developing the code.\n",
+ "\n",
+ " * Include your results either in figure form or in a table. Remember to label your results. All tables and figures should have relevant captions and labels on the axes.\n",
+ "\n",
+ " * Try to evaluate the reliabilty and numerical stability/precision of your results. If possible, include a qualitative and/or quantitative discussion of the numerical stability, eventual loss of precision etc.\n",
+ "\n",
+ " * Try to give an interpretation of you results in your answers to the problems.\n",
+ "\n",
+ " * Critique: if possible include your comments and reflections about the exercise, whether you felt you learnt something, ideas for improvements and other thoughts you've made when solving the exercise. We wish to keep this course at the interactive level and your comments can help us improve it.\n",
+ "\n",
+ " * Try to establish a practice where you log your work at the computerlab. You may find such a logbook very handy at later stages in your work, especially when you don't properly remember what a previous test version of your program did. Here you could also record the time spent on solving the exercise, various algorithms you may have tested or other topics which you feel worthy of mentioning."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3fab6237",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Format for electronic delivery of report and programs\n",
+ "\n",
+ "The preferred format for the report is a PDF file. You can also use DOC or postscript formats or as an ipython notebook file. As programming language we prefer that you choose between C/C++, Fortran2008, Julia or Python. The following prescription should be followed when preparing the report:\n",
+ "\n",
+ " * Use Canvas to hand in your projects, log in at with your normal UiO username and password.\n",
+ "\n",
+ " * Upload **only** the report file or the link to your GitHub/GitLab or similar typo of repos! For the source code file(s) you have developed please provide us with your link to your GitHub/GitLab or similar domain. The report file should include all of your discussions and a list of the codes you have developed. Do not include library files which are available at the course homepage, unless you have made specific changes to them.\n",
+ "\n",
+ " * In your GitHub/GitLab or similar repository, please include a folder which contains selected results. These can be in the form of output from your code for a selected set of runs and input parameters.\n",
+ "\n",
+ "Finally, \n",
+ "we encourage you to collaborate. Optimal working groups consist of \n",
+ "2-3 students. You can then hand in a common report."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "3388eb60",
+ "metadata": {
+ "editable": true
+ },
+ "source": [
+ "## Software and needed installations\n",
+ "\n",
+ "If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages, \n",
+ "we recommend that you install the following Python packages via **pip** as\n",
+ "1. pip install numpy scipy matplotlib ipython scikit-learn tensorflow sympy pandas pillow\n",
+ "\n",
+ "For Python3, replace **pip** with **pip3**.\n",
+ "\n",
+ "See below for a discussion of **tensorflow** and **scikit-learn**. \n",
+ "\n",
+ "For OSX users we recommend also, after having installed Xcode, to install **brew**. Brew allows \n",
+ "for a seamless installation of additional software via for example\n",
+ "1. brew install python3\n",
+ "\n",
+ "For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution\n",
+ "you can use **pip** as well and simply install Python as \n",
+ "1. sudo apt-get install python3 (or python for python2.7)\n",
+ "\n",
+ "etc etc. \n",
+ "\n",
+ "If you don't want to install various Python packages with their dependencies separately, we recommend two widely used distrubutions which set up all relevant dependencies for Python, namely\n",
+ "1. [Anaconda](https://docs.anaconda.com/) Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system **conda**\n",
+ "\n",
+ "2. [Enthought canopy](https://www.enthought.com/product/canopy/) is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.\n",
+ "\n",
+ "Popular software packages written in Python for ML are\n",
+ "\n",
+ "* [Scikit-learn](http://scikit-learn.org/stable/), \n",
+ "\n",
+ "* [Tensorflow](https://www.tensorflow.org/),\n",
+ "\n",
+ "* [PyTorch](http://pytorch.org/) and \n",
+ "\n",
+ "* [Keras](https://keras.io/).\n",
+ "\n",
+ "These are all freely available at their respective GitHub sites. They \n",
+ "encompass communities of developers in the thousands or more. And the number\n",
+ "of code developers and contributors keeps increasing."
+ ]
+ }
+ ],
+ "metadata": {},
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/doc/src/Projects/2025/Project1/Project1.p.tex b/doc/src/Projects/2025/Project1/Project1.p.tex
new file mode 100644
index 000000000..9f28fd21a
--- /dev/null
+++ b/doc/src/Projects/2025/Project1/Project1.p.tex
@@ -0,0 +1,504 @@
+%%
+%% Automatically generated file from DocOnce source
+%% (https://github.com/doconce/doconce/)
+%% doconce format latex Project1.do.txt --print_latex_style=trac --latex_admon=paragraph
+%%
+% #ifdef PTEX2TEX_EXPLANATION
+%%
+%% The file follows the ptex2tex extended LaTeX format, see
+%% ptex2tex: https://code.google.com/p/ptex2tex/
+%%
+%% Run
+%% ptex2tex myfile
+%% or
+%% doconce ptex2tex myfile
+%%
+%% to turn myfile.p.tex into an ordinary LaTeX file myfile.tex.
+%% (The ptex2tex program: https://code.google.com/p/ptex2tex)
+%% Many preprocess options can be added to ptex2tex or doconce ptex2tex
+%%
+%% ptex2tex -DMINTED myfile
+%% doconce ptex2tex myfile envir=minted
+%%
+%% ptex2tex will typeset code environments according to a global or local
+%% .ptex2tex.cfg configure file. doconce ptex2tex will typeset code
+%% according to options on the command line (just type doconce ptex2tex to
+%% see examples). If doconce ptex2tex has envir=minted, it enables the
+%% minted style without needing -DMINTED.
+% #endif
+
+% #define PREAMBLE
+
+% #ifdef PREAMBLE
+%-------------------- begin preamble ----------------------
+
+\documentclass[%
+oneside, % oneside: electronic viewing, twoside: printing
+final, % draft: marks overfull hboxes, figures with paths
+10pt]{article}
+
+\listfiles % print all files needed to compile this document
+
+\usepackage{relsize,makeidx,color,setspace,amsmath,amsfonts,amssymb}
+\usepackage[table]{xcolor}
+\usepackage{bm,ltablex,microtype}
+
+\usepackage[pdftex]{graphicx}
+
+\usepackage[T1]{fontenc}
+%\usepackage[latin1]{inputenc}
+\usepackage{ucs}
+\usepackage[utf8x]{inputenc}
+
+\usepackage{lmodern} % Latin Modern fonts derived from Computer Modern
+
+% Hyperlinks in PDF:
+\definecolor{linkcolor}{rgb}{0,0,0.4}
+\usepackage{hyperref}
+\hypersetup{
+ breaklinks=true,
+ colorlinks=true,
+ linkcolor=linkcolor,
+ urlcolor=linkcolor,
+ citecolor=black,
+ filecolor=black,
+ %filecolor=blue,
+ pdfmenubar=true,
+ pdftoolbar=true,
+ bookmarksdepth=3 % Uncomment (and tweak) for PDF bookmarks with more levels than the TOC
+ }
+%\hyperbaseurl{} % hyperlinks are relative to this root
+
+\setcounter{tocdepth}{2} % levels in table of contents
+
+% prevent orhpans and widows
+\clubpenalty = 10000
+\widowpenalty = 10000
+
+% --- end of standard preamble for documents ---
+
+
+% insert custom LaTeX commands...
+
+\raggedbottom
+\makeindex
+\usepackage[totoc]{idxlayout} % for index in the toc
+\usepackage[nottoc]{tocbibind} % for references/bibliography in the toc
+
+%-------------------- end preamble ----------------------
+
+\begin{document}
+
+% matching end for #ifdef PREAMBLE
+% #endif
+
+\newcommand{\exercisesection}[1]{\subsection*{#1}}
+
+
+% ------------------- main content ----------------------
+
+
+
+% ----------------- title -------------------------
+
+\thispagestyle{empty}
+
+\begin{center}
+{\LARGE\bf
+\begin{spacing}{1.25}
+Project 1 on Machine Learning, deadline October 6 (midnight), 2025
+\end{spacing}
+}
+\end{center}
+
+% ----------------- author(s) -------------------------
+
+\begin{center}
+{\bf Data Analysis and Machine Learning FYS-STK3155/FYS4155}
+\end{center}
+
+ \begin{center}
+% List of all institutions:
+\centerline{{\small University of Oslo, Norway}}
+\end{center}
+
+% ----------------- end author(s) -------------------------
+
+% --- begin date ---
+\begin{center}
+September 2
+\end{center}
+% --- end date ---
+
+\vspace{1cm}
+
+
+\subsection{Preamble: Note on writing reports, using reference material, AI and other tools}
+
+We want you to answer the three different projects by handing in
+reports written like a standard scientific/technical report. The
+links at
+\href{{https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects}}{\nolinkurl{https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects}}
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
+
+When using codes and material from other sources, you should refer to
+these in the bibliography of your report, indicating wherefrom you for
+example got the code, whether this is from the lecture notes,
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
+of the libraries is often indicated from their corresponding GitHub
+sites or websites, see for example how to cite Scikit-Learn at
+\href{{https://scikit-learn.org/dev/about.html}}{\nolinkurl{https://scikit-learn.org/dev/about.html}}.
+
+We enocurage you to use tools like
+\href{{https://openai.com/chatgpt/}}{ChatGPT} or similar in writing the report. If you use for example ChatGPT,
+please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can
+be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.
+
+If you would like to study other data sets, feel free to propose other
+sets. What we have proposed here are mere suggestions from our
+side. If you opt for another data set, consider using a set which has
+been studied in the scientific literature. This makes it easier for
+you to compare and analyze your results. Comparing with existing
+results from the scientific literature is also an essential element of
+the scientific discussion. The University of California at Irvine
+with its Machine Learning repository at
+\href{{https://archive.ics.uci.edu/ml/index.php}}{\nolinkurl{https://archive.ics.uci.edu/ml/index.php}} is an excellent site to
+look up for examples and
+inspiration. \href{{https://www.kaggle.com/}}{Kaggle.com} is an equally
+interesting site. Feel free to explore these sites. When selecting
+other data sets, make sure these are sets used for regression problems
+(not classification).
+
+% !split
+\subsection{Regression analysis and resampling methods}
+
+The main aim of this project is to study in more detail various
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
+In addition to the scientific part, in this course we want also to
+give you an experience in writing scientific reports.
+
+We will study how to fit polynomials to specific
+one-dimensional functions (feel free to replace the suggested function with more complicated ones).
+
+We will use Runge's function (see \href{{https://en.wikipedia.org/wiki/Runge%27s_phenomenon}}{\nolinkurl{https://en.wikipedia.org/wiki/Runge\%27s_phenomenon}} for a discussion). The one-dimensional function we will study is
+\[
+f(x) = \frac{1}{1+25x^2}.
+\]
+
+Our first step will be to perform an OLS regression analysis of this
+function, trying out a polynomial fit with an $x$ dependence of the
+form $[x,x^2,\dots]$. You can use a uniform distribution to set up the
+arrays of values for $x \in [-1,1]$, or alternatively use a fixed step size.
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) $\lambda$.
+
+We will also include bootstrap as a resampling technique in order to
+study the so-called \textbf{bias-variance tradeoff}. After that we will
+include the so-called cross-validation technique.
+
+\paragraph{Part a : Ordinary Least Square (OLS) for the Runge function.}
+We will generate our own dataset for abovementioned function
+$\mathrm{Runge}(x)$ function with $x\in [-1,1]$. You should explore also the addition
+of an added stochastic noise to this function using the normal
+distribution $N(0,1)$.
+
+\emph{Write your own code} (using for example the pseudoinverse function \textbf{pinv} from \textbf{Numpy} ) and perform a standard \textbf{ordinary least square regression}
+analysis using polynomials in $x$ up to order $15$ or higher. Explore the dependence on the number of data points and the polynomial degree.
+
+Evaluate the mean Squared error (MSE)
+
+\[ MSE(\bm{y},\tilde{\bm{y}}) = \frac{1}{n}
+\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2,
+\]
+
+and the $R^2$ score function. If $\tilde{\bm{y}}_i$ is the predicted
+value of the $i-th$ sample and $y_i$ is the corresponding true value,
+then the score $R^2$ is defined as
+
+\[
+R^2(\bm{y}, \tilde{\bm{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2},
+\]
+
+where we have defined the mean value of $\bm{y}$ as
+
+\[
+\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i.
+\]
+
+Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
+Plot also the parameters $\theta$ as you increase the order of the polynomial. Comment your results.
+
+Your code has to include a scaling/centering of the data (for example by
+subtracting the mean value), and
+a split of the data in training and test data. For the scaling you can
+either write your own code or use for example the function for
+splitting training data provided by the library \textbf{Scikit-Learn} (make
+sure you have installed it). This function is called
+$train\_test\_split$. \textbf{You should present a critical discussion of why and how you have scaled or not scaled the data}.
+
+It is normal in essentially all Machine Learning studies to split the
+data in a training set and a test set (eventually also an additional
+validation set). There
+is no explicit recipe for how much data should be included as training
+data and say test data. An accepted rule of thumb is to use
+approximately $2/3$ to $4/5$ of the data as training data.
+
+You can easily reuse the solutions to your exercises from week 35.
+See also the lecture slides from week 35 and week 36.
+
+On scaling, we recommend reading the following section from the scikit-learn software description, see \href{{https://scikit-learn.org/stable/auto_examples/preprocessing/plot_all_scaling.html#plot-all-scaling-standard-scaler-section}}{\nolinkurl{https://scikit-learn.org/stable/auto_examples/preprocessing/plot_all_scaling.html\#plot-all-scaling-standard-scaler-section}}.
+
+\paragraph{Part b: Adding Ridge regression for the Runge function.}
+Write your own code for the Ridge method as done in the previous
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
+
+Perform the same analysis as you did in the previous exercise but now for different values of $\lambda$. Compare and
+analyze your results with those obtained in part a) with the OLS method. Study the
+dependence on $\lambda$.
+
+\paragraph{Part c: Writing your own gradient descent code.}
+Replace now the analytical expressions for the optimal parameters
+$\bm{\theta}$ with your own gradient descent code. In this exercise we
+focus only on the simplest gradient descent approach with a fixed
+learning rate (see the exercises from week 37 and the lecture notes
+from week 36).
+
+Study and compare your results from parts a) and b) with your gradient
+descent approch. Discuss in particular the role of the learning rate.
+
+\paragraph{Part d: Including momentum and more advanced ways to update the learning the rate.}
+We keep our focus on OLS and Ridge regression and update our code for
+the gradient descent method by including \textbf{momentum}, \textbf{ADAgrad},
+\textbf{RMSprop} and \textbf{ADAM} as methods fro iteratively updating your learning
+rate. Discuss the results and compare the different methods applied to
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
+
+\paragraph{Part e: Writing our own code for Lasso regression.}
+LASSO regression (see lecture slides from week 36 and week 37)
+represents our first encounter with a machine learning method which
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
+descent methods you developed in parts c) and d) to solve the LASSO
+optimization problem. You can compare your results with
+the functionalities of \textbf{Scikit-Learn}.
+
+Discuss (critically) your results for the Runge function from OLS,
+Ridge and LASSO regression using the various gradient descent
+approaches.
+
+\paragraph{Part f: Stochastic gradient descent.}
+Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
+
+\paragraph{Part g: Bias-variance trade-off and resampling techniques.}
+Our aim here is to study the bias-variance trade-off by implementing
+the \textbf{bootstrap} resampling technique. \textbf{We will only use the simpler
+ordinary least squares here}.
+
+With a code which does OLS and includes resampling techniques,
+we will now discuss the bias-variance trade-off in the context of
+continuous predictions such as regression. However, many of the
+intuitions and ideas discussed here also carry over to classification
+tasks and basically all Machine Learning algorithms.
+
+Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig.~2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
+
+With this result we move on to the bias-variance trade-off analysis.
+
+Consider a
+dataset $\mathcal{L}$ consisting of the data
+$\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}$.
+
+We assume that the true data is generated from a noisy model
+
+\[
+\bm{y}=f(\boldsymbol{x}) + \bm{\epsilon}.
+\]
+
+Here $\epsilon$ is normally distributed with mean zero and standard
+deviation $\sigma^2$.
+
+In our derivation of the ordinary least squares method we defined then
+an approximation to the function $f$ in terms of the parameters
+$\bm{\theta}$ and the design matrix $\bm{X}$ which embody our model,
+that is $\bm{\tilde{y}}=\bm{X}\bm{\theta}$.
+
+The parameters $\bm{\theta}$ are in turn found by optimizing the mean
+squared error via the so-called cost function
+
+\[
+C(\bm{X},\bm{\theta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right].
+\]
+Here the expected value $\mathbb{E}$ is the sample value.
+
+Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
+
+That is, show that
+\[
+\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\mathrm{Bias}[\tilde{y}]+\mathrm{var}[\tilde{y}]+\sigma^2,
+\]
+with (we approximate $f(\bm{x})\approx \bm{y}$)
+\[
+\mathrm{Bias}[\tilde{y}]=\mathbb{E}\left[\left(\bm{y}-\mathbb{E}\left[\bm{\tilde{y}}\right]\right)^2\right],
+\]
+and
+\[
+\mathrm{var}[\tilde{y}]=\mathbb{E}\left[\left(\tilde{\bm{y}}-\mathbb{E}\left[\bm{\tilde{y}}\right]\right)^2\right]=\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\bm{\tilde{y}}\right])^2.
+\]
+
+\textbf{Important note}: Since the function $f(x)$ is unknown, in order to be able to evalute the bias, we replace $f(\bm{x})$ in the expression for the bias with $\bm{y}$.
+
+The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
+
+Perform then a bias-variance analysis of the Runge function by
+studying the MSE value as function of the complexity of your model.
+
+Discuss the bias and variance trade-off as function
+of your model complexity (the degree of the polynomial) and the number
+of data points, and possibly also your training and test data using the \textbf{bootstrap} resampling method.
+You can follow the code example in the jupyter-book at \href{{https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/chapter3.html#the-bias-variance-tradeoff}}{\nolinkurl{https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/chapter3.html\#the-bias-variance-tradeoff}}.
+
+\paragraph{Part h): Cross-validation as resampling techniques, adding more complexity.}
+The aim here is to implement another widely popular
+resampling technique, the so-called cross-validation method.
+
+Implement the $k$-fold cross-validation algorithm (feel free to use
+the functionality of \textbf{Scikit-Learn} or write your own code) and
+evaluate again the MSE function resulting from the test folds.
+
+Compare the MSE you get from your cross-validation code with the one
+you got from your \textbf{bootstrap} code from the previous exercise. Comment and interpret your results.
+
+In addition to using the ordinary least squares method, you should
+include both Ridge and Lasso regression in the final analysis.
+
+\subsection{Background literature}
+
+\begin{enumerate}
+\item For a discussion and derivation of the variances and mean squared errors using linear regression, see the \href{{https://arxiv.org/abs/1509.09169}}{Lecture notes on ridge regression by Wessel N. van Wieringen}
+
+\item The textbook of \href{{https://www.springer.com/gp/book/9780387848570}}{Trevor Hastie, Robert Tibshirani, Jerome H. Friedman, The Elements of Statistical Learning, Springer}, chapters 3 and 7 are the most relevant ones for the analysis here.
+\end{enumerate}
+
+\noindent
+\subsection{Introduction to numerical projects}
+
+Here follows a brief recipe and recommendation on how to answer the various questions when preparing your answers.
+
+\begin{itemize}
+ \item Give a short description of the nature of the problem and the eventual numerical methods you have used.
+
+ \item Describe the algorithm you have used and/or developed. Here you may find it convenient to use pseudocoding. In many cases you can describe the algorithm in the program itself.
+
+ \item Include the source code of your program. Comment your program properly. You should have the code at your GitHub/GitLab link. You can also place the code in an appendix of your report.
+
+ \item If possible, try to find analytic solutions, or known limits in order to test your program when developing the code.
+
+ \item Include your results either in figure form or in a table. Remember to label your results. All tables and figures should have relevant captions and labels on the axes.
+
+ \item Try to evaluate the reliabilty and numerical stability/precision of your results. If possible, include a qualitative and/or quantitative discussion of the numerical stability, eventual loss of precision etc.
+
+ \item Try to give an interpretation of you results in your answers to the problems.
+
+ \item Critique: if possible include your comments and reflections about the exercise, whether you felt you learnt something, ideas for improvements and other thoughts you've made when solving the exercise. We wish to keep this course at the interactive level and your comments can help us improve it.
+
+ \item Try to establish a practice where you log your work at the computerlab. You may find such a logbook very handy at later stages in your work, especially when you don't properly remember what a previous test version of your program did. Here you could also record the time spent on solving the exercise, various algorithms you may have tested or other topics which you feel worthy of mentioning.
+\end{itemize}
+
+\noindent
+\subsection{Format for electronic delivery of report and programs}
+
+The preferred format for the report is a PDF file. You can also use DOC or postscript formats or as an ipython notebook file. As programming language we prefer that you choose between C/C++, Fortran2008, Julia or Python. The following prescription should be followed when preparing the report:
+
+\begin{itemize}
+ \item Use Canvas to hand in your projects, log in at \href{{https://www.uio.no/english/services/it/education/canvas/}}{\nolinkurl{https://www.uio.no/english/services/it/education/canvas/}} with your normal UiO username and password.
+
+ \item Upload \textbf{only} the report file or the link to your GitHub/GitLab or similar typo of repos! For the source code file(s) you have developed please provide us with your link to your GitHub/GitLab or similar domain. The report file should include all of your discussions and a list of the codes you have developed. Do not include library files which are available at the course homepage, unless you have made specific changes to them.
+
+ \item In your GitHub/GitLab or similar repository, please include a folder which contains selected results. These can be in the form of output from your code for a selected set of runs and input parameters.
+\end{itemize}
+
+\noindent
+Finally,
+we encourage you to collaborate. Optimal working groups consist of
+2-3 students. You can then hand in a common report.
+
+\subsection{Software and needed installations}
+
+If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages,
+we recommend that you install the following Python packages via \textbf{pip} as
+\begin{enumerate}
+\item pip install numpy scipy matplotlib ipython scikit-learn tensorflow sympy pandas pillow
+\end{enumerate}
+
+\noindent
+For Python3, replace \textbf{pip} with \textbf{pip3}.
+
+See below for a discussion of \textbf{tensorflow} and \textbf{scikit-learn}.
+
+For OSX users we recommend also, after having installed Xcode, to install \textbf{brew}. Brew allows
+for a seamless installation of additional software via for example
+\begin{enumerate}
+\item brew install python3
+\end{enumerate}
+
+\noindent
+For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution
+you can use \textbf{pip} as well and simply install Python as
+\begin{enumerate}
+\item sudo apt-get install python3 (or python for python2.7)
+\end{enumerate}
+
+\noindent
+etc etc.
+
+If you don't want to install various Python packages with their dependencies separately, we recommend two widely used distrubutions which set up all relevant dependencies for Python, namely
+\begin{enumerate}
+\item \href{{https://docs.anaconda.com/}}{Anaconda} Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system \textbf{conda}
+
+\item \href{{https://www.enthought.com/product/canopy/}}{Enthought canopy} is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.
+\end{enumerate}
+
+\noindent
+Popular software packages written in Python for ML are
+
+\begin{itemize}
+\item \href{{http://scikit-learn.org/stable/}}{Scikit-learn},
+
+\item \href{{https://www.tensorflow.org/}}{Tensorflow},
+
+\item \href{{http://pytorch.org/}}{PyTorch} and
+
+\item \href{{https://keras.io/}}{Keras}.
+\end{itemize}
+
+\noindent
+These are all freely available at their respective GitHub sites. They
+encompass communities of developers in the thousands or more. And the number
+of code developers and contributors keeps increasing.
+
+
+% ------------------- end of main content ---------------
+
+% #ifdef PREAMBLE
+\end{document}
+% #endif
+
diff --git a/doc/src/Projects/2025/Project1/Project1.tex b/doc/src/Projects/2025/Project1/Project1.tex
new file mode 100644
index 000000000..2c142582b
--- /dev/null
+++ b/doc/src/Projects/2025/Project1/Project1.tex
@@ -0,0 +1,476 @@
+%%
+%% Automatically generated file from DocOnce source
+%% (https://github.com/doconce/doconce/)
+%% doconce format latex Project1.do.txt --print_latex_style=trac --latex_admon=paragraph
+%%
+
+
+%-------------------- begin preamble ----------------------
+
+\documentclass[%
+oneside, % oneside: electronic viewing, twoside: printing
+final, % draft: marks overfull hboxes, figures with paths
+10pt]{article}
+
+\listfiles % print all files needed to compile this document
+
+\usepackage{relsize,makeidx,color,setspace,amsmath,amsfonts,amssymb}
+\usepackage[table]{xcolor}
+\usepackage{bm,ltablex,microtype}
+
+\usepackage[pdftex]{graphicx}
+
+\usepackage[T1]{fontenc}
+%\usepackage[latin1]{inputenc}
+\usepackage{ucs}
+\usepackage[utf8x]{inputenc}
+
+\usepackage{lmodern} % Latin Modern fonts derived from Computer Modern
+
+% Hyperlinks in PDF:
+\definecolor{linkcolor}{rgb}{0,0,0.4}
+\usepackage{hyperref}
+\hypersetup{
+ breaklinks=true,
+ colorlinks=true,
+ linkcolor=linkcolor,
+ urlcolor=linkcolor,
+ citecolor=black,
+ filecolor=black,
+ %filecolor=blue,
+ pdfmenubar=true,
+ pdftoolbar=true,
+ bookmarksdepth=3 % Uncomment (and tweak) for PDF bookmarks with more levels than the TOC
+ }
+%\hyperbaseurl{} % hyperlinks are relative to this root
+
+\setcounter{tocdepth}{2} % levels in table of contents
+
+% prevent orhpans and widows
+\clubpenalty = 10000
+\widowpenalty = 10000
+
+% --- end of standard preamble for documents ---
+
+
+% insert custom LaTeX commands...
+
+\raggedbottom
+\makeindex
+\usepackage[totoc]{idxlayout} % for index in the toc
+\usepackage[nottoc]{tocbibind} % for references/bibliography in the toc
+
+%-------------------- end preamble ----------------------
+
+\begin{document}
+
+% matching end for #ifdef PREAMBLE
+
+\newcommand{\exercisesection}[1]{\subsection*{#1}}
+
+
+% ------------------- main content ----------------------
+
+
+
+% ----------------- title -------------------------
+
+\thispagestyle{empty}
+
+\begin{center}
+{\LARGE\bf
+\begin{spacing}{1.25}
+Project 1 on Machine Learning, deadline October 6 (midnight), 2025
+\end{spacing}
+}
+\end{center}
+
+% ----------------- author(s) -------------------------
+
+\begin{center}
+{\bf Data Analysis and Machine Learning FYS-STK3155/FYS4155}
+\end{center}
+
+ \begin{center}
+% List of all institutions:
+\centerline{{\small University of Oslo, Norway}}
+\end{center}
+
+% ----------------- end author(s) -------------------------
+
+% --- begin date ---
+\begin{center}
+September 2
+\end{center}
+% --- end date ---
+
+\vspace{1cm}
+
+
+\subsection*{Preamble: Note on writing reports, using reference material, AI and other tools}
+
+We want you to answer the three different projects by handing in
+reports written like a standard scientific/technical report. The
+links at
+\href{{https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects}}{\nolinkurl{https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects}}
+contain more information. There you can find examples of previous
+reports, the projects themselves, how we rade reports etc. How to
+write reports will also be discussed during the various lab
+sessions. Please do ask us if you are in doubt.
+
+When using codes and material from other sources, you should refer to
+these in the bibliography of your report, indicating wherefrom you for
+example got the code, whether this is from the lecture notes,
+softwares like Scikit-Learn, TensorFlow, PyTorch or other sources. These sources
+should always be cited correctly. How to cite some
+of the libraries is often indicated from their corresponding GitHub
+sites or websites, see for example how to cite Scikit-Learn at
+\href{{https://scikit-learn.org/dev/about.html}}{\nolinkurl{https://scikit-learn.org/dev/about.html}}.
+
+We enocurage you to use tools like
+\href{{https://openai.com/chatgpt/}}{ChatGPT} or similar in writing the report. If you use for example ChatGPT,
+please do cite it properly and include (if possible) your questions and answers as an addition to the report. This can
+be uploaded to for example your website, GitHub/GitLab or similar as supplemental material.
+
+If you would like to study other data sets, feel free to propose other
+sets. What we have proposed here are mere suggestions from our
+side. If you opt for another data set, consider using a set which has
+been studied in the scientific literature. This makes it easier for
+you to compare and analyze your results. Comparing with existing
+results from the scientific literature is also an essential element of
+the scientific discussion. The University of California at Irvine
+with its Machine Learning repository at
+\href{{https://archive.ics.uci.edu/ml/index.php}}{\nolinkurl{https://archive.ics.uci.edu/ml/index.php}} is an excellent site to
+look up for examples and
+inspiration. \href{{https://www.kaggle.com/}}{Kaggle.com} is an equally
+interesting site. Feel free to explore these sites. When selecting
+other data sets, make sure these are sets used for regression problems
+(not classification).
+
+% !split
+\subsection*{Regression analysis and resampling methods}
+
+The main aim of this project is to study in more detail various
+regression methods, including Ordinary Least Squares (OLS) reegression, Ridge regression and LASSO regression.
+In addition to the scientific part, in this course we want also to
+give you an experience in writing scientific reports.
+
+We will study how to fit polynomials to specific
+one-dimensional functions (feel free to replace the suggested function with more complicated ones).
+
+We will use Runge's function (see \href{{https://en.wikipedia.org/wiki/Runge%27s_phenomenon}}{\nolinkurl{https://en.wikipedia.org/wiki/Runge\%27s_phenomenon}} for a discussion). The one-dimensional function we will study is
+\[
+f(x) = \frac{1}{1+25x^2}.
+\]
+
+Our first step will be to perform an OLS regression analysis of this
+function, trying out a polynomial fit with an $x$ dependence of the
+form $[x,x^2,\dots]$. You can use a uniform distribution to set up the
+arrays of values for $x \in [-1,1]$, or alternatively use a fixed step size.
+Thereafter we will repeat many of the same steps when using the Ridge and Lasso regression methods,
+introducing thereby a dependence on the hyperparameter (penalty) $\lambda$.
+
+We will also include bootstrap as a resampling technique in order to
+study the so-called \textbf{bias-variance tradeoff}. After that we will
+include the so-called cross-validation technique.
+
+\paragraph{Part a : Ordinary Least Square (OLS) for the Runge function.}
+We will generate our own dataset for abovementioned function
+$\mathrm{Runge}(x)$ function with $x\in [-1,1]$. You should explore also the addition
+of an added stochastic noise to this function using the normal
+distribution $N(0,1)$.
+
+\emph{Write your own code} (using for example the pseudoinverse function \textbf{pinv} from \textbf{Numpy} ) and perform a standard \textbf{ordinary least square regression}
+analysis using polynomials in $x$ up to order $15$ or higher. Explore the dependence on the number of data points and the polynomial degree.
+
+Evaluate the mean Squared error (MSE)
+
+\[ MSE(\bm{y},\tilde{\bm{y}}) = \frac{1}{n}
+\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2,
+\]
+
+and the $R^2$ score function. If $\tilde{\bm{y}}_i$ is the predicted
+value of the $i-th$ sample and $y_i$ is the corresponding true value,
+then the score $R^2$ is defined as
+
+\[
+R^2(\bm{y}, \tilde{\bm{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2},
+\]
+
+where we have defined the mean value of $\bm{y}$ as
+
+\[
+\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i.
+\]
+
+Plot the resulting scores (MSE and R$^2$) as functions of the polynomial degree (here up to polymial degree 15).
+Plot also the parameters $\theta$ as you increase the order of the polynomial. Comment your results.
+
+Your code has to include a scaling/centering of the data (for example by
+subtracting the mean value), and
+a split of the data in training and test data. For the scaling you can
+either write your own code or use for example the function for
+splitting training data provided by the library \textbf{Scikit-Learn} (make
+sure you have installed it). This function is called
+$train\_test\_split$. \textbf{You should present a critical discussion of why and how you have scaled or not scaled the data}.
+
+It is normal in essentially all Machine Learning studies to split the
+data in a training set and a test set (eventually also an additional
+validation set). There
+is no explicit recipe for how much data should be included as training
+data and say test data. An accepted rule of thumb is to use
+approximately $2/3$ to $4/5$ of the data as training data.
+
+You can easily reuse the solutions to your exercises from week 35.
+See also the lecture slides from week 35 and week 36.
+
+On scaling, we recommend reading the following section from the scikit-learn software description, see \href{{https://scikit-learn.org/stable/auto_examples/preprocessing/plot_all_scaling.html#plot-all-scaling-standard-scaler-section}}{\nolinkurl{https://scikit-learn.org/stable/auto_examples/preprocessing/plot_all_scaling.html\#plot-all-scaling-standard-scaler-section}}.
+
+\paragraph{Part b: Adding Ridge regression for the Runge function.}
+Write your own code for the Ridge method as done in the previous
+exercise. The lecture notes from week 35 and 36 contain more information. Furthermore, the results from the exercise set from week 36 is something you can reuse here.
+
+Perform the same analysis as you did in the previous exercise but now for different values of $\lambda$. Compare and
+analyze your results with those obtained in part a) with the OLS method. Study the
+dependence on $\lambda$.
+
+\paragraph{Part c: Writing your own gradient descent code.}
+Replace now the analytical expressions for the optimal parameters
+$\bm{\theta}$ with your own gradient descent code. In this exercise we
+focus only on the simplest gradient descent approach with a fixed
+learning rate (see the exercises from week 37 and the lecture notes
+from week 36).
+
+Study and compare your results from parts a) and b) with your gradient
+descent approch. Discuss in particular the role of the learning rate.
+
+\paragraph{Part d: Including momentum and more advanced ways to update the learning the rate.}
+We keep our focus on OLS and Ridge regression and update our code for
+the gradient descent method by including \textbf{momentum}, \textbf{ADAgrad},
+\textbf{RMSprop} and \textbf{ADAM} as methods fro iteratively updating your learning
+rate. Discuss the results and compare the different methods applied to
+the one-dimensional Runge function. The lecture notes from week 37 contain several examples on how to implement these methods.
+
+\paragraph{Part e: Writing our own code for Lasso regression.}
+LASSO regression (see lecture slides from week 36 and week 37)
+represents our first encounter with a machine learning method which
+cannot be solved through analytical expressions (as in OLS and Ridge regression). Use the gradient
+descent methods you developed in parts c) and d) to solve the LASSO
+optimization problem. You can compare your results with
+the functionalities of \textbf{Scikit-Learn}.
+
+Discuss (critically) your results for the Runge function from OLS,
+Ridge and LASSO regression using the various gradient descent
+approaches.
+
+\paragraph{Part f: Stochastic gradient descent.}
+Our last gradient step is to include stochastic gradient descent using
+the same methods to update the learning rates as in parts c-e).
+Compare and discuss your results with and without stochastic gradient
+and give a critical assessment of the various methods.
+
+\paragraph{Part g: Bias-variance trade-off and resampling techniques.}
+Our aim here is to study the bias-variance trade-off by implementing
+the \textbf{bootstrap} resampling technique. \textbf{We will only use the simpler
+ordinary least squares here}.
+
+With a code which does OLS and includes resampling techniques,
+we will now discuss the bias-variance trade-off in the context of
+continuous predictions such as regression. However, many of the
+intuitions and ideas discussed here also carry over to classification
+tasks and basically all Machine Learning algorithms.
+
+Before you perform an analysis of the bias-variance trade-off on your
+test data, make first a figure similar to Fig.~2.11 of Hastie,
+Tibshirani, and Friedman. Figure 2.11 of this reference displays only
+the test and training MSEs. The test MSE can be used to indicate
+possible regions of low/high bias and variance. You will most likely
+not get an equally smooth curve! You may also need to increase the
+polynomial order and play around with the number of data points as
+well (see also the exercise set from week 35).
+
+With this result we move on to the bias-variance trade-off analysis.
+
+Consider a
+dataset $\mathcal{L}$ consisting of the data
+$\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}$.
+
+We assume that the true data is generated from a noisy model
+
+\[
+\bm{y}=f(\boldsymbol{x}) + \bm{\epsilon}.
+\]
+
+Here $\epsilon$ is normally distributed with mean zero and standard
+deviation $\sigma^2$.
+
+In our derivation of the ordinary least squares method we defined then
+an approximation to the function $f$ in terms of the parameters
+$\bm{\theta}$ and the design matrix $\bm{X}$ which embody our model,
+that is $\bm{\tilde{y}}=\bm{X}\bm{\theta}$.
+
+The parameters $\bm{\theta}$ are in turn found by optimizing the mean
+squared error via the so-called cost function
+
+\[
+C(\bm{X},\bm{\theta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right].
+\]
+Here the expected value $\mathbb{E}$ is the sample value.
+
+Show that you can rewrite this in terms of a term which contains the
+variance of the model itself (the so-called variance term), a term
+which measures the deviation from the true data and the mean value of
+the model (the bias term) and finally the variance of the noise.
+
+That is, show that
+\[
+\mathbb{E}\left[(\bm{y}-\bm{\tilde{y}})^2\right]=\mathrm{Bias}[\tilde{y}]+\mathrm{var}[\tilde{y}]+\sigma^2,
+\]
+with (we approximate $f(\bm{x})\approx \bm{y}$)
+\[
+\mathrm{Bias}[\tilde{y}]=\mathbb{E}\left[\left(\bm{y}-\mathbb{E}\left[\bm{\tilde{y}}\right]\right)^2\right],
+\]
+and
+\[
+\mathrm{var}[\tilde{y}]=\mathbb{E}\left[\left(\tilde{\bm{y}}-\mathbb{E}\left[\bm{\tilde{y}}\right]\right)^2\right]=\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\bm{\tilde{y}}\right])^2.
+\]
+
+\textbf{Important note}: Since the function $f(x)$ is unknown, in order to be able to evalute the bias, we replace $f(\bm{x})$ in the expression for the bias with $\bm{y}$.
+
+The answer to this exercise should be included in the theory part of
+the report. This exercise is also part of the weekly exercises of
+week 38. Explain what the terms mean and discuss their
+interpretations.
+
+Perform then a bias-variance analysis of the Runge function by
+studying the MSE value as function of the complexity of your model.
+
+Discuss the bias and variance trade-off as function
+of your model complexity (the degree of the polynomial) and the number
+of data points, and possibly also your training and test data using the \textbf{bootstrap} resampling method.
+You can follow the code example in the jupyter-book at \href{{https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/chapter3.html#the-bias-variance-tradeoff}}{\nolinkurl{https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/chapter3.html\#the-bias-variance-tradeoff}}.
+
+\paragraph{Part h): Cross-validation as resampling techniques, adding more complexity.}
+The aim here is to implement another widely popular
+resampling technique, the so-called cross-validation method.
+
+Implement the $k$-fold cross-validation algorithm (feel free to use
+the functionality of \textbf{Scikit-Learn} or write your own code) and
+evaluate again the MSE function resulting from the test folds.
+
+Compare the MSE you get from your cross-validation code with the one
+you got from your \textbf{bootstrap} code from the previous exercise. Comment and interpret your results.
+
+In addition to using the ordinary least squares method, you should
+include both Ridge and Lasso regression in the final analysis.
+
+\subsection*{Background literature}
+
+\begin{enumerate}
+\item For a discussion and derivation of the variances and mean squared errors using linear regression, see the \href{{https://arxiv.org/abs/1509.09169}}{Lecture notes on ridge regression by Wessel N. van Wieringen}
+
+\item The textbook of \href{{https://www.springer.com/gp/book/9780387848570}}{Trevor Hastie, Robert Tibshirani, Jerome H. Friedman, The Elements of Statistical Learning, Springer}, chapters 3 and 7 are the most relevant ones for the analysis here.
+\end{enumerate}
+
+\noindent
+\subsection*{Introduction to numerical projects}
+
+Here follows a brief recipe and recommendation on how to answer the various questions when preparing your answers.
+
+\begin{itemize}
+ \item Give a short description of the nature of the problem and the eventual numerical methods you have used.
+
+ \item Describe the algorithm you have used and/or developed. Here you may find it convenient to use pseudocoding. In many cases you can describe the algorithm in the program itself.
+
+ \item Include the source code of your program. Comment your program properly. You should have the code at your GitHub/GitLab link. You can also place the code in an appendix of your report.
+
+ \item If possible, try to find analytic solutions, or known limits in order to test your program when developing the code.
+
+ \item Include your results either in figure form or in a table. Remember to label your results. All tables and figures should have relevant captions and labels on the axes.
+
+ \item Try to evaluate the reliabilty and numerical stability/precision of your results. If possible, include a qualitative and/or quantitative discussion of the numerical stability, eventual loss of precision etc.
+
+ \item Try to give an interpretation of you results in your answers to the problems.
+
+ \item Critique: if possible include your comments and reflections about the exercise, whether you felt you learnt something, ideas for improvements and other thoughts you've made when solving the exercise. We wish to keep this course at the interactive level and your comments can help us improve it.
+
+ \item Try to establish a practice where you log your work at the computerlab. You may find such a logbook very handy at later stages in your work, especially when you don't properly remember what a previous test version of your program did. Here you could also record the time spent on solving the exercise, various algorithms you may have tested or other topics which you feel worthy of mentioning.
+\end{itemize}
+
+\noindent
+\subsection*{Format for electronic delivery of report and programs}
+
+The preferred format for the report is a PDF file. You can also use DOC or postscript formats or as an ipython notebook file. As programming language we prefer that you choose between C/C++, Fortran2008, Julia or Python. The following prescription should be followed when preparing the report:
+
+\begin{itemize}
+ \item Use Canvas to hand in your projects, log in at \href{{https://www.uio.no/english/services/it/education/canvas/}}{\nolinkurl{https://www.uio.no/english/services/it/education/canvas/}} with your normal UiO username and password.
+
+ \item Upload \textbf{only} the report file or the link to your GitHub/GitLab or similar typo of repos! For the source code file(s) you have developed please provide us with your link to your GitHub/GitLab or similar domain. The report file should include all of your discussions and a list of the codes you have developed. Do not include library files which are available at the course homepage, unless you have made specific changes to them.
+
+ \item In your GitHub/GitLab or similar repository, please include a folder which contains selected results. These can be in the form of output from your code for a selected set of runs and input parameters.
+\end{itemize}
+
+\noindent
+Finally,
+we encourage you to collaborate. Optimal working groups consist of
+2-3 students. You can then hand in a common report.
+
+\subsection*{Software and needed installations}
+
+If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages,
+we recommend that you install the following Python packages via \textbf{pip} as
+\begin{enumerate}
+\item pip install numpy scipy matplotlib ipython scikit-learn tensorflow sympy pandas pillow
+\end{enumerate}
+
+\noindent
+For Python3, replace \textbf{pip} with \textbf{pip3}.
+
+See below for a discussion of \textbf{tensorflow} and \textbf{scikit-learn}.
+
+For OSX users we recommend also, after having installed Xcode, to install \textbf{brew}. Brew allows
+for a seamless installation of additional software via for example
+\begin{enumerate}
+\item brew install python3
+\end{enumerate}
+
+\noindent
+For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution
+you can use \textbf{pip} as well and simply install Python as
+\begin{enumerate}
+\item sudo apt-get install python3 (or python for python2.7)
+\end{enumerate}
+
+\noindent
+etc etc.
+
+If you don't want to install various Python packages with their dependencies separately, we recommend two widely used distrubutions which set up all relevant dependencies for Python, namely
+\begin{enumerate}
+\item \href{{https://docs.anaconda.com/}}{Anaconda} Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system \textbf{conda}
+
+\item \href{{https://www.enthought.com/product/canopy/}}{Enthought canopy} is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.
+\end{enumerate}
+
+\noindent
+Popular software packages written in Python for ML are
+
+\begin{itemize}
+\item \href{{http://scikit-learn.org/stable/}}{Scikit-learn},
+
+\item \href{{https://www.tensorflow.org/}}{Tensorflow},
+
+\item \href{{http://pytorch.org/}}{PyTorch} and
+
+\item \href{{https://keras.io/}}{Keras}.
+\end{itemize}
+
+\noindent
+These are all freely available at their respective GitHub sites. They
+encompass communities of developers in the thousands or more. And the number
+of code developers and contributors keeps increasing.
+
+
+% ------------------- end of main content ---------------
+
+\end{document}
+
diff --git a/doc/src/Projects/2025/Project1/README.txt b/doc/src/Projects/2025/Project1/README.txt
new file mode 100644
index 000000000..08cc9f17c
--- /dev/null
+++ b/doc/src/Projects/2025/Project1/README.txt
@@ -0,0 +1,2 @@
+This IPython notebook Project1.ipynb does not require any additional
+programs.
diff --git a/doc/src/Projects/2025/Project1/ipynb-Project1-src.tar.gz b/doc/src/Projects/2025/Project1/ipynb-Project1-src.tar.gz
new file mode 100644
index 0000000000000000000000000000000000000000..381d472612db82325826ff4bbe577918a650b639
GIT binary patch
literal 193
zcmV;y06za8iwFSnaJFaw1MSbv3W7io2XN0m#XN!Rs;lQ94;=!DUSQ2N*K)^pSID=|
z52#boMIzYW<2ub1?rc4tyCkdB&MrjI^5ys+_L`evQMl6aw
zAnTp<(i_Y5cuHG0LK&gn&5dJK^