Initialising gh-pages branch

Author: beyondsimulations

.gitignore

@@ -0,0 +1,3 @@
+/.quarto/
+/*/.jupyter_cache/
+/*/__pycache__

.nojekyll

@@ -0,0 +1,7 @@
+---
+title: Page Not Found
+---
+
+Sorry, the page you requested cannot be found (perhaps it was moved or renamed).
+
+You may want to try searching to find the page's new location.

404.qmd

@@ -0,0 +1,32 @@
+# Introduction to Python
+
+This repository contains course materials for a "Programming with Python" course first teached at Kühne Logistics University Hamburg in Fall 2024. Most of it is written with Quarto and the corresponding website is hosted as Github page under [beyondsimulations.github.io/python-course/](https://beyondsimulations.github.io/python-course/).
+
+## Quick Overview
+
+This module introduces programming with Python over the course of 13 weeks. It is aimed at beginners with no prior programming experience. The course is based on many examples that illustrate how to tackle potentially complex issues and implement solutions.
+
+### Course Structure
+
+The course is structured into three main parts:
+
+1. **Part I: Introduction to Programming with Python**
+   - Basic concepts, syntax, data types, control structures, functions, and object classes
+
+2. **Part II: Data Science with Python**
+   - Data manipulation, descriptive and explorative analysis, visualization
+
+3. **Part III: Programming Projects**
+   - Application of knowledge in group projects
+
+For more detailed information about the course structure, lectures, and content, please refer to the [syllabus](general/syllabus.qmd).
+
+## Contact
+
+If you have any questions regarding the course, please contact:
+
+[[email protected]](mailto:[email protected]?subject=Programming%20with%20Python%20-%20KLU24%3A%20%3CYour%20subject%3E)
+
+## Contributors
+
+Thanks to [Phillip Bach](https://github.com/PhilippBach) whose original course material laid the foundation for this course.

LICENSE

@@ -0,0 +1,115 @@
+project:
+  type: website
+  output-dir: docs
+
+  render:
+  - 404.qmd
+  - index.qmd
+  - general/*.qmd
+  - part-01/*.qmd
+  - part-02/*.qmd
+  - part-03/*.qmd
+  - part-04/*.qmd
+  - part-05/*.qmd
+  - part-06/*.qmd
+  - part-07/*.qmd
+  - part-10/*.qmd
+  - assignments/*.qmd
+
+website:
+  title: "Programming with Python"
+  repo-url: https://github.com/beyondsimulations/Introduction-to-Python
+  site-url: https://beyondsimulations.github.io/Introduction-to-Python
+  repo-actions: [edit, source, issue]
+  bread-crumbs: true
+  reader-mode: true
+  sidebar:
+    style: floating
+    collapse-level: 1 
+    search: true
+    contents:
+      - text: "Welcome"
+        href: index.qmd
+      - text: "Syllabus"
+        href: general/syllabus.qmd
+      - text: "***"
+      - section: "01 Introduction "
+        contents:
+          - text: "Lecture"
+            href: part-01/lecture-introduction.qmd
+          - text: "Tutorial"
+            href: part-01/tutorial-introduction.qmd
+      - section: "02 Control Flow"
+        contents:
+          - text: "Lecture"
+            href: part-02/lecture-control.qmd
+          - text: "Tutorial"
+            href: part-02/tutorial-control.qmd
+      - section: "03 Functions"
+        contents:
+          - text: "Lecture"
+            href: part-03/lecture-functions.qmd
+          - text: "Tutorial"
+            href: part-03/tutorial-functions.qmd
+      - section: "04 Dimensions"
+        contents:
+          - text: "Lecture"
+            href: part-04/lecture-dimensions.qmd
+          - text: "Tutorial"
+            href: part-04/tutorial-dimensions.qmd
+      - section: "05 Errors"
+        contents:
+          - text: "Lecture"
+            href: part-05/lecture-errors.qmd
+          - text: "Tutorial"
+            href: part-05/tutorial-errors.qmd
+      - section: "06 Modules"
+        contents:
+          - text: "Lecture"
+            href: part-06/lecture-modules.qmd
+          - text: "Tutorial"
+            href: part-06/tutorial-modules.qmd
+      - section: "07 Scientific Computing"
+        contents:
+          - text: "Lecture"
+            href: part-07/lecture-scientific.qmd
+          - text: "Tutorial"
+            href: part-07/tutorial-scientific.qmd
+      - section: "10 Projects"
+        contents:
+          - text: "Lecture"
+            href: part-10/lecture-projects.qmd
+      - text: "***"
+      - section: "Assignments"
+        contents:
+          - text: "01 Assignment"
+            href: assignments/assignment-1.qmd
+          - text: "02 Assignment"
+            href: assignments/assignment-2.qmd
+      - text: "FAQs"
+        href: general/faq.qmd
+      - text: "Literature"
+        href: general/literature.qmd
+  page-footer: 
+    center: "Programming with Python, Tobias Vlćek</br>CC BY-NC-SA 4.0" 
+    right: 
+      - icon: github
+        href: https://github.com/beyondsimulations/Introduction-to-Python
+      - icon: linkedin
+        href: https://linkedin.com/in/tobiasvlcek
+
+format:
+  html:
+    theme: litera
+    css: styles.css
+    toc: true
+  pdf:
+    include-in-header: 
+      text: |
+        \usepackage{fvextra}
+        \DefineVerbatimEnvironment{Highlighting}{Verbatim}{breaklines,commandchars=\\\{\}}
+
+execute:
+  cache: true
+
+

README.md

@@ -0,0 +1,59 @@
+---
+title: "Assignment I"
+subtitle: "Programming with Python"
+
+format:
+    html:
+        theme: litera
+        highlight-style: arrow
+        code-overflow: wrap
+        linkcolor: "#a60000"
+        code-copy: true
+        code-link: true
+        toc: true
+        toc-location: right
+    pdf: 
+        documentclass: report
+        geometry:
+            - margin=1in
+        fontfamily: roboto
+        fontfamilyoptions: sfdefault
+        colorlinks: true
+---
+
+# Introduction
+This is the first of the two assignments for this course. It will be graded as pass/fail and you and your group of up to 3 students will need to submit it before the start of the last lecture. Please hand in one assignment per group via the e-mail address [[email protected]](mailto:[email protected]).
+
+In the assignment, you will practice the concepts you learned in the first part of the course. You will find a lot of information online and you are welcome to use generative AI to help you with the assignment. However, you are not allowed to copy the code from other groups and you have to indicate where and how you used AI to help you. Try to use comments to structure and to explain your code. Furthermore, use descriptive variable names and format your code nicely in order to make it more readable.
+
+# Tax refund for donations
+In this excercise, you will create a program that is able to calculate the amount of tax a person can get back for a donation. First, research the rules for tax refunds for donations in Germany. Then, create a program that is able to **calculate the amount of tax a person can get back** for a donation. The program should ask the user for the **amount of the donation and the yearly income** and then calculate the amount of tax the user can get back. The program should then print the amount of tax to the console. Note, that the program should also handle wrong inputs from the user, e.g. if the user enters a negative donation amount or a non-numeric income.
+
+```{python}
+# Tax refund for donations
+# TODO: Create a program that is able to calculate the amount of tax a person can get back for a donation.
+# Your code here
+```
+
+:::{.callout-tip}
+Use the `input()` function to get user input in order to let the user interact with your program.
+:::
+
+# Text based adventure game
+In this excercise, you will create a text based adventure game. You are completely free in the choice of the story, but it must **at least include 3 choices, 2 different endings and the choice to restart the game**. Try to use the concepts of conditionals, loops, and functions to create a game that is both fun and interactive for the user. Note, that the program should also handle wrong inputs from the user, e.g. if the user enters a choice that is not available.
+
+```{python}
+# Test based adventure game
+# TODO: Create a text based adventure game with at least 3 choices, 2 different endings and the choice to restart the game.
+# Your code here
+```
+
+# Hangman
+In this excercise, you will create a program that is able to play the game Hangman. The program should ask the **game master for a secret word**. Afterward, it should ask the player to guess a letter and then check if the letter is in the word. The program should then print the word with the guessed letters and the number of tries left. The program should also handle wrong inputs from the user, e.g. if the user enters a non-letter or a letter that is already guessed.
+
+```{python}
+# Hangman
+# TODO: Create a program that is able to play the game Hangman with a game master and one player.
+# Your code here
+```          
+

_quarto.yml

@@ -0,0 +1,62 @@
+---
+title: "Assignment II"
+subtitle: "Programming with Python"
+
+format:
+    html:
+        theme: litera
+        highlight-style: arrow
+        linkcolor: "#a60000"
+        code-copy: true
+        code-link: true
+        toc: true
+        toc-location: right
+        code-overflow: wrap
+    pdf: 
+        documentclass: report
+        geometry:
+            - margin=1in
+        fontfamily: roboto
+        fontfamilyoptions: sfdefault
+        colorlinks: true
+---
+
+# Introduction
+This is the second of the two assignments for this course. It will be graded as pass/fail and you and your group of up to 3 students will need to submit it before the start of the last lecture. Please hand in one assignment per group via the e-mail address [[email protected]](mailto:[email protected]).
+
+In the assignment, you will practice the concepts you learned in the second part of the course. You will find a lot of information online and you are welcome to use generative AI to help you with the assignment. However, you are not allowed to copy the code from other groups and you have to indicate where and how you used AI to help you. Try to use comments to structure and to explain your code. Furthermore, use descriptive variable names and format your code nicely in order to make it more readable.
+
+# Redact secret information
+In this excercise, you will create a program that is able to redact secret information in a text. The program should be able to redact the following: **zip codes, names, email addresses and phone numbers.** The program should ask the user **for a filename** and then read the file and **redact the secret information**. The program should then print the redacted text to the console and write it to a new file called `redacted.txt`. You can find a file with secret information in the git repository under `assignments/secret-text.txt`.
+
+```{python}
+# Secret information redactor
+# TODO: Create a program that is able to redact secret information in a text.
+# Your code here
+```    
+   
+# Dice roll simulator
+In this excercise, you will create a program that is able to simulate dice rolls and visualizes their distribution. The program should ask the user for **the number of sides on the dice and the number of dices to roll**. Then, the program should simulate the dice rolls 10000 times and **visualize the distribution** of the dice rolls using a histogram.    
+
+```{python}
+# Dice roll simulator
+# TODO: Create a program that is able to simulate a dice roll.
+# Your code here
+```
+
+# Regression analysis
+In this excercise, you will create a program that performs linear regression on a dataset with housing prices. The  dataset can be found in the git repository under `assignments/hamburg_housing_prices.csv`. The dataset contains the following columns:
+
+- Price: The price of the house in Euros.
+- Area: The area of the house in square meters.
+- Rooms: The number of rooms in the house.
+- Year_Built: The year the house was built.
+- Distance_to_Center: The distance to the center of Hamburg in kilometers.  
+
+Your task is to perform a **linear regression analysis** on the dataset and to predict the price of a house based on its area, number of rooms, year it was built and its distance to the center of Hamburg. You can use the `pandas` library to read the dataset and the `numpy` library to perform the linear regression analysis. After performing the linear regression analysis, use the `matplotlib` library to visualize the relationship between the price and the other features as well as the predicted prices for a given set of features.
+
+```{python}
+# Regression analysis
+# TODO: Create a program that performs linear regression analysis on the dataset.
+# Your code here
+```

assignments/assignment-1.qmd

@@ -0,0 +1,43 @@
+import pandas as pd
+import numpy as np
+from datetime import datetime, timedelta
+
+# Set random seed for reproducibility
+np.random.seed(42)
+
+# Generate data
+n_samples = 1000
+data = {
+    'Price': np.random.lognormal(mean=12.5, sigma=0.4, size=n_samples) * 1000,  # Price in Euros
+    'Area': np.random.lognormal(mean=4.5, sigma=0.3, size=n_samples),
+    'Rooms': np.random.randint(1, 6, n_samples),
+    'Year_Built': np.random.randint(1900, 2023, n_samples),
+    'Distance_to_Center': np.random.lognormal(mean=1.5, sigma=0.5, size=n_samples)
+}
+
+# Create DataFrame
+df = pd.DataFrame(data)
+
+# Adjust prices based on factors
+df['Price'] *= np.sqrt(df['Area']) / 10
+df['Price'] *= (df['Rooms'] ** 0.2)
+df['Price'] *= (1 - (2023 - df['Year_Built']) * 0.005)  # Slight decrease for older buildings
+df['Price'] *= (1 - df['Distance_to_Center'] * 0.015)  # Slight decrease for properties farther from center
+df['Price'] /= 300
+
+# Round and adjust data types
+df['Price'] = df['Price'].round(-3)  # Round to nearest thousand
+df['Area'] = df['Area'].round().astype(int)
+df['Distance_to_Center'] = df['Distance_to_Center'].round(1)
+
+# Add some missing values
+df.loc[np.random.choice(df.index, 50), 'Year_Built'] = np.nan
+df.loc[np.random.choice(df.index, 50), 'Distance_to_Center'] = np.nan
+
+# Save to CSV
+df.to_csv('assignments/hamburg_housing_prices.csv', index=False)
+print("Dataset created and saved as 'hamburg_housing_prices.csv'")
+
+# Display first few rows and data info
+print(df.head())
+print(df.info())