initialer commit

This commit is contained in:
wittmannzl103469 committed 2026-10-28 20:36:22 +01:00
1 parent e926d75119
commit 74776ef485
23 files changed
+445 -199

No files matched your search

@@ -0,0 +1,5 @@
# Regeln für dieses Projekt
- Code nach PEP 8, Zeilenlänge maximal 88 Zeichen.
- Jede Funktion und Methode hat einen Docstring und Type Hints.
- Vor jedem Commit: `ruff check` und `ruff format`.
@@ -0,0 +1,47 @@
"""Animation: Die Raumkapsel Apollo kreist um den Mond."""
import pygame
from compute import rot_2D
from moon import Moon
APOLLO_RADIUS = 5
APOLLO_DISTANCE = 25
RED = (255, 0, 0)
class Apollo(Moon):
"""Apollo kreist doppelt so schnell und entgegengesetzt um den Mond."""
def __init__(
self,
title: str = "Apollo",
fps: int = 60,
size: tuple[int, int] = (640, 400),
) -> None:
"""Legt Startposition und Rotationsmatrix von Apollo fest."""
super().__init__(title, fps, size)
self.position_apollo: tuple[float, float] = (APOLLO_DISTANCE, 0)
self.rot_apollo: list[list[float]] = rot_2D(-2 * self.theta)
def update_game(self) -> bool:
"""Dreht Mond und Apollo ein Stück weiter."""
super().update_game()
self.position_apollo = self.rotate(self.position_apollo, self.rot_apollo)
return True
def draw_bodies(self) -> None:
"""Zeichnet Erde, Mond und Apollo."""
super().draw_bodies()
absolute_apollo = (
self.position_moon[0] + self.position_apollo[0],
self.position_moon[1] + self.position_apollo[1],
)
pygame.draw.circle(
self.screen, RED, self.to_screen(absolute_apollo), APOLLO_RADIUS
)
if __name__ == "__main__":
apollo = Apollo()
apollo.run()
@@ -0,0 +1,99 @@
"""Funktionen zur linearen Algebra auf Matrizen als verschachtelte Listen."""
import math
def matmul(
matrix_a: list[list[float]], matrix_b: list[list[float]]
) -> list[list[float]]:
"""
Multipliziert zwei Matrizen miteinander (A * B).
:param matrix_a: Linke Matrix mit m Zeilen und n Spalten
:param matrix_b: Rechte Matrix mit n Zeilen und p Spalten
:return: Ergebnismatrix mit m Zeilen und p Spalten
:raises ValueError: Wenn die Spaltenzahl von A nicht der Zeilenzahl von B entspricht
"""
if len(matrix_a[0]) != len(matrix_b):
raise ValueError("Spaltenzahl von A muss der Zeilenzahl von B entsprechen.")
result = []
for row in matrix_a:
new_row = []
for col_index in range(len(matrix_b[0])):
value = 0
for k in range(len(row)):
value += row[k] * matrix_b[k][col_index]
new_row.append(value)
result.append(new_row)
return result
def transpose(matrix: list[list[float]]) -> list[list[float]]:
"""
Transponiert eine Matrix: Zeilen werden zu Spalten und Spalten zu Zeilen.
:param matrix: Matrix mit m Zeilen und n Spalten
:return: Transponierte Matrix mit n Zeilen und m Spalten
:raises ValueError: Bei leerer Matrix oder unterschiedlich langen Zeilen
"""
if not matrix or not matrix[0]:
raise ValueError("Die Matrix darf nicht leer sein.")
column_count = len(matrix[0])
for row in matrix:
if len(row) != column_count:
raise ValueError("Alle Zeilen müssen gleich viele Spalten haben.")
result = []
for col_index in range(column_count):
new_row = []
for row in matrix:
new_row.append(row[col_index])
result.append(new_row)
return result
def rot_2D(angle: float) -> list[list[float]]:
"""
Liefert die 2D-Rotationsmatrix für eine Drehung um den Ursprung.
:param angle: Drehwinkel im Bogenmaß (gegen den Uhrzeigersinn)
:return: 2x2-Rotationsmatrix [[cos, -sin], [sin, cos]]
"""
return [
[math.cos(angle), -math.sin(angle)],
[math.sin(angle), math.cos(angle)],
]
if __name__ == "__main__":
# Test matmul (Beispiel aus dem Skript)
matrix_a = [[3, 4, -1, 4], [-2, 2, 5, 1]]
matrix_b = [[1, 3, -2], [2, 5, 1], [-1, 4, -4], [2, 3, 6]]
matrix_c = matmul(matrix_a, matrix_b)
print("Ergebnis C = A * B:")
for row in matrix_c:
print(row)
# Zweites Beispiel matmul: Einheitsmatrix ändert nichts
identity = [[1, 0], [0, 1]]
print("\nEinheitsmatrix * [[5, 6], [7, 8]]:")
print(matmul(identity, [[5, 6], [7, 8]])) # Erwartet: [[5, 6], [7, 8]]
# Fehlerfall matmul: Dimensionen passen nicht
try:
matmul([[1, 2]], [[1, 2]])
except ValueError as error:
print("ValueError wie erwartet:", error)
# Test transpose
matrix = [[1, 2, 3], [4, 5, 6]]
print("\nTransponiert:")
print(transpose(matrix)) # Erwartet: [[1, 4], [2, 5], [3, 6]]
# Test rot_2D: Punkt (1, 0) um 90 Grad drehen -> erwartet (0, 1)
point = transpose([[1, 0]]) # [x, y] wird zur Spalte [[x], [y]]
rotated = matmul(rot_2D(math.pi / 2), point)
print("\nPunkt (1, 0) um 90 Grad gedreht:")
print(round(rotated[0][0], 10), round(rotated[1][0], 10)) # Erwartet: 0.0 1.0
@@ -0,0 +1,98 @@
"""Basisklasse ``Game`` für einfache pygame-Anwendungen."""
import pygame
class Game:
"""Basisklasse für pygame-Spiele.
Unterklassen passen das Verhalten durch Überschreiben von
:meth:`handle_event`, :meth:`update_game` und :meth:`draw_game` an.
"""
def __init__(
self,
title: str,
fps: int = 60,
size: tuple[int, int] = (640, 400),
) -> None:
"""Legt Fenstertitel, Bildrate und Fenstergröße fest.
Args:
title: Titel des Fensters.
fps: Maximale Bilder pro Sekunde.
size: Fenstergröße als (Breite, Höhe) in Pixeln.
"""
self.title: str = title
self.fps: int = fps
self.size: tuple[int, int] = size
self.clock: pygame.time.Clock = pygame.time.Clock()
self.dt: float = 0
self.screen: pygame.Surface | None = None
def init_game(self) -> None:
"""Initialisiert pygame und erzeugt das Fenster."""
pygame.init()
pygame.display.set_caption(self.title)
self.screen = pygame.display.set_mode(self.size)
def game_loop(self) -> None:
"""Führt die Hauptschleife aus, bis Events oder Update ``False`` liefern."""
while True:
# Berechnung der Zeitdifferenz seit dem letzten Frame
self.dt = self.clock.tick(self.fps) / 1000
if self.event_handling() == False:
break
if self.update_game() == False:
break
self.draw_game()
def exit_game(self) -> None:
"""Beendet pygame."""
pygame.quit()
def event_handling(self) -> bool:
"""Verteilt alle anstehenden Events an :meth:`handle_event`.
Bleibt in der Unterklasse unverändert.
Returns:
``False``, sobald ein Event das Spiel beenden soll, sonst ``True``.
"""
for event in pygame.event.get():
if not self.handle_event(event):
return False
return True
def handle_event(self, event: pygame.event.Event) -> bool:
"""Verarbeitet ein einzelnes Event.
Wird in der Unterklasse überschrieben.
Args:
event: Das zu verarbeitende pygame-Event.
Returns:
``False`` bei ``pygame.QUIT``, sonst ``True``.
"""
if event.type == pygame.QUIT:
return False
return True
def update_game(self) -> bool:
"""Aktualisiert den Spielzustand um einen Frame.
Returns:
``False``, wenn das Spiel beendet werden soll, sonst ``True``.
"""
return True
def draw_game(self) -> None:
"""Zeichnet den aktuellen Frame und bringt ihn zur Anzeige."""
pygame.display.flip()
def run(self) -> None:
"""Startet das Spiel: Initialisierung, Hauptschleife, Beenden."""
self.init_game()
self.game_loop()
self.exit_game()
@@ -0,0 +1,3 @@
.venv/
__pycache__/
.env
@@ -0,0 +1,76 @@
"""Animation: Der Mond kreist um die Erde."""
import pygame
from compute import matmul, rot_2D, transpose
from game import Game
EARTH_RADIUS = 30
MOON_RADIUS = 10
MOON_DISTANCE = 150
BLACK = (0, 0, 0)
WHITE = (255, 255, 255)
BLUE = (0, 0, 255)
class Moon(Game):
"""Der Mond kreist um die Erde."""
def __init__(
self,
title: str = "Moon",
fps: int = 60,
size: tuple[int, int] = (640, 400),
) -> None:
"""Legt Startposition, Drehwinkel und Rotationsmatrix fest."""
super().__init__(title, fps, size)
self.center: tuple[float, float] = (size[0] / 2, size[1] / 2)
self.position_moon: tuple[float, float] = (MOON_DISTANCE, 0)
self.theta: float = 0.01
self.rot_moon: list[list[float]] = rot_2D(self.theta)
def update_game(self) -> bool:
"""Dreht den Mond ein Stück weiter."""
self.position_moon = self.rotate(self.position_moon, self.rot_moon)
return True
def draw_game(self) -> None:
"""Löscht den Bildschirm, zeichnet alle Körper und zeigt das Bild an."""
self.screen.fill(BLACK)
self.draw_bodies()
pygame.display.flip()
def draw_bodies(self) -> None:
"""Zeichnet Erde und Mond."""
pygame.draw.circle(self.screen, BLUE, self.to_screen((0, 0)), EARTH_RADIUS)
pygame.draw.circle(
self.screen, WHITE, self.to_screen(self.position_moon), MOON_RADIUS
)
def rotate(
self, position: tuple[float, float], rotation: list[list[float]]
) -> tuple[float, float]:
"""
Dreht einen Punkt mit einer Rotationsmatrix um den Ursprung.
:param position: Punkt (x, y) relativ zum Drehzentrum
:param rotation: 2x2-Rotationsmatrix
:return: Gedrehter Punkt (x', y')
"""
point = transpose([list(position)])
result = matmul(rotation, point)
return (result[0][0], result[1][0])
def to_screen(self, position: tuple[float, float]) -> tuple[float, float]:
"""
Rechnet eine Position relativ zur Erde in Fensterkoordinaten um.
:param position: Punkt (x, y) relativ zur Erde
:return: Punkt in Fensterkoordinaten
"""
return (self.center[0] + position[0], self.center[1] + position[1])
if __name__ == "__main__":
moon = Moon()
moon.run()
@@ -0,0 +1,4 @@
[project]
name = "matrixmania"
version = "0.1.0"
dependencies = ["tabulate", "ruff"]